Source: https://ailoot.ai/models/el/google-gemini-3-pro-image-preview/ Canonical: https://ailoot.ai/models/el/google-gemini-3-pro-image-preview/ Language: el # Google: Nano Banana Pro (Gemini 3 Pro Image Preview) [Markdown](https://ailoot.ai/models/el/google-gemini-3-pro-image-preview/index.md) · [JSON](https://ailoot.ai/models/el/google-gemini-3-pro-image-preview/facts.json) ## [Google: Nano Banana Pro (Gemini 3 Pro Image Preview)](https://ailoot.ai/models/el/google-gemini-3-pro-image-preview/) Το Nano Banana Pro είναι το μοντέλο Gemini 3 Pro Image Preview της Google για παραγωγή και επεξεργασία εικόνας. Υποστηρίζει σύνθεση πολλών εικόνων, ενσωματωμένο κείμενο, τοπικές δημιουργικές αλλαγές, τεκμηρίωση μέσω Search και έξοδο 2K ή 4K στο τεκμηριωμένο προφίλ. - [**Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `google/gemini-3-pro-image-preview`](https://ailoot.ai/models/el/google-gemini-3-pro-image-preview/#method-0) - [**Ailoot Ultra · Εικόνες** `POST /v1/images/generations` `google/gemini-3-pro-image-preview`](https://ailoot.ai/models/el/google-gemini-3-pro-image-preview/#method-1) - [**Ailoot Ultra · Anthropic Messages** `POST /v1/messages` `google/gemini-3-pro-image-preview`](https://ailoot.ai/models/el/google-gemini-3-pro-image-preview/#method-2) Σχετικά με το μοντέλο Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο. Το Nano Banana Pro είναι το μοντέλο παραγωγής και επεξεργασίας εικόνας της Google που βασίζεται στο Gemini 3 Pro. Δέχεται κείμενο και εικόνες και επιστρέφει εικόνες ή κείμενο. Το δημοσιευμένο προφίλ του καλύπτει πληροφοριογραφήματα, διαγράμματα, οπτικό υλικό προϊόντων, εικονογραφημένα σενάρια και συνθέσεις που συνδυάζουν πολλά στοιχεία ή αναφορές. #### Συνθέστε την εικόνα και το ορατό της περιεχόμενο Ονομάστε σκοπό, κύριο θέμα και σχέση μεταξύ στοιχείων. Για πληροφοριογράφημα, δώστε τα πραγματικά μεγέθη και τις ακριβείς ετικέτες και έπειτα περιγράψτε την ιεραρχία τους. Για σκηνή προϊόντος, προσδιορίστε αντικείμενο, οπτική γωνία, περιβάλλον και λεπτομέρειες που πρέπει να παραμείνουν αναγνωρίσιμες. Ο τεκμηριωμένος ρόλος απόδοσης κειμένου του μοντέλου περιλαμβάνει εκτενέστερη διατύπωση και πολύγλωσσες διατάξεις· ελέγξτε τα επιστρεφόμενα γράμματα, αριθμούς και ευθυγράμμιση στην εικόνα. Η τεκμηρίωση μέσω αναζήτησης προβλέπεται για ενσωμάτωση επίκαιρων πληροφοριών σε οπτική εργασία. Όπου τη διαθέτει η διεπαφή, κρατήστε τα στοιχεία πηγής μαζί με την περιγραφή και επιθεωρήστε πώς εμφανίζονται στο τελικό γραφικό. Ένα οπτικά πειστικό γράφημα ή διάγραμμα πρέπει ακόμη να συγκρίνεται με τα δεδομένα και τις ετικέτες που προοριζόταν να αναπαραστήσει. #### Αναφορές και δημιουργικές επεξεργασίες Το δημοσιευμένο προφίλ φιλοξενίας δέχεται έως δεκατέσσερις εικόνες αναφοράς. Αναθέστε ρόλο σε καθεμιά, όπως θέμα, περιβάλλον ή οπτικό ύφος, αντί να αφήνετε ανεξήγητη τη σχέση τους. Η περιγραφή μοντέλου τονίζει διατήρηση ταυτότητας έως πέντε θεμάτων· συγκρίνετε τα πραγματικά θέματα και τις σημαντικές λεπτομέρειες σε όλη την επιστρεφόμενη σύνθεση. Για επεξεργασία, ονομάστε την περιοχή ή το αντικείμενο προς αλλαγή και τα στοιχεία προς διατήρηση. Οι τεκμηριωμένοι δημιουργικοί έλεγχοι περιλαμβάνουν τοπικές αλλαγές, προσαρμογές φωτισμού και εστίασης, μετασχηματισμούς κάμερας και ευέλικτες αναλογίες. Κρατήστε διαθέσιμη την εικόνα πηγής όταν ελέγχετε τη ζητούμενη επεξεργασία και τις λεπτομέρειες που πρέπει να παραμένουν αναγνωρίσιμες. #### Ανάλυση και αξιοποιήσιμο παραδοτέο Το προφίλ τεκμηριώνει έξοδο 2K και 4K. Επιλέξτε οπτική αναλογία και κλίμακα εξόδου για την επιδιωκόμενη τοποθέτηση και έπειτα επιθεωρήστε τις πραγματικές επιστρεφόμενες διαστάσεις και ιδιότητες αρχείου. Μια σχεδιαστική ιδέα και μια απαίτηση εξαγωγής πρέπει να παραμένουν συνδεδεμένες όταν η εικόνα εισέρχεται σε μεγαλύτερη διάταξη. Διατηρήστε την επιλεγμένη εικόνα μαζί με την περιγραφή της, τους ρόλους αναφορών και το ιστορικό αναθεωρήσεων. Ελέγξτε ακριβή διατύπωση, συνέχεια θέματος και ιεραρχία πληροφοριών στο μέγεθος όπου θα χρησιμοποιηθεί το στοιχείο. Χρήσιμο παραδοτέο είναι το επιθεωρημένο οπτικό στοιχείο ή συνοδευτικό κείμενο από αυτό το προφίλ μοντέλου, έτοιμο για επόμενη σχεδιαστική εργασία ή παραγωγή. Πρακτική εργασία ### Πρακτική εργασία Τεχνικό παράδειγμα στα αγγλικά ``` Create a stock comparison infographic Create a clean landscape infographic for a warehouse noticeboard. Title: "Weekly stock". Show exactly three labelled bars: "Boxes 24", "Bags 12", "Tubes 6". Use a white background, dark text and one blue accent. Keep labels large, align the bars to a common baseline and add no extra numbers or logos. ``` #### Αναμενόμενο αποτέλεσμα ``` One infographic image with the exact title and three proportional, labelled bars on a common baseline. ``` #### Έλεγχος αποτελέσματος ``` Inspect all lettering and confirm the bar values and relative lengths match 24, 12 and 6. ``` **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `google/gemini-3-pro-image-preview` [`google/gemini-3-pro-image-preview`](https://ailoot.ai/models/el/#m=google%2Fgemini-3-pro-image-preview&route=Ultra&caller=google%2Fgemini-3-pro-image-preview&fmt=chat) Google /`google/gemini-3-pro-image-preview` ### Εισαγωγή Το Nano Banana Pro είναι το μοντέλο Gemini 3 Pro Image Preview της Google για παραγωγή και επεξεργασία εικόνας. Υποστηρίζει σύνθεση πολλών εικόνων, ενσωματωμένο κείμενο, τοπικές δημιουργικές αλλαγές, τεκμηρίωση μέσω Search και έξοδο 2K ή 4K στο τεκμηριωμένο προφίλ. Αποδεκτές είσοδοι Κείμενο Αποτελέσματα Κείμενο ### Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` Είσοδος `text` Έξοδος `text` Μορφή εξόδου json ή SSE | Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή | | --- | --- | --- | --- | --- | | Πεδίο`model` | Τύπος`string` | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια google/gemini-3-pro-image-preview | Προεπιλογή— | | Πεδίο`messages` | Τύπος`message[]` | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Ελάχιστο πλήθος στοιχείων: 1 | Προεπιλογή— | | Πεδίο`messages[].role` | Τύπος`string` | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Παραδείγματα: system, user, assistant, tool, function Συνθήκες: Αυτοί οι ρόλοι αναπαρίστανται ρητά από τους τύπους συμβατότητας του πηγαίου κώδικα· το ακριβές σύνολο ρόλων παραμένει ειδικό για κάθε μοντέλο. Εξαρτάται από το μοντέλο | Προεπιλογή— | | Πεδίο`messages[].content` | Τύπος`string\|content_part[]\|null` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— | | Πεδίο`messages[].tool_calls` | Τύπος`tool_call[]` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— | | Πεδίο`messages[].tool_call_id` | Τύπος`string` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εφαρμόζεται όταν: role=tool· χρησιμοποιήστε το πραγματικό ID που επιστράφηκε | Προεπιλογή— | | Πεδίο`messages[].name` | Τύπος`string` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— | | Πεδίο`messages[].reasoning_content` | Τύπος`string` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εφαρμόζεται όταν: Επαναποστείλετε το πραγματικό περιεχόμενο συλλογιστικής που επιστράφηκε, όταν το μοντέλο το χρησιμοποιεί | Προεπιλογή— | | Πεδίο`messages[].reasoning_details` | Τύπος`object\|array` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— | | Πεδίο`max_tokens` | Τύπος`integer` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: 1 Εξαρτάται από το μοντέλο | Προεπιλογή— | | Πεδίο`max_completion_tokens` | Τύπος`integer` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: 1 Εξαρτάται από το μοντέλο | Προεπιλογή— | | Πεδίο`stream` | Τύπος`boolean` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογήfalse | | Πεδίο`stream_options.include_usage` | Τύπος`boolean` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— | | Πεδίο`temperature` | Τύπος`number` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— | | Πεδίο`top_p` | Τύπος`number` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— | | Πεδίο`stop` | Τύπος`string\|string[]` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— | | Πεδίο`tools` | Τύπος`function_tool[]` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— | | Πεδίο`tools[].type` | Τύπος`string` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια function Εξαρτάται από το μοντέλο | Προεπιλογή— | | Πεδίο`tools[].function.name` | Τύπος`string` | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Εφαρμόζεται όταν: Παρεχόμενο εργαλείο τύπου συνάρτησης | Προεπιλογή— | | Πεδίο`tools[].function.description` | Τύπος`string` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— | | Πεδίο`tools[].function.parameters` | Τύπος`JSON_schema` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— | | Πεδίο`tool_choice` | Τύπος`string\|object` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— | | Πεδίο`parallel_tool_calls` | Τύπος`boolean` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— | | Πεδίο`response_format` | Τύπος`object` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— | | Πεδίο`reasoning_effort` | Τύπος`string` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— | | Πεδίο`reasoning` | Τύπος`object` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— | | Πεδίο`service_tier` | Τύπος`string` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— | | Πεδίο`instructions` | Τύπος`string` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Πεδίο συμβατότητας | Προεπιλογή— | | Πεδίο`functions` | Τύπος`function[]` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— | | Πεδίο`function_call` | Τύπος`string\|object` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— | | Πεδίο`prompt_cache_options` | Τύπος`object` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— | | Πεδίο`modalities` | Τύπος`string[]` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια text | Προεπιλογή— | | Πεδίο`provider` | Τύπος`object` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Συνθήκες: Το provider.options απορρίπτεται σε αυτή τη διαδρομή κειμένου Ultra | Προεπιλογή— | | Πεδίο`cache_control.ttl` | Τύπος`string` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Συνθήκες: Το 1h απορρίπτεται στα πραγματικά πεδία κρυφής μνήμης προτροπών | Προεπιλογή— | Συνδυασμοί υλικών εισόδου **Κείμενο** · Κείμενο UTF8 `messages[].content` Παράμετροι και κύκλος ζωής μεθόδου | Παράμετρος | Σύμβαση | | --- | --- | | Παράμετρος`content_type` | Σύμβασηapplication/json | | Παράμετρος`required` | Σύμβασηmodel, messages | | Παράμετρος`material_types` | Σύμβασηtext | | Παράμετρος`messages` | ΣύμβασηΠίνακας μηνυμάτων με δομή role/content | | Παράμετρος`file_material` | Σύμβασηπραγματικό έγγραφο UTF-8 που εισάγεται ως αυτούσιο κείμενο· δεν συνάγεται ID αρχείου | | Παράμετρος`optional_controls` | Σύμβασηstream, temperature, top\_p, stop, max\_tokens, max\_completion\_tokens, reasoning, response\_format, tools, tool\_choice | | Παράμετρος`control_scope` | Σύμβασηεξαρτάται από το μοντέλο· τα εργαλεία συναρτήσεων του χρήστη διαφέρουν από τα φιλοξενούμενα εργαλεία | | Παράμετρος`output_modalities` | Σύμβασηtext | | Παράμετρος`hosted_operations` | Σύμβασηfalse | | Παράμετρος`multimodal_input_binding` | Σύμβασηnull | Κύκλος ζωής: `synchronous_or_streamed` Στείλτε το ακριβές ID μοντέλου μαζί με το messages. Το μήκος συμφραζομένων δεν είναι ανώτατο όριο εξόδου. Ένα αρχείο κειμένου μπορεί να παρέχει αυτούσιο κείμενο· οι είσοδοι εικόνας/ήχου/αντικειμένων αρχείων χρειάζονται ακριβή αντιστοίχιση. ### Τιμολόγηση Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο. Γρήγορη λειτουργία Τυπική χρέωση Όταν επιλέγεται η γρήγορη λειτουργία Λειτουργία flex Τυπική χρέωση Όταν επιλέγεται η λειτουργία flex Μέγιστη προσπάθεια συλλογισμού Τυπική χρέωση Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default Τιμολόγηση ρητής αποθήκευσης στην κρυφή μνήμη Δεν είναι ενεργοποιημένο Όταν ζητείται ρητή αποθήκευση στην κρυφή μνήμη #### Χρεώσεις Ailoot #### Τιμές ανά διαμόρφωση Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων. | Διαμόρφωση | Πίνακας χρεώσεων | Token συμφραζομένων, πάνω από | Token συμφραζομένων, έως και | Χρέωση | | --- | --- | --- | --- | --- | | ΔιαμόρφωσηΒασικές χρεώσεις ανά token | Πίνακας χρεώσεωνΒασική χρέωση | Token συμφραζομένων, πάνω από— | Token συμφραζομένων, έως καιΧωρίς ανώτατο όριο | Χρέωση Είσοδος · Token εισόδου **$0.004** / 1K token Έξοδος · Token εξόδου **$0.024** / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη **$0.0004** / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη **$0.00075** / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα **—** / 1K token Έξοδος · Token εξόδου εικόνας **$0.24** / 1K token εικόνας | | ΔιαμόρφωσηΕπίπεδο 1 βάσει μήκους αιτήματος | Πίνακας χρεώσεων— | Token συμφραζομένων, πάνω από0 | Token συμφραζομένων, έως καιΧωρίς ανώτατο όριο | Χρέωση Είσοδος · Token εισόδου **$0.004** / 1K token Έξοδος · Token εξόδου **$0.024** / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη **$0.0004** / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη **$0.00075** / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα **—** / 1K token | #### Στοιχεία τιμοκαταλόγου αναφοράς Οι πίνακες αναφοράς του μοντέλου δεν αλλάζουν την επιλογή μεθόδου, τις εκτιμήσεις τιμής ή τις χρεώσεις. Οι εφαρμοζόμενες χρεώσεις χρησιμοποιούν τις τιμές της επιλεγμένης μεθόδου Ailoot. google/gemini-3-pro-image-preview #### Τιμές ανά διαμόρφωση | Διαμόρφωση | Συνθήκες χρέωσης | Χρέωση | | --- | --- | --- | | Διαμόρφωσηgoogle/gemini-3-pro-image-preview · Προεπιλεγμένη διαμόρφωση | Συνθήκες χρέωσηςΠροεπιλεγμένη διαμόρφωση | Χρέωση Είσοδος · Είσοδος **0,004 $** / 1K token Έξοδος · Έξοδος **0,24 $** / 1K token | Google: Nano Banana Pro (Gemini 3 Pro Image Preview) #### Τιμές ανά διαμόρφωση | Διαμόρφωση | Συνθήκες χρέωσης | Χρέωση | | --- | --- | --- | | ΔιαμόρφωσηGoogle: Nano Banana Pro (Gemini 3 Pro Image Preview) · Προεπιλεγμένη διαμόρφωση | Συνθήκες χρέωσηςΠροεπιλεγμένη διαμόρφωση | Χρέωση Είσοδος · Token εισόδου **0,004 $** / 1K token Έξοδος · Token εξόδου **0,024 $** / 1K token Είσοδος · Εικόνα εισόδου **0,004 $** / 1K token Έξοδος · Εικόνα εξόδου **0,24 $** / 1K token Είσοδος · Είσοδος ήχου **0,004 $** / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη ήχου **0,0004 $** / 1K token Έξοδος · Αναζήτηση στον ιστό **0,028 $** ανά αναζήτηση Έξοδος · Token συλλογισμού **0,024 $** / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη **0,0004 $** / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη · 5 λεπτά **0,00075 $** / 1K token | Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. [Πώς λειτουργούν η δέσμευση και η εκκαθάριση →](https://ailoot.ai/docs/el/billing/reserve/) ### Παραδείγματα αιτημάτων #### Ailoot Ultra · OpenAI Chat curlPython SDKΡοή σε Python ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" python3 - <<'PY_REQUEST' import json,os from pathlib import Path p=json.loads('{"model": "google/gemini-3-pro-image-preview", "messages": [{"role": "user", "content": "Explain the difference between an observation and a hypothesis in three sentences."}]}') Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import json from pathlib import Path r=json.loads(Path("result.json").read_text()) for x in r.get("choices",[]): if x.get("message",{}).get("content"): print(x["message"]["content"]) PY_RESULT ``` ```python from openai import OpenAI import os if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request") client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0) result=client.chat.completions.create(model='google/gemini-3-pro-image-preview',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) import base64, json from pathlib import Path def save_result(data, stem="result"): # Keep every field, including usage, IDs, reasoning and tool requests. Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8") print(json.dumps(data, ensure_ascii=False, indent=2)) def save_blob(encoded, suffix, label): raw = base64.b64decode(encoded, altchars=b"-_", validate=True) ext = "png" if raw.startswith(b"\x89PNG\r\n\x1a\n") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix file = Path(stem + "-" + label + "." + ext) file.write_bytes(raw) print("Saved", file) for index, block in enumerate(data.get("content") or []): print("Content", index, json.dumps(block, ensure_ascii=False)) for choice in data.get("choices") or []: print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False)) for index, item in enumerate(data.get("output") or []): print("Output", index, json.dumps(item, ensure_ascii=False)) if item.get("type") == "image_generation_call" and item.get("result"): save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index)) for ci, candidate in enumerate(data.get("candidates") or []): for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []): print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False)) blob = part.get("inlineData") or part.get("inline_data") if blob and blob.get("data"): mime = blob.get("mimeType") or blob.get("mime_type") suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin") save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi)) save_result(result.to_dict(mode="json")) ``` ```python from openai import OpenAI import os from pathlib import Path if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request") client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0) import base64, json from pathlib import Path def save_result(data, stem="result"): # Keep every field, including usage, IDs, reasoning and tool requests. Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8") print(json.dumps(data, ensure_ascii=False, indent=2)) def save_blob(encoded, suffix, label): raw = base64.b64decode(encoded, altchars=b"-_", validate=True) ext = "png" if raw.startswith(b"\x89PNG\r\n\x1a\n") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix file = Path(stem + "-" + label + "." + ext) file.write_bytes(raw) print("Saved", file) for index, block in enumerate(data.get("content") or []): print("Content", index, json.dumps(block, ensure_ascii=False)) for choice in data.get("choices") or []: print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False)) for index, item in enumerate(data.get("output") or []): print("Output", index, json.dumps(item, ensure_ascii=False)) if item.get("type") == "image_generation_call" and item.get("result"): save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index)) for ci, candidate in enumerate(data.get("candidates") or []): for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []): print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False)) blob = part.get("inlineData") or part.get("inline_data") if blob and blob.get("data"): mime = blob.get("mimeType") or blob.get("mime_type") suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin") save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi)) with client.chat.completions.stream(model='google/gemini-3-pro-image-preview',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) as stream: with Path("stream-events.jsonl").open("w",encoding="utf-8") as log: for event in stream: payload=event.to_dict(mode="json") log.write(json.dumps(payload,ensure_ascii=False)+"\n"); log.flush() print(json.dumps(payload,ensure_ascii=False)) final=stream.get_final_completion() save_result(final.to_dict(mode="json"),"stream-result") ``` ### Λήψη και αποθήκευση αποτελεσμάτων #### Ailoot Ultra · OpenAI Chat json ή SSE ##### Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα Διατηρήστε κάθε πλήρη απάντηση, αρχείο και τμήμα περιεχομένου που επιστρέφεται. Διατηρήστε κάθε επιλογή και το περιεχόμενο/τις κλήσεις εργαλείων/το περιεχόμενο συλλογιστικής της. Στο SSE συνθέστε τις διαφορικές ενημερώσεις ανά δείκτη επιλογής/εργαλείου και κρατήστε την τελική αιτία τερματισμού και τα στοιχεία χρήσης. ##### Αν χρειάζεται έλεγχος της αρχικής απάντησης Διατηρήστε τα ID αιτήματος/απάντησης και τις κεφαλίδες. Δεν παρέχεται γενικό URL ανάκτησης εργασιών κειμένου. Πεδία απάντησης | Πεδίο | Τύπος | | --- | --- | | Πεδίο`choices[].index` | Τύποςinteger | | Πεδίο`choices[].message.content` | Τύποςstring\|null | | Πεδίο`choices[].message.tool_calls` | Τύποςtool\_call\[\] | | Πεδίο`choices[].message.reasoning_content` | Τύποςstring | | Πεδίο`choices[].message.reasoning_details` | Τύποςobject\|array | | Πεδίο`choices[].finish_reason` | Τύποςstring\|null | | Πεδίο`usage` | Τύποςobject | Σφάλματα και επόμενα βήματα | Απάντηση | Συνθήκη | Επόμενο βήμα | | --- | --- | --- | | Απάντηση400 · `invalid_request_error` | ΣυνθήκηΜη έγκυρα υποχρεωτικά πεδία, μη έγκυρη αναπαράσταση υλικού ή μη έγκυρη τιμή παραμέτρου | Επόμενο βήμαΔιορθώστε τα υποδεικνυόμενα πεδία πριν από νέο αίτημα δημιουργίας. | ### Εναλλακτικά ονόματα #### Εναλλακτικά ονόματα μοντέλου **Ailoot Ultra** [`google/gemini-3-pro-image-preview`](https://ailoot.ai/models/el/#m=google%2Fgemini-3-pro-image-preview&route=Ultra&caller=google%2Fgemini-3-pro-image-preview&fmt=chat) #### Εναλλακτικές διαδρομές μεθόδων `/v1/images` #### Σχετικά ID μοντέλων [`google/gemini-3-pro-image-preview`](https://ailoot.ai/models/el/#m=google%2Fgemini-3-pro-image-preview&route=Ultra&caller=google%2Fgemini-3-pro-image-preview&fmt=chat) **Ailoot Ultra · Εικόνες** `POST /v1/images/generations` `google/gemini-3-pro-image-preview` [`google/gemini-3-pro-image-preview`](https://ailoot.ai/models/el/#m=google%2Fgemini-3-pro-image-preview&route=Ultra&caller=google%2Fgemini-3-pro-image-preview&fmt=images) Google /`google/gemini-3-pro-image-preview` ### Εισαγωγή Το Nano Banana Pro είναι το μοντέλο Gemini 3 Pro Image Preview της Google για παραγωγή και επεξεργασία εικόνας. Υποστηρίζει σύνθεση πολλών εικόνων, ενσωματωμένο κείμενο, τοπικές δημιουργικές αλλαγές, τεκμηρίωση μέσω Search και έξοδο 2K ή 4K στο τεκμηριωμένο προφίλ. Αποδεκτές είσοδοι Κείμενο · Εικόνες Αποτελέσματα Εικόνες ### Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι **Ailoot Ultra · Εικόνες** `POST /v1/images/generations` Είσοδος `text`, `image` Έξοδος `image` | Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή | | --- | --- | --- | --- | --- | | Πεδίο`model` | Τύπος`string` | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια google/gemini-3-pro-image-preview | Προεπιλογή— | | Πεδίο`prompt` | Τύπος`string` | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Ελάχιστο μήκος: 1 | Προεπιλογή— | | Πεδίο`resolution` | Τύπος`string` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 1K, 2K, 4K | Προεπιλογή— | | Πεδίο`aspect_ratio` | Τύπος`string` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 | Προεπιλογή— | | Πεδίο`n` | Τύπος`integer` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: 1 Μέγιστο: 1 | Προεπιλογή— | | Πεδίο`input_references` | Τύπος`array` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο πλήθος στοιχείων: 0 Μέγιστο πλήθος στοιχείων: 14 | Προεπιλογή— | | Πεδίο`provider` | Τύπος`object` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— | Παράμετροι και κύκλος ζωής μεθόδου | Παράμετρος | Σύμβαση | | --- | --- | | Παράμετρος`content_type` | Σύμβασηapplication/json | | Παράμετρος`required` | Σύμβασηmodel, prompt | | Παράμετρος`material_types` | Σύμβασηtext, image | Κύκλος ζωής: `synchronous_result_then_owned_library` `GET /v1/media/tasks/{task_id}` · Το πραγματικό task\_id που επιστράφηκε ή μια εγγραφή στη βιβλιοθήκη πολυμέσων `GET /v1/media/assets/{asset_id}/content` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` ### Τιμολόγηση ##### Πώς υπολογίζεται η τελική χρέωση Οι εμφανιζόμενες τιμές χρησιμοποιούνται για την εκτίμηση του κόστους πριν από την παραγωγή. Η τελική χρέωση υπολογίζεται από το κόστος που καταγράφηκε για την αρχική παραγωγή. Η μετρημένη διάρκεια της εξόδου και οι προβλεπόμενες ποσότητες δεν αποτελούν την τελική χρεώσιμη ποσότητα. Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο. Γρήγορη λειτουργία Δεν έχει οριστεί Όταν επιλέγεται η γρήγορη λειτουργία Λειτουργία flex Δεν έχει οριστεί Όταν επιλέγεται η λειτουργία flex Μέγιστη προσπάθεια συλλογισμού Δεν έχει οριστεί Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default #### Εκτιμώμενες χρεώσεις για σύγκριση #### Τιμές ανά διαμόρφωση Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων. | Διαμόρφωση | Πίνακας χρεώσεων | Προβλεπόμενη ποσότητα | Χρέωση | | --- | --- | --- | --- | | ΔιαμόρφωσηΒασικές χρεώσεις token | Πίνακας χρεώσεωνΒασική χρέωση | Προβλεπόμενη ποσότητα— | Χρέωση Είσοδος · Token εισόδου · Εκτίμηση μόνο για σύγκριση **—** / 1K token Έξοδος · Token εξόδου · Εκτίμηση μόνο για σύγκριση **—** / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση **—** / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση **—** / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα · Εκτίμηση μόνο για σύγκριση **—** / 1K token | | ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίας | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία | Χρέωση Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση **$0.98304** εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή. | Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. [Πώς λειτουργούν η δέσμευση και η εκκαθάριση →](https://ailoot.ai/docs/el/billing/reserve/) ### Παραδείγματα αιτημάτων #### Ailoot Ultra · Εικόνες curl ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" export AILOOT_API_KEY python3 - <<'PY_REQUEST' import json,os from pathlib import Path p={'model': 'google/gemini-3-pro-image-preview', 'prompt': 'a red panda astronaut floating in space, studio lighting'} Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import base64, json, os, subprocess from pathlib import Path from urllib.parse import urlsplit, urljoin def save_images(items): if not items: raise SystemExit("No completed images; retain the full response") for index, item in enumerate(items): encoded=item.get("b64_json") uri=item.get("url", "") if not encoded and uri.startswith("data:image/"): header, separator, encoded=uri.partition(",") if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI") if encoded: raw=base64.b64decode(encoded,validate=True) elif uri: uri=urljoin("https://api.ailoot.ai",uri) parsed=urlsplit(uri) if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password: raise SystemExit("Invalid returned image URL") owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content") args=["curl","--fail-with-body","--silent","--show-error",uri] if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]] temporary=Path(f"image-{index}.bin") subprocess.run(args+["-o",str(temporary)],check=True) raw=temporary.read_bytes() temporary.unlink() else: raise SystemExit("Image has neither bytes nor URL") if not raw: raise SystemExit("Empty image result") ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"