Το Nano Banana Pro είναι το μοντέλο Gemini 3 Pro Image της Google για παραγωγή και επεξεργασία εικόνας καθοδηγούμενη από συλλογιστική. Ο κατασκευαστής θέτει σύνθετο γραφιστικό σχεδιασμό, μακέτες προϊόντων υψηλής πιστότητας και οπτικοποίηση πραγματολογικών δεδομένων στο επίκεντρο της προβλεπόμενης χρήσης του. Δέχεται κείμενο και εικόνες και παράγει εικόνα και κείμενο. Αυτή η ονομασμένη έκδοση εικόνας Pro βασίζεται στο Gemini 3 Pro, διατηρώντας το δικό της προφίλ εισόδου και δυνατοτήτων εργασιών εικόνας.
Το μοντέλο υποστηρίζει εικόνες 1K, 2K και 4K. Τα τεκμηριωμένα σχήματα περιλαμβάνουν 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 και 21:9. Μια τετράγωνη εικόνα 4K είναι 4096 × 4096· μια εικόνα 16:9 4K είναι 5504 × 3072. Επιλέξτε ανάλυση και αναλογία για το παραδοτέο που χρειάζεστε, είτε κατακόρυφη αφίσα, σκηνή προϊόντος ή πλατύ επεξηγηματικό γραφικό. Η επιλογή 0.5K και οι πρόσθετες ακραίες αναλογίες του Gemini 3.1 Flash Image δεν αποτελούν μέρος αυτού του πίνακα Pro.
Η απόδοση κειμένου υποστηρίζει καθαρή γραφή σε αφίσες, διαγράμματα και άλλα σχεδιασμένα στοιχεία. Για σύνθετο πληροφοριογράφημα, δώστε τα υποκείμενα στοιχεία, την ακριβή διατύπωση, ακολουθία ανάγνωσης και σχέση μεταξύ ετικετών και οπτικών στοιχείων. Διαχωρίστε τις πληροφορίες προς επικοινωνία από το επιθυμητό καλλιτεχνικό ύφος. Η Google συνιστά προετοιμασία κειμένου πρώτα και κατόπιν παραγωγή εικόνας που το περιέχει. Αυτό είναι ιδιαίτερα χρήσιμο όταν σύνθεση συνδυάζει τίτλο, διάγραμμα και πολλές σύντομες λεζάντες.
Η είσοδος πολλών εικόνων υποστηρίζει έως 14 αναφορές. Ο πίνακας δυνατοτήτων της Google περιγράφει έως έξι αναφορές αντικειμένων για πιστότητα, έως πέντε αναφορές χαρακτήρων για συνέπεια και έως τρεις αναφορές ύφους. Αυτοί οι ρόλοι βοηθούν στην προετοιμασία σύνθετου οπτικού στοιχείου: φωτογραφία προϊόντος ορίζει εμφάνιση, χωριστή εικόνα καθορίζει περιβάλλον και μια εικόνα ύφους καθοδηγεί την αισθητική απόδοση. Πείτε στο μοντέλο ποιες λεπτομέρειες είναι δεσμευτικές και ποιες αναφορές παρέχουν έμπνευση αντί να του ζητάτε αδιάκριτο συνδυασμό κάθε ορατού χαρακτηριστικού.
Η τεκμηρίωση μέσω Google Search μπορεί να παρέχει πληροφορίες πραγματικού κόσμου για πραγματολογική οπτικοποίηση ή σκηνή που λαμβάνει υπόψη τις τρέχουσες συνθήκες. Η ροή εικόνας Pro τεκμηριώνει τη χρήση πηγών του ιστού· η επέκταση Image Search τεκμηριώνεται ειδικά για Nano Banana 2.1 και Gemini 3.1 Flash Image. Για γραφικό δεδομένων, δώστε τις τιμές που σκοπεύετε να εμφανίσετε ή ζητήστε τεκμηριωμένες πληροφορίες στη ροή του κατασκευαστή και έπειτα ορίστε ρητά σχέση, ετικέτες και διάταξη. Η παραγωγή που αξιοποιεί πληροφορίες αναζήτησης εξακολουθεί να παράγει εικόνα προς έλεγχο, όχι υποκατάστατο ελέγχου των απεικονιζόμενων στοιχείων.
Η συλλογιστική υποστηρίζει τη σύνθεση πολύπλοκης προτροπής πριν την τελική απόδοση. Ο οδηγός εικόνας περιγράφει ενδιάμεσες εικόνες που χρησιμοποιούνται για δοκιμή σύνθεσης και λογικής, διακριτές από το τελικό παραδοτέο. Μη μεταφέρετε τον πίνακα ελέγχων minimal/high του Nano Banana 2 ή τον πίνακα προεπιλογής medium του Nano Banana 2.1 σε αυτή την έκδοση Pro. Για απαιτητικό σχεδιασμό, δώστε πλήρη περιγραφή με οπτική ιεραρχία, απαιτούμενες σχέσεις αντικειμένων και στοιχεία που πρέπει να επιβιώσουν μεταγενέστερων επεξεργασιών.
Η κάρτα μοντέλου περιγράφει ουσιαστικούς εναπομένοντες περιορισμούς: πολύ μικρό κείμενο και μεγάλα αποσπάσματα μπορεί να αποδίδονται ανεπαρκώς, η εμφάνιση χαρακτήρα μπορεί να αλλάζει μεταξύ αναφοράς και αποτελέσματος και επεξεργασίες με μάσκα ή πρόχειρο σκίτσο μπορεί να ακολουθούν μόνο εν μέρει την οδηγία ή να αφήνουν σημάδια. Μπορεί επίσης να συγχέει αριστερά και δεξιά ή να αντιγράφει στοιχείο πηγής στη νέα σύνθεση. Για αναθεώρηση προϊόντος, δηλώστε ρητά διατηρούμενη γεωμετρία και ετικέτες και επιθεωρήστε την επεξεργασμένη περιοχή· για διάγραμμα, συγκρίνετε κατεύθυνση βελών και σχετικές θέσεις αντικειμένων.
Ο τρέχων πίνακας API δίνει όριο εισόδου 65,536 token και όριο εξόδου 32,768 token. Υποστηρίζονται παραγωγή εικόνας, σκέψη, τεκμηρίωση μέσω αναζήτησης και μαζική επεξεργασία· παραγωγή ήχου, κλήση συναρτήσεων, εκτέλεση κώδικα, προσωρινή αποθήκευση, δομημένες έξοδοι, αναζήτηση αρχείων, URL context και Live API δεν υποστηρίζονται. Η εργασία εικόνας δεν δέχεται ούτε ήχο ούτε βίντεο ως είσοδο σε αυτό το προφίλ. Οι παραγόμενες εικόνες περιλαμβάνουν SynthID και ένας ζητούμενος αριθμός εικόνων εξόδου δεν ακολουθείται πάντα ακριβώς.
Μια πρακτική περιγραφή προϊόντος μπορεί να συνδυάζει εικόνα προϊόντος, αναφορά φωτισμού και τον ακριβή τίτλο: «Διατήρησε τις αναλογίες και τη γραφή του προϊόντος, παρουσίασέ το σε ανοιχτόχρωμη πέτρινη επιφάνεια κάτω από απαλό πλευρικό φως και άφησε το επάνω τρίτο καθαρό για τον παρεχόμενο τίτλο». Για πραγματολογικό διάγραμμα, προσδιορίστε κάθε οντότητα και σύνδεση και δώστε τις εγκεκριμένες ετικέτες. Βελτιώστε το αποτέλεσμα σε συνομιλία ονομάζοντας μία αλλαγή και τα χαρακτηριστικά προς διατήρηση, κρατώντας την επιλεγμένη εικόνα και το επεξηγηματικό της κείμενο μαζί ως σχεδιαστικό παραδοτέο.
", "aboutText": "Το Nano Banana Pro είναι το μοντέλο Gemini 3 Pro Image της Google για παραγωγή και επεξεργασία εικόνας καθοδηγούμενη από συλλογιστική. Ο κατασκευαστής θέτει σύνθετο γραφιστικό σχεδιασμό, μακέτες προϊόντων υψηλής πιστότητας και οπτικοποίηση πραγματολογικών δεδομένων στο επίκεντρο της προβλεπόμενης χρήσης του. Δέχεται κείμενο και εικόνες και παράγει εικόνα και κείμενο. Αυτή η ονομασμένη έκδοση εικόνας Pro βασίζεται στο Gemini 3 Pro, διατηρώντας το δικό της προφίλ εισόδου και δυνατοτήτων εργασιών εικόνας.\n\nΤο μοντέλο υποστηρίζει εικόνες 1K, 2K και 4K. Τα τεκμηριωμένα σχήματα περιλαμβάνουν 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 και 21:9. Μια τετράγωνη εικόνα 4K είναι 4096 × 4096· μια εικόνα 16:9 4K είναι 5504 × 3072. Επιλέξτε ανάλυση και αναλογία για το παραδοτέο που χρειάζεστε, είτε κατακόρυφη αφίσα, σκηνή προϊόντος ή πλατύ επεξηγηματικό γραφικό. Η επιλογή 0.5K και οι πρόσθετες ακραίες αναλογίες του Gemini 3.1 Flash Image δεν αποτελούν μέρος αυτού του πίνακα Pro.\n\nΗ απόδοση κειμένου υποστηρίζει καθαρή γραφή σε αφίσες, διαγράμματα και άλλα σχεδιασμένα στοιχεία. Για σύνθετο πληροφοριογράφημα, δώστε τα υποκείμενα στοιχεία, την ακριβή διατύπωση, ακολουθία ανάγνωσης και σχέση μεταξύ ετικετών και οπτικών στοιχείων. Διαχωρίστε τις πληροφορίες προς επικοινωνία από το επιθυμητό καλλιτεχνικό ύφος. Η Google συνιστά προετοιμασία κειμένου πρώτα και κατόπιν παραγωγή εικόνας που το περιέχει. Αυτό είναι ιδιαίτερα χρήσιμο όταν σύνθεση συνδυάζει τίτλο, διάγραμμα και πολλές σύντομες λεζάντες.\n\nΗ είσοδος πολλών εικόνων υποστηρίζει έως 14 αναφορές. Ο πίνακας δυνατοτήτων της Google περιγράφει έως έξι αναφορές αντικειμένων για πιστότητα, έως πέντε αναφορές χαρακτήρων για συνέπεια και έως τρεις αναφορές ύφους. Αυτοί οι ρόλοι βοηθούν στην προετοιμασία σύνθετου οπτικού στοιχείου: φωτογραφία προϊόντος ορίζει εμφάνιση, χωριστή εικόνα καθορίζει περιβάλλον και μια εικόνα ύφους καθοδηγεί την αισθητική απόδοση. Πείτε στο μοντέλο ποιες λεπτομέρειες είναι δεσμευτικές και ποιες αναφορές παρέχουν έμπνευση αντί να του ζητάτε αδιάκριτο συνδυασμό κάθε ορατού χαρακτηριστικού.\n\nΗ τεκμηρίωση μέσω Google Search μπορεί να παρέχει πληροφορίες πραγματικού κόσμου για πραγματολογική οπτικοποίηση ή σκηνή που λαμβάνει υπόψη τις τρέχουσες συνθήκες. Η ροή εικόνας Pro τεκμηριώνει τη χρήση πηγών του ιστού· η επέκταση Image Search τεκμηριώνεται ειδικά για Nano Banana 2.1 και Gemini 3.1 Flash Image. Για γραφικό δεδομένων, δώστε τις τιμές που σκοπεύετε να εμφανίσετε ή ζητήστε τεκμηριωμένες πληροφορίες στη ροή του κατασκευαστή και έπειτα ορίστε ρητά σχέση, ετικέτες και διάταξη. Η παραγωγή που αξιοποιεί πληροφορίες αναζήτησης εξακολουθεί να παράγει εικόνα προς έλεγχο, όχι υποκατάστατο ελέγχου των απεικονιζόμενων στοιχείων.\n\nΗ συλλογιστική υποστηρίζει τη σύνθεση πολύπλοκης προτροπής πριν την τελική απόδοση. Ο οδηγός εικόνας περιγράφει ενδιάμεσες εικόνες που χρησιμοποιούνται για δοκιμή σύνθεσης και λογικής, διακριτές από το τελικό παραδοτέο. Μη μεταφέρετε τον πίνακα ελέγχων minimal/high του Nano Banana 2 ή τον πίνακα προεπιλογής medium του Nano Banana 2.1 σε αυτή την έκδοση Pro. Για απαιτητικό σχεδιασμό, δώστε πλήρη περιγραφή με οπτική ιεραρχία, απαιτούμενες σχέσεις αντικειμένων και στοιχεία που πρέπει να επιβιώσουν μεταγενέστερων επεξεργασιών.\n\nΗ κάρτα μοντέλου περιγράφει ουσιαστικούς εναπομένοντες περιορισμούς: πολύ μικρό κείμενο και μεγάλα αποσπάσματα μπορεί να αποδίδονται ανεπαρκώς, η εμφάνιση χαρακτήρα μπορεί να αλλάζει μεταξύ αναφοράς και αποτελέσματος και επεξεργασίες με μάσκα ή πρόχειρο σκίτσο μπορεί να ακολουθούν μόνο εν μέρει την οδηγία ή να αφήνουν σημάδια. Μπορεί επίσης να συγχέει αριστερά και δεξιά ή να αντιγράφει στοιχείο πηγής στη νέα σύνθεση. Για αναθεώρηση προϊόντος, δηλώστε ρητά διατηρούμενη γεωμετρία και ετικέτες και επιθεωρήστε την επεξεργασμένη περιοχή· για διάγραμμα, συγκρίνετε κατεύθυνση βελών και σχετικές θέσεις αντικειμένων.\n\nΟ τρέχων πίνακας API δίνει όριο εισόδου 65,536 token και όριο εξόδου 32,768 token. Υποστηρίζονται παραγωγή εικόνας, σκέψη, τεκμηρίωση μέσω αναζήτησης και μαζική επεξεργασία· παραγωγή ήχου, κλήση συναρτήσεων, εκτέλεση κώδικα, προσωρινή αποθήκευση, δομημένες έξοδοι, αναζήτηση αρχείων, URL context και Live API δεν υποστηρίζονται. Η εργασία εικόνας δεν δέχεται ούτε ήχο ούτε βίντεο ως είσοδο σε αυτό το προφίλ. Οι παραγόμενες εικόνες περιλαμβάνουν SynthID και ένας ζητούμενος αριθμός εικόνων εξόδου δεν ακολουθείται πάντα ακριβώς.\n\nΜια πρακτική περιγραφή προϊόντος μπορεί να συνδυάζει εικόνα προϊόντος, αναφορά φωτισμού και τον ακριβή τίτλο: «Διατήρησε τις αναλογίες και τη γραφή του προϊόντος, παρουσίασέ το σε ανοιχτόχρωμη πέτρινη επιφάνεια κάτω από απαλό πλευρικό φως και άφησε το επάνω τρίτο καθαρό για τον παρεχόμενο τίτλο». Για πραγματολογικό διάγραμμα, προσδιορίστε κάθε οντότητα και σύνδεση και δώστε τις εγκεκριμένες ετικέτες. Βελτιώστε το αποτέλεσμα σε συνομιλία ονομάζοντας μία αλλαγή και τα χαρακτηριστικά προς διατήρηση, κρατώντας την επιλεγμένη εικόνα και το επεξηγηματικό της κείμενο μαζί ως σχεδιαστικό παραδοτέο.", "editorialOverlay": { "copy_fields": { "practical_html": "Τεχνικό παράδειγμα στα αγγλικά
Visualize a supplied packaging cycle\n\nCreate one landscape explanatory graphic showing this packaging return cycle: customer returns an empty jar, store inspects it, accepted jars are washed, clean jars are refilled. Use four large illustrated stages connected clockwise. Add only these exact labels: 'RETURN', 'INSPECT', 'WASH', 'REFILL'. Make the arrow direction and stage order unmistakable.One landscape image with four labeled stages and arrows matching the supplied cycle.Inspect that arrows connect RETURN to INSPECT to WASH to REFILL in that order, with exact labels.gemini-3-pro-imageΤο Nano Banana Pro (Gemini 3 Pro Image) είναι το μοντέλο εικόνας της Google που καθοδηγείται από συλλογιστική για σύνθετο σχεδιασμό, μακέτες προϊόντων και πραγματολογικές οπτικοποιήσεις. Δέχεται κείμενο και εικόνες αναφοράς και παράγει εικόνες με κείμενο, με έξοδο 1K–4K και λεπτομερή δημιουργικό έλεγχο.
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Nano Banana Pro είναι το μοντέλο Gemini 3 Pro Image της Google για παραγωγή και επεξεργασία εικόνας καθοδηγούμενη από συλλογιστική. Ο κατασκευαστής θέτει σύνθετο γραφιστικό σχεδιασμό, μακέτες προϊόντων υψηλής πιστότητας και οπτικοποίηση πραγματολογικών δεδομένων στο επίκεντρο της προβλεπόμενης χρήσης του. Δέχεται κείμενο και εικόνες και παράγει εικόνα και κείμενο. Αυτή η ονομασμένη έκδοση εικόνας Pro βασίζεται στο Gemini 3 Pro, διατηρώντας το δικό της προφίλ εισόδου και δυνατοτήτων εργασιών εικόνας.
Το μοντέλο υποστηρίζει εικόνες 1K, 2K και 4K. Τα τεκμηριωμένα σχήματα περιλαμβάνουν 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 και 21:9. Μια τετράγωνη εικόνα 4K είναι 4096 × 4096· μια εικόνα 16:9 4K είναι 5504 × 3072. Επιλέξτε ανάλυση και αναλογία για το παραδοτέο που χρειάζεστε, είτε κατακόρυφη αφίσα, σκηνή προϊόντος ή πλατύ επεξηγηματικό γραφικό. Η επιλογή 0.5K και οι πρόσθετες ακραίες αναλογίες του Gemini 3.1 Flash Image δεν αποτελούν μέρος αυτού του πίνακα Pro.
Η απόδοση κειμένου υποστηρίζει καθαρή γραφή σε αφίσες, διαγράμματα και άλλα σχεδιασμένα στοιχεία. Για σύνθετο πληροφοριογράφημα, δώστε τα υποκείμενα στοιχεία, την ακριβή διατύπωση, ακολουθία ανάγνωσης και σχέση μεταξύ ετικετών και οπτικών στοιχείων. Διαχωρίστε τις πληροφορίες προς επικοινωνία από το επιθυμητό καλλιτεχνικό ύφος. Η Google συνιστά προετοιμασία κειμένου πρώτα και κατόπιν παραγωγή εικόνας που το περιέχει. Αυτό είναι ιδιαίτερα χρήσιμο όταν σύνθεση συνδυάζει τίτλο, διάγραμμα και πολλές σύντομες λεζάντες.
Η είσοδος πολλών εικόνων υποστηρίζει έως 14 αναφορές. Ο πίνακας δυνατοτήτων της Google περιγράφει έως έξι αναφορές αντικειμένων για πιστότητα, έως πέντε αναφορές χαρακτήρων για συνέπεια και έως τρεις αναφορές ύφους. Αυτοί οι ρόλοι βοηθούν στην προετοιμασία σύνθετου οπτικού στοιχείου: φωτογραφία προϊόντος ορίζει εμφάνιση, χωριστή εικόνα καθορίζει περιβάλλον και μια εικόνα ύφους καθοδηγεί την αισθητική απόδοση. Πείτε στο μοντέλο ποιες λεπτομέρειες είναι δεσμευτικές και ποιες αναφορές παρέχουν έμπνευση αντί να του ζητάτε αδιάκριτο συνδυασμό κάθε ορατού χαρακτηριστικού.
Η τεκμηρίωση μέσω Google Search μπορεί να παρέχει πληροφορίες πραγματικού κόσμου για πραγματολογική οπτικοποίηση ή σκηνή που λαμβάνει υπόψη τις τρέχουσες συνθήκες. Η ροή εικόνας Pro τεκμηριώνει τη χρήση πηγών του ιστού· η επέκταση Image Search τεκμηριώνεται ειδικά για Nano Banana 2.1 και Gemini 3.1 Flash Image. Για γραφικό δεδομένων, δώστε τις τιμές που σκοπεύετε να εμφανίσετε ή ζητήστε τεκμηριωμένες πληροφορίες στη ροή του κατασκευαστή και έπειτα ορίστε ρητά σχέση, ετικέτες και διάταξη. Η παραγωγή που αξιοποιεί πληροφορίες αναζήτησης εξακολουθεί να παράγει εικόνα προς έλεγχο, όχι υποκατάστατο ελέγχου των απεικονιζόμενων στοιχείων.
Η συλλογιστική υποστηρίζει τη σύνθεση πολύπλοκης προτροπής πριν την τελική απόδοση. Ο οδηγός εικόνας περιγράφει ενδιάμεσες εικόνες που χρησιμοποιούνται για δοκιμή σύνθεσης και λογικής, διακριτές από το τελικό παραδοτέο. Μη μεταφέρετε τον πίνακα ελέγχων minimal/high του Nano Banana 2 ή τον πίνακα προεπιλογής medium του Nano Banana 2.1 σε αυτή την έκδοση Pro. Για απαιτητικό σχεδιασμό, δώστε πλήρη περιγραφή με οπτική ιεραρχία, απαιτούμενες σχέσεις αντικειμένων και στοιχεία που πρέπει να επιβιώσουν μεταγενέστερων επεξεργασιών.
Η κάρτα μοντέλου περιγράφει ουσιαστικούς εναπομένοντες περιορισμούς: πολύ μικρό κείμενο και μεγάλα αποσπάσματα μπορεί να αποδίδονται ανεπαρκώς, η εμφάνιση χαρακτήρα μπορεί να αλλάζει μεταξύ αναφοράς και αποτελέσματος και επεξεργασίες με μάσκα ή πρόχειρο σκίτσο μπορεί να ακολουθούν μόνο εν μέρει την οδηγία ή να αφήνουν σημάδια. Μπορεί επίσης να συγχέει αριστερά και δεξιά ή να αντιγράφει στοιχείο πηγής στη νέα σύνθεση. Για αναθεώρηση προϊόντος, δηλώστε ρητά διατηρούμενη γεωμετρία και ετικέτες και επιθεωρήστε την επεξεργασμένη περιοχή· για διάγραμμα, συγκρίνετε κατεύθυνση βελών και σχετικές θέσεις αντικειμένων.
Ο τρέχων πίνακας API δίνει όριο εισόδου 65,536 token και όριο εξόδου 32,768 token. Υποστηρίζονται παραγωγή εικόνας, σκέψη, τεκμηρίωση μέσω αναζήτησης και μαζική επεξεργασία· παραγωγή ήχου, κλήση συναρτήσεων, εκτέλεση κώδικα, προσωρινή αποθήκευση, δομημένες έξοδοι, αναζήτηση αρχείων, URL context και Live API δεν υποστηρίζονται. Η εργασία εικόνας δεν δέχεται ούτε ήχο ούτε βίντεο ως είσοδο σε αυτό το προφίλ. Οι παραγόμενες εικόνες περιλαμβάνουν SynthID και ένας ζητούμενος αριθμός εικόνων εξόδου δεν ακολουθείται πάντα ακριβώς.
Μια πρακτική περιγραφή προϊόντος μπορεί να συνδυάζει εικόνα προϊόντος, αναφορά φωτισμού και τον ακριβή τίτλο: «Διατήρησε τις αναλογίες και τη γραφή του προϊόντος, παρουσίασέ το σε ανοιχτόχρωμη πέτρινη επιφάνεια κάτω από απαλό πλευρικό φως και άφησε το επάνω τρίτο καθαρό για τον παρεχόμενο τίτλο». Για πραγματολογικό διάγραμμα, προσδιορίστε κάθε οντότητα και σύνδεση και δώστε τις εγκεκριμένες ετικέτες. Βελτιώστε το αποτέλεσμα σε συνομιλία ονομάζοντας μία αλλαγή και τα χαρακτηριστικά προς διατήρηση, κρατώντας την επιλεγμένη εικόνα και το επεξηγηματικό της κείμενο μαζί ως σχεδιαστικό παραδοτέο.
POST /v1/images/generationstextimage| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια gemini-3-pro-image | Προεπιλογή— |
Πεδίοprompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Ελάχιστο μήκος: 1 | Προεπιλογή— |
Πεδίοn | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: 1 | Προεπιλογή1 |
Πεδίοresponse_format | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια url, b64_json | Προεπιλογή— |
Πεδίοstream | Τύποςboolean | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογήfalse |
Πεδίοsize | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοquality | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοbackground | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοoutput_format | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοoutput_compression | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοmoderation | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοinput_fidelity | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοstyle | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοpartial_images | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Κείμενο σε εικόνα · Υποχρεωτικό: prompt
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςmaterial_types | Σύμβασηtext |
Παράμετροςrequired | Σύμβασηmodel, prompt |
Παράμετροςoptional_controls | Σύμβασηnull |
Παράμετροςcontent_type | Σύμβασηapplication/json |
Κύκλος ζωής: 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}
Οι δομές και τα ID των μεθόδων είναι ακριβή· η δυνατότητα του προμηθευτή είναι ξεχωριστή από την αποδοχή αιτημάτων.
POST /v1/images/generationsΤο Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Οι πίνακες αναφοράς του μοντέλου δεν αλλάζουν την επιλογή μεθόδου, τις εκτιμήσεις τιμής ή τις χρεώσεις. Οι εφαρμοζόμενες χρεώσεις χρησιμοποιούν τις τιμές της επιλεγμένης μεθόδου Ailoot.
| Διαμόρφωση | Πίνακας χρεώσεων | Χρέωση |
|---|---|---|
| ΔιαμόρφωσηUltra | Πίνακας χρεώσεωνΒασική χρέωση | Χρέωση Είσοδος · Token εισόδου $0.004000 / 1K token Έξοδος · Token εξόδου $0.024000 / 1K token Είσοδος · εικόνα $0.004000 / 1K token Έξοδος · έξοδος εικόνας $0.24000 / 1K token Είσοδος · ήχος $0.004000 / 1K token Είσοδος · κρυφή μνήμη ήχου εισόδου $0.0004000 / 1K token Έξοδος · αναζήτηση στον ιστό $0.028 ανά αναζήτηση στον ιστό Έξοδος · εσωτερικός συλλογισμός $0.024000 / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη $0.0004000 / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη $0.000750000 / 1K token |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "gemini-3-pro-image", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nfrom openai import OpenAI\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\n\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'gemini-3-pro-image', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "gemini-3-pro-image", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\nΚατεβάστε κάθε εικόνα που επιστρέφεται ή αποθηκεύστε το περιεχόμενο Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Αποθηκεύστε κάθε ολοκληρωμένη εικόνα· ανακτήστε κάθε URL που επιστρέφεται ή αποκωδικοποιήστε το περιεχόμενο Base64.
Αποθηκεύστε κάθε στοιχείο δεδομένων. Αποκωδικοποιήστε κάθε b64_json ή ανακτήστε κάθε υπογεγραμμένο URL που επιστράφηκε. Επιλέξτε την επέκταση του ονόματος αρχείου βάσει του πραγματικού τύπου MIME/των byte.
Αν το αποτέλεσμα παραγωγής ή επεξεργασίας εικόνας χρειάζεται έλεγχο, διατηρήστε το αρχικό operation_id/X-Client-Request-ID και τις πληροφορίες αποτελέσματος που επιστράφηκαν. Ανακτήστε τα υπάρχοντα αποτελέσματα που σας ανήκουν μέσω της βιβλιοθήκης πολυμέσων χρησιμοποιώντας πραγματικές τιμές task_id ή asset_id. Μην υποβάλετε ξανά το αίτημα παραγωγής/επεξεργασίας και μην κατασκευάσετε URL περιοδικού ελέγχου από το operation_id.
| Πεδίο | Τύπος |
|---|---|
Πεδίοcreated | Τύποςinteger |
Πεδίοdata[].url | Τύποςstring |
Πεδίοdata[].b64_json | Τύποςbase64 string |
Πεδίοusage | Τύποςobject |
| Απάντηση | Συνθήκη | Επόμενο βήμα |
|---|---|---|
Απάντηση400 · invalid_request_error | ΣυνθήκηΜη έγκυρα υποχρεωτικά πεδία, μη έγκυρη αναπαράσταση υλικού ή μη έγκυρη τιμή παραμέτρου | Επόμενο βήμαΔιορθώστε τα υποδεικνυόμενα πεδία πριν από νέο αίτημα δημιουργίας. |
Απάντησηserver_error | ΣυνθήκηΗ απόκριση που επιστράφηκε αναφέρει ότι η λειτουργία ή το αποτέλεσμα χρειάζεται έλεγχο | Επόμενο βήμαΔιατηρήστε το αρχικό ID της λειτουργίας/εργασίας που επιστράφηκε, τις κεφαλίδες του αιτήματος και την απόκριση· συνεχίστε με τις υποστηριζόμενες αναγνώσεις αυτής της αρχικής λειτουργίας. Μην υποβάλετε ξανά το αίτημα δημιουργίας. |
Ailoot gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro
Ailoot Ultra google/gemini-3-pro-image
/v1/images
google/gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro, gemini-3-pro-image
gemini-3-pro-image-previewΤο Nano Banana Pro (Gemini 3 Pro Image) είναι το μοντέλο εικόνας της Google που καθοδηγείται από συλλογιστική για σύνθετο σχεδιασμό, μακέτες προϊόντων και πραγματολογικές οπτικοποιήσεις. Δέχεται κείμενο και εικόνες αναφοράς και παράγει εικόνες με κείμενο, με έξοδο 1K–4K και λεπτομερή δημιουργικό έλεγχο.
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Nano Banana Pro είναι το μοντέλο Gemini 3 Pro Image της Google για παραγωγή και επεξεργασία εικόνας καθοδηγούμενη από συλλογιστική. Ο κατασκευαστής θέτει σύνθετο γραφιστικό σχεδιασμό, μακέτες προϊόντων υψηλής πιστότητας και οπτικοποίηση πραγματολογικών δεδομένων στο επίκεντρο της προβλεπόμενης χρήσης του. Δέχεται κείμενο και εικόνες και παράγει εικόνα και κείμενο. Αυτή η ονομασμένη έκδοση εικόνας Pro βασίζεται στο Gemini 3 Pro, διατηρώντας το δικό της προφίλ εισόδου και δυνατοτήτων εργασιών εικόνας.
Το μοντέλο υποστηρίζει εικόνες 1K, 2K και 4K. Τα τεκμηριωμένα σχήματα περιλαμβάνουν 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 και 21:9. Μια τετράγωνη εικόνα 4K είναι 4096 × 4096· μια εικόνα 16:9 4K είναι 5504 × 3072. Επιλέξτε ανάλυση και αναλογία για το παραδοτέο που χρειάζεστε, είτε κατακόρυφη αφίσα, σκηνή προϊόντος ή πλατύ επεξηγηματικό γραφικό. Η επιλογή 0.5K και οι πρόσθετες ακραίες αναλογίες του Gemini 3.1 Flash Image δεν αποτελούν μέρος αυτού του πίνακα Pro.
Η απόδοση κειμένου υποστηρίζει καθαρή γραφή σε αφίσες, διαγράμματα και άλλα σχεδιασμένα στοιχεία. Για σύνθετο πληροφοριογράφημα, δώστε τα υποκείμενα στοιχεία, την ακριβή διατύπωση, ακολουθία ανάγνωσης και σχέση μεταξύ ετικετών και οπτικών στοιχείων. Διαχωρίστε τις πληροφορίες προς επικοινωνία από το επιθυμητό καλλιτεχνικό ύφος. Η Google συνιστά προετοιμασία κειμένου πρώτα και κατόπιν παραγωγή εικόνας που το περιέχει. Αυτό είναι ιδιαίτερα χρήσιμο όταν σύνθεση συνδυάζει τίτλο, διάγραμμα και πολλές σύντομες λεζάντες.
Η είσοδος πολλών εικόνων υποστηρίζει έως 14 αναφορές. Ο πίνακας δυνατοτήτων της Google περιγράφει έως έξι αναφορές αντικειμένων για πιστότητα, έως πέντε αναφορές χαρακτήρων για συνέπεια και έως τρεις αναφορές ύφους. Αυτοί οι ρόλοι βοηθούν στην προετοιμασία σύνθετου οπτικού στοιχείου: φωτογραφία προϊόντος ορίζει εμφάνιση, χωριστή εικόνα καθορίζει περιβάλλον και μια εικόνα ύφους καθοδηγεί την αισθητική απόδοση. Πείτε στο μοντέλο ποιες λεπτομέρειες είναι δεσμευτικές και ποιες αναφορές παρέχουν έμπνευση αντί να του ζητάτε αδιάκριτο συνδυασμό κάθε ορατού χαρακτηριστικού.
Η τεκμηρίωση μέσω Google Search μπορεί να παρέχει πληροφορίες πραγματικού κόσμου για πραγματολογική οπτικοποίηση ή σκηνή που λαμβάνει υπόψη τις τρέχουσες συνθήκες. Η ροή εικόνας Pro τεκμηριώνει τη χρήση πηγών του ιστού· η επέκταση Image Search τεκμηριώνεται ειδικά για Nano Banana 2.1 και Gemini 3.1 Flash Image. Για γραφικό δεδομένων, δώστε τις τιμές που σκοπεύετε να εμφανίσετε ή ζητήστε τεκμηριωμένες πληροφορίες στη ροή του κατασκευαστή και έπειτα ορίστε ρητά σχέση, ετικέτες και διάταξη. Η παραγωγή που αξιοποιεί πληροφορίες αναζήτησης εξακολουθεί να παράγει εικόνα προς έλεγχο, όχι υποκατάστατο ελέγχου των απεικονιζόμενων στοιχείων.
Η συλλογιστική υποστηρίζει τη σύνθεση πολύπλοκης προτροπής πριν την τελική απόδοση. Ο οδηγός εικόνας περιγράφει ενδιάμεσες εικόνες που χρησιμοποιούνται για δοκιμή σύνθεσης και λογικής, διακριτές από το τελικό παραδοτέο. Μη μεταφέρετε τον πίνακα ελέγχων minimal/high του Nano Banana 2 ή τον πίνακα προεπιλογής medium του Nano Banana 2.1 σε αυτή την έκδοση Pro. Για απαιτητικό σχεδιασμό, δώστε πλήρη περιγραφή με οπτική ιεραρχία, απαιτούμενες σχέσεις αντικειμένων και στοιχεία που πρέπει να επιβιώσουν μεταγενέστερων επεξεργασιών.
Η κάρτα μοντέλου περιγράφει ουσιαστικούς εναπομένοντες περιορισμούς: πολύ μικρό κείμενο και μεγάλα αποσπάσματα μπορεί να αποδίδονται ανεπαρκώς, η εμφάνιση χαρακτήρα μπορεί να αλλάζει μεταξύ αναφοράς και αποτελέσματος και επεξεργασίες με μάσκα ή πρόχειρο σκίτσο μπορεί να ακολουθούν μόνο εν μέρει την οδηγία ή να αφήνουν σημάδια. Μπορεί επίσης να συγχέει αριστερά και δεξιά ή να αντιγράφει στοιχείο πηγής στη νέα σύνθεση. Για αναθεώρηση προϊόντος, δηλώστε ρητά διατηρούμενη γεωμετρία και ετικέτες και επιθεωρήστε την επεξεργασμένη περιοχή· για διάγραμμα, συγκρίνετε κατεύθυνση βελών και σχετικές θέσεις αντικειμένων.
Ο τρέχων πίνακας API δίνει όριο εισόδου 65,536 token και όριο εξόδου 32,768 token. Υποστηρίζονται παραγωγή εικόνας, σκέψη, τεκμηρίωση μέσω αναζήτησης και μαζική επεξεργασία· παραγωγή ήχου, κλήση συναρτήσεων, εκτέλεση κώδικα, προσωρινή αποθήκευση, δομημένες έξοδοι, αναζήτηση αρχείων, URL context και Live API δεν υποστηρίζονται. Η εργασία εικόνας δεν δέχεται ούτε ήχο ούτε βίντεο ως είσοδο σε αυτό το προφίλ. Οι παραγόμενες εικόνες περιλαμβάνουν SynthID και ένας ζητούμενος αριθμός εικόνων εξόδου δεν ακολουθείται πάντα ακριβώς.
Μια πρακτική περιγραφή προϊόντος μπορεί να συνδυάζει εικόνα προϊόντος, αναφορά φωτισμού και τον ακριβή τίτλο: «Διατήρησε τις αναλογίες και τη γραφή του προϊόντος, παρουσίασέ το σε ανοιχτόχρωμη πέτρινη επιφάνεια κάτω από απαλό πλευρικό φως και άφησε το επάνω τρίτο καθαρό για τον παρεχόμενο τίτλο». Για πραγματολογικό διάγραμμα, προσδιορίστε κάθε οντότητα και σύνδεση και δώστε τις εγκεκριμένες ετικέτες. Βελτιώστε το αποτέλεσμα σε συνομιλία ονομάζοντας μία αλλαγή και τα χαρακτηριστικά προς διατήρηση, κρατώντας την επιλεγμένη εικόνα και το επεξηγηματικό της κείμενο μαζί ως σχεδιαστικό παραδοτέο.
POST /v1/images/generationstextimage| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια gemini-3-pro-image-preview | Προεπιλογή— |
Πεδίοprompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Ελάχιστο μήκος: 1 | Προεπιλογή— |
Πεδίοn | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: 1 | Προεπιλογή1 |
Πεδίοresponse_format | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια url, b64_json | Προεπιλογή— |
Πεδίοstream | Τύποςboolean | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογήfalse |
Πεδίοsize | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοquality | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοbackground | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοoutput_format | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοoutput_compression | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοmoderation | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοinput_fidelity | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοstyle | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοpartial_images | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Κείμενο σε εικόνα · Υποχρεωτικό: prompt
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςmaterial_types | Σύμβασηtext |
Παράμετροςrequired | Σύμβασηmodel, prompt |
Παράμετροςoptional_controls | Σύμβασηnull |
Παράμετροςcontent_type | Σύμβασηapplication/json |
Κύκλος ζωής: 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}
Οι δομές και τα ID των μεθόδων είναι ακριβή· η δυνατότητα του προμηθευτή είναι ξεχωριστή από την αποδοχή αιτημάτων.
POST /v1/images/generationsΤο Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Οι πίνακες αναφοράς του μοντέλου δεν αλλάζουν την επιλογή μεθόδου, τις εκτιμήσεις τιμής ή τις χρεώσεις. Οι εφαρμοζόμενες χρεώσεις χρησιμοποιούν τις τιμές της επιλεγμένης μεθόδου Ailoot.
| Διαμόρφωση | Πίνακας χρεώσεων | Χρέωση |
|---|---|---|
| ΔιαμόρφωσηUltra | Πίνακας χρεώσεωνΒασική χρέωση | Χρέωση Είσοδος · Token εισόδου $0.004000 / 1K token Έξοδος · Token εξόδου $0.024000 / 1K token Είσοδος · εικόνα $0.004000 / 1K token Έξοδος · έξοδος εικόνας $0.24000 / 1K token Είσοδος · ήχος $0.004000 / 1K token Είσοδος · κρυφή μνήμη ήχου εισόδου $0.0004000 / 1K token Έξοδος · αναζήτηση στον ιστό $0.028 ανά αναζήτηση στον ιστό Έξοδος · εσωτερικός συλλογισμός $0.024000 / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη $0.0004000 / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη $0.000750000 / 1K token |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "gemini-3-pro-image-preview", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nfrom openai import OpenAI\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\n\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'gemini-3-pro-image-preview', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "gemini-3-pro-image-preview", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\nΚατεβάστε κάθε εικόνα που επιστρέφεται ή αποθηκεύστε το περιεχόμενο Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Αποθηκεύστε κάθε ολοκληρωμένη εικόνα· ανακτήστε κάθε URL που επιστρέφεται ή αποκωδικοποιήστε το περιεχόμενο Base64.
Αποθηκεύστε κάθε στοιχείο δεδομένων. Αποκωδικοποιήστε κάθε b64_json ή ανακτήστε κάθε υπογεγραμμένο URL που επιστράφηκε. Επιλέξτε την επέκταση του ονόματος αρχείου βάσει του πραγματικού τύπου MIME/των byte.
Αν το αποτέλεσμα παραγωγής ή επεξεργασίας εικόνας χρειάζεται έλεγχο, διατηρήστε το αρχικό operation_id/X-Client-Request-ID και τις πληροφορίες αποτελέσματος που επιστράφηκαν. Ανακτήστε τα υπάρχοντα αποτελέσματα που σας ανήκουν μέσω της βιβλιοθήκης πολυμέσων χρησιμοποιώντας πραγματικές τιμές task_id ή asset_id. Μην υποβάλετε ξανά το αίτημα παραγωγής/επεξεργασίας και μην κατασκευάσετε URL περιοδικού ελέγχου από το operation_id.
| Πεδίο | Τύπος |
|---|---|
Πεδίοcreated | Τύποςinteger |
Πεδίοdata[].url | Τύποςstring |
Πεδίοdata[].b64_json | Τύποςbase64 string |
Πεδίοusage | Τύποςobject |
| Απάντηση | Συνθήκη | Επόμενο βήμα |
|---|---|---|
Απάντηση400 · invalid_request_error | ΣυνθήκηΜη έγκυρα υποχρεωτικά πεδία, μη έγκυρη αναπαράσταση υλικού ή μη έγκυρη τιμή παραμέτρου | Επόμενο βήμαΔιορθώστε τα υποδεικνυόμενα πεδία πριν από νέο αίτημα δημιουργίας. |
Απάντησηserver_error | ΣυνθήκηΗ απόκριση που επιστράφηκε αναφέρει ότι η λειτουργία ή το αποτέλεσμα χρειάζεται έλεγχο | Επόμενο βήμαΔιατηρήστε το αρχικό ID της λειτουργίας/εργασίας που επιστράφηκε, τις κεφαλίδες του αιτήματος και την απόκριση· συνεχίστε με τις υποστηριζόμενες αναγνώσεις αυτής της αρχικής λειτουργίας. Μην υποβάλετε ξανά το αίτημα δημιουργίας. |
Ailoot gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro
Ailoot Ultra google/gemini-3-pro-image
/v1/images
google/gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro, gemini-3-pro-image
nano-banana-proΤο Nano Banana Pro (Gemini 3 Pro Image) είναι το μοντέλο εικόνας της Google που καθοδηγείται από συλλογιστική για σύνθετο σχεδιασμό, μακέτες προϊόντων και πραγματολογικές οπτικοποιήσεις. Δέχεται κείμενο και εικόνες αναφοράς και παράγει εικόνες με κείμενο, με έξοδο 1K–4K και λεπτομερή δημιουργικό έλεγχο.
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Nano Banana Pro είναι το μοντέλο Gemini 3 Pro Image της Google για παραγωγή και επεξεργασία εικόνας καθοδηγούμενη από συλλογιστική. Ο κατασκευαστής θέτει σύνθετο γραφιστικό σχεδιασμό, μακέτες προϊόντων υψηλής πιστότητας και οπτικοποίηση πραγματολογικών δεδομένων στο επίκεντρο της προβλεπόμενης χρήσης του. Δέχεται κείμενο και εικόνες και παράγει εικόνα και κείμενο. Αυτή η ονομασμένη έκδοση εικόνας Pro βασίζεται στο Gemini 3 Pro, διατηρώντας το δικό της προφίλ εισόδου και δυνατοτήτων εργασιών εικόνας.
Το μοντέλο υποστηρίζει εικόνες 1K, 2K και 4K. Τα τεκμηριωμένα σχήματα περιλαμβάνουν 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 και 21:9. Μια τετράγωνη εικόνα 4K είναι 4096 × 4096· μια εικόνα 16:9 4K είναι 5504 × 3072. Επιλέξτε ανάλυση και αναλογία για το παραδοτέο που χρειάζεστε, είτε κατακόρυφη αφίσα, σκηνή προϊόντος ή πλατύ επεξηγηματικό γραφικό. Η επιλογή 0.5K και οι πρόσθετες ακραίες αναλογίες του Gemini 3.1 Flash Image δεν αποτελούν μέρος αυτού του πίνακα Pro.
Η απόδοση κειμένου υποστηρίζει καθαρή γραφή σε αφίσες, διαγράμματα και άλλα σχεδιασμένα στοιχεία. Για σύνθετο πληροφοριογράφημα, δώστε τα υποκείμενα στοιχεία, την ακριβή διατύπωση, ακολουθία ανάγνωσης και σχέση μεταξύ ετικετών και οπτικών στοιχείων. Διαχωρίστε τις πληροφορίες προς επικοινωνία από το επιθυμητό καλλιτεχνικό ύφος. Η Google συνιστά προετοιμασία κειμένου πρώτα και κατόπιν παραγωγή εικόνας που το περιέχει. Αυτό είναι ιδιαίτερα χρήσιμο όταν σύνθεση συνδυάζει τίτλο, διάγραμμα και πολλές σύντομες λεζάντες.
Η είσοδος πολλών εικόνων υποστηρίζει έως 14 αναφορές. Ο πίνακας δυνατοτήτων της Google περιγράφει έως έξι αναφορές αντικειμένων για πιστότητα, έως πέντε αναφορές χαρακτήρων για συνέπεια και έως τρεις αναφορές ύφους. Αυτοί οι ρόλοι βοηθούν στην προετοιμασία σύνθετου οπτικού στοιχείου: φωτογραφία προϊόντος ορίζει εμφάνιση, χωριστή εικόνα καθορίζει περιβάλλον και μια εικόνα ύφους καθοδηγεί την αισθητική απόδοση. Πείτε στο μοντέλο ποιες λεπτομέρειες είναι δεσμευτικές και ποιες αναφορές παρέχουν έμπνευση αντί να του ζητάτε αδιάκριτο συνδυασμό κάθε ορατού χαρακτηριστικού.
Η τεκμηρίωση μέσω Google Search μπορεί να παρέχει πληροφορίες πραγματικού κόσμου για πραγματολογική οπτικοποίηση ή σκηνή που λαμβάνει υπόψη τις τρέχουσες συνθήκες. Η ροή εικόνας Pro τεκμηριώνει τη χρήση πηγών του ιστού· η επέκταση Image Search τεκμηριώνεται ειδικά για Nano Banana 2.1 και Gemini 3.1 Flash Image. Για γραφικό δεδομένων, δώστε τις τιμές που σκοπεύετε να εμφανίσετε ή ζητήστε τεκμηριωμένες πληροφορίες στη ροή του κατασκευαστή και έπειτα ορίστε ρητά σχέση, ετικέτες και διάταξη. Η παραγωγή που αξιοποιεί πληροφορίες αναζήτησης εξακολουθεί να παράγει εικόνα προς έλεγχο, όχι υποκατάστατο ελέγχου των απεικονιζόμενων στοιχείων.
Η συλλογιστική υποστηρίζει τη σύνθεση πολύπλοκης προτροπής πριν την τελική απόδοση. Ο οδηγός εικόνας περιγράφει ενδιάμεσες εικόνες που χρησιμοποιούνται για δοκιμή σύνθεσης και λογικής, διακριτές από το τελικό παραδοτέο. Μη μεταφέρετε τον πίνακα ελέγχων minimal/high του Nano Banana 2 ή τον πίνακα προεπιλογής medium του Nano Banana 2.1 σε αυτή την έκδοση Pro. Για απαιτητικό σχεδιασμό, δώστε πλήρη περιγραφή με οπτική ιεραρχία, απαιτούμενες σχέσεις αντικειμένων και στοιχεία που πρέπει να επιβιώσουν μεταγενέστερων επεξεργασιών.
Η κάρτα μοντέλου περιγράφει ουσιαστικούς εναπομένοντες περιορισμούς: πολύ μικρό κείμενο και μεγάλα αποσπάσματα μπορεί να αποδίδονται ανεπαρκώς, η εμφάνιση χαρακτήρα μπορεί να αλλάζει μεταξύ αναφοράς και αποτελέσματος και επεξεργασίες με μάσκα ή πρόχειρο σκίτσο μπορεί να ακολουθούν μόνο εν μέρει την οδηγία ή να αφήνουν σημάδια. Μπορεί επίσης να συγχέει αριστερά και δεξιά ή να αντιγράφει στοιχείο πηγής στη νέα σύνθεση. Για αναθεώρηση προϊόντος, δηλώστε ρητά διατηρούμενη γεωμετρία και ετικέτες και επιθεωρήστε την επεξεργασμένη περιοχή· για διάγραμμα, συγκρίνετε κατεύθυνση βελών και σχετικές θέσεις αντικειμένων.
Ο τρέχων πίνακας API δίνει όριο εισόδου 65,536 token και όριο εξόδου 32,768 token. Υποστηρίζονται παραγωγή εικόνας, σκέψη, τεκμηρίωση μέσω αναζήτησης και μαζική επεξεργασία· παραγωγή ήχου, κλήση συναρτήσεων, εκτέλεση κώδικα, προσωρινή αποθήκευση, δομημένες έξοδοι, αναζήτηση αρχείων, URL context και Live API δεν υποστηρίζονται. Η εργασία εικόνας δεν δέχεται ούτε ήχο ούτε βίντεο ως είσοδο σε αυτό το προφίλ. Οι παραγόμενες εικόνες περιλαμβάνουν SynthID και ένας ζητούμενος αριθμός εικόνων εξόδου δεν ακολουθείται πάντα ακριβώς.
Μια πρακτική περιγραφή προϊόντος μπορεί να συνδυάζει εικόνα προϊόντος, αναφορά φωτισμού και τον ακριβή τίτλο: «Διατήρησε τις αναλογίες και τη γραφή του προϊόντος, παρουσίασέ το σε ανοιχτόχρωμη πέτρινη επιφάνεια κάτω από απαλό πλευρικό φως και άφησε το επάνω τρίτο καθαρό για τον παρεχόμενο τίτλο». Για πραγματολογικό διάγραμμα, προσδιορίστε κάθε οντότητα και σύνδεση και δώστε τις εγκεκριμένες ετικέτες. Βελτιώστε το αποτέλεσμα σε συνομιλία ονομάζοντας μία αλλαγή και τα χαρακτηριστικά προς διατήρηση, κρατώντας την επιλεγμένη εικόνα και το επεξηγηματικό της κείμενο μαζί ως σχεδιαστικό παραδοτέο.
POST /v1/images/generationstextimage| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια nano-banana-pro | Προεπιλογή— |
Πεδίοprompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Ελάχιστο μήκος: 1 | Προεπιλογή— |
Πεδίοn | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: 1 | Προεπιλογή1 |
Πεδίοresponse_format | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια url, b64_json | Προεπιλογή— |
Πεδίοstream | Τύποςboolean | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογήfalse |
Πεδίοsize | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοquality | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοbackground | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοoutput_format | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοoutput_compression | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοmoderation | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοinput_fidelity | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοstyle | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοpartial_images | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Κείμενο σε εικόνα · Υποχρεωτικό: prompt
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςmaterial_types | Σύμβασηtext |
Παράμετροςrequired | Σύμβασηmodel, prompt |
Παράμετροςoptional_controls | Σύμβασηnull |
Παράμετροςcontent_type | Σύμβασηapplication/json |
Κύκλος ζωής: 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}
Οι δομές και τα ID των μεθόδων είναι ακριβή· η δυνατότητα του προμηθευτή είναι ξεχωριστή από την αποδοχή αιτημάτων.
POST /v1/images/generationsΤο Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Οι πίνακες αναφοράς του μοντέλου δεν αλλάζουν την επιλογή μεθόδου, τις εκτιμήσεις τιμής ή τις χρεώσεις. Οι εφαρμοζόμενες χρεώσεις χρησιμοποιούν τις τιμές της επιλεγμένης μεθόδου Ailoot.
| Διαμόρφωση | Πίνακας χρεώσεων | Χρέωση |
|---|---|---|
| ΔιαμόρφωσηUltra | Πίνακας χρεώσεωνΒασική χρέωση | Χρέωση Είσοδος · Token εισόδου $0.004000 / 1K token Έξοδος · Token εξόδου $0.024000 / 1K token Είσοδος · εικόνα $0.004000 / 1K token Έξοδος · έξοδος εικόνας $0.24000 / 1K token Είσοδος · ήχος $0.004000 / 1K token Είσοδος · κρυφή μνήμη ήχου εισόδου $0.0004000 / 1K token Έξοδος · αναζήτηση στον ιστό $0.028 ανά αναζήτηση στον ιστό Έξοδος · εσωτερικός συλλογισμός $0.024000 / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη $0.0004000 / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη $0.000750000 / 1K token |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "nano-banana-pro", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nfrom openai import OpenAI\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\n\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'nano-banana-pro', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "nano-banana-pro", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\nΚατεβάστε κάθε εικόνα που επιστρέφεται ή αποθηκεύστε το περιεχόμενο Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Αποθηκεύστε κάθε ολοκληρωμένη εικόνα· ανακτήστε κάθε URL που επιστρέφεται ή αποκωδικοποιήστε το περιεχόμενο Base64.
Αποθηκεύστε κάθε στοιχείο δεδομένων. Αποκωδικοποιήστε κάθε b64_json ή ανακτήστε κάθε υπογεγραμμένο URL που επιστράφηκε. Επιλέξτε την επέκταση του ονόματος αρχείου βάσει του πραγματικού τύπου MIME/των byte.
Αν το αποτέλεσμα παραγωγής ή επεξεργασίας εικόνας χρειάζεται έλεγχο, διατηρήστε το αρχικό operation_id/X-Client-Request-ID και τις πληροφορίες αποτελέσματος που επιστράφηκαν. Ανακτήστε τα υπάρχοντα αποτελέσματα που σας ανήκουν μέσω της βιβλιοθήκης πολυμέσων χρησιμοποιώντας πραγματικές τιμές task_id ή asset_id. Μην υποβάλετε ξανά το αίτημα παραγωγής/επεξεργασίας και μην κατασκευάσετε URL περιοδικού ελέγχου από το operation_id.
| Πεδίο | Τύπος |
|---|---|
Πεδίοcreated | Τύποςinteger |
Πεδίοdata[].url | Τύποςstring |
Πεδίοdata[].b64_json | Τύποςbase64 string |
Πεδίοusage | Τύποςobject |
| Απάντηση | Συνθήκη | Επόμενο βήμα |
|---|---|---|
Απάντηση400 · invalid_request_error | ΣυνθήκηΜη έγκυρα υποχρεωτικά πεδία, μη έγκυρη αναπαράσταση υλικού ή μη έγκυρη τιμή παραμέτρου | Επόμενο βήμαΔιορθώστε τα υποδεικνυόμενα πεδία πριν από νέο αίτημα δημιουργίας. |
Απάντησηserver_error | ΣυνθήκηΗ απόκριση που επιστράφηκε αναφέρει ότι η λειτουργία ή το αποτέλεσμα χρειάζεται έλεγχο | Επόμενο βήμαΔιατηρήστε το αρχικό ID της λειτουργίας/εργασίας που επιστράφηκε, τις κεφαλίδες του αιτήματος και την απόκριση· συνεχίστε με τις υποστηριζόμενες αναγνώσεις αυτής της αρχικής λειτουργίας. Μην υποβάλετε ξανά το αίτημα δημιουργίας. |
Ailoot gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro
Ailoot Ultra google/gemini-3-pro-image
/v1/images
google/gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro, gemini-3-pro-image
google/gemini-3-pro-imageΤο Nano Banana Pro (Gemini 3 Pro Image) είναι το μοντέλο εικόνας της Google που καθοδηγείται από συλλογιστική για σύνθετο σχεδιασμό, μακέτες προϊόντων και πραγματολογικές οπτικοποιήσεις. Δέχεται κείμενο και εικόνες αναφοράς και παράγει εικόνες με κείμενο, με έξοδο 1K–4K και λεπτομερή δημιουργικό έλεγχο.
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Nano Banana Pro είναι το μοντέλο Gemini 3 Pro Image της Google για παραγωγή και επεξεργασία εικόνας καθοδηγούμενη από συλλογιστική. Ο κατασκευαστής θέτει σύνθετο γραφιστικό σχεδιασμό, μακέτες προϊόντων υψηλής πιστότητας και οπτικοποίηση πραγματολογικών δεδομένων στο επίκεντρο της προβλεπόμενης χρήσης του. Δέχεται κείμενο και εικόνες και παράγει εικόνα και κείμενο. Αυτή η ονομασμένη έκδοση εικόνας Pro βασίζεται στο Gemini 3 Pro, διατηρώντας το δικό της προφίλ εισόδου και δυνατοτήτων εργασιών εικόνας.
Το μοντέλο υποστηρίζει εικόνες 1K, 2K και 4K. Τα τεκμηριωμένα σχήματα περιλαμβάνουν 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 και 21:9. Μια τετράγωνη εικόνα 4K είναι 4096 × 4096· μια εικόνα 16:9 4K είναι 5504 × 3072. Επιλέξτε ανάλυση και αναλογία για το παραδοτέο που χρειάζεστε, είτε κατακόρυφη αφίσα, σκηνή προϊόντος ή πλατύ επεξηγηματικό γραφικό. Η επιλογή 0.5K και οι πρόσθετες ακραίες αναλογίες του Gemini 3.1 Flash Image δεν αποτελούν μέρος αυτού του πίνακα Pro.
Η απόδοση κειμένου υποστηρίζει καθαρή γραφή σε αφίσες, διαγράμματα και άλλα σχεδιασμένα στοιχεία. Για σύνθετο πληροφοριογράφημα, δώστε τα υποκείμενα στοιχεία, την ακριβή διατύπωση, ακολουθία ανάγνωσης και σχέση μεταξύ ετικετών και οπτικών στοιχείων. Διαχωρίστε τις πληροφορίες προς επικοινωνία από το επιθυμητό καλλιτεχνικό ύφος. Η Google συνιστά προετοιμασία κειμένου πρώτα και κατόπιν παραγωγή εικόνας που το περιέχει. Αυτό είναι ιδιαίτερα χρήσιμο όταν σύνθεση συνδυάζει τίτλο, διάγραμμα και πολλές σύντομες λεζάντες.
Η είσοδος πολλών εικόνων υποστηρίζει έως 14 αναφορές. Ο πίνακας δυνατοτήτων της Google περιγράφει έως έξι αναφορές αντικειμένων για πιστότητα, έως πέντε αναφορές χαρακτήρων για συνέπεια και έως τρεις αναφορές ύφους. Αυτοί οι ρόλοι βοηθούν στην προετοιμασία σύνθετου οπτικού στοιχείου: φωτογραφία προϊόντος ορίζει εμφάνιση, χωριστή εικόνα καθορίζει περιβάλλον και μια εικόνα ύφους καθοδηγεί την αισθητική απόδοση. Πείτε στο μοντέλο ποιες λεπτομέρειες είναι δεσμευτικές και ποιες αναφορές παρέχουν έμπνευση αντί να του ζητάτε αδιάκριτο συνδυασμό κάθε ορατού χαρακτηριστικού.
Η τεκμηρίωση μέσω Google Search μπορεί να παρέχει πληροφορίες πραγματικού κόσμου για πραγματολογική οπτικοποίηση ή σκηνή που λαμβάνει υπόψη τις τρέχουσες συνθήκες. Η ροή εικόνας Pro τεκμηριώνει τη χρήση πηγών του ιστού· η επέκταση Image Search τεκμηριώνεται ειδικά για Nano Banana 2.1 και Gemini 3.1 Flash Image. Για γραφικό δεδομένων, δώστε τις τιμές που σκοπεύετε να εμφανίσετε ή ζητήστε τεκμηριωμένες πληροφορίες στη ροή του κατασκευαστή και έπειτα ορίστε ρητά σχέση, ετικέτες και διάταξη. Η παραγωγή που αξιοποιεί πληροφορίες αναζήτησης εξακολουθεί να παράγει εικόνα προς έλεγχο, όχι υποκατάστατο ελέγχου των απεικονιζόμενων στοιχείων.
Η συλλογιστική υποστηρίζει τη σύνθεση πολύπλοκης προτροπής πριν την τελική απόδοση. Ο οδηγός εικόνας περιγράφει ενδιάμεσες εικόνες που χρησιμοποιούνται για δοκιμή σύνθεσης και λογικής, διακριτές από το τελικό παραδοτέο. Μη μεταφέρετε τον πίνακα ελέγχων minimal/high του Nano Banana 2 ή τον πίνακα προεπιλογής medium του Nano Banana 2.1 σε αυτή την έκδοση Pro. Για απαιτητικό σχεδιασμό, δώστε πλήρη περιγραφή με οπτική ιεραρχία, απαιτούμενες σχέσεις αντικειμένων και στοιχεία που πρέπει να επιβιώσουν μεταγενέστερων επεξεργασιών.
Η κάρτα μοντέλου περιγράφει ουσιαστικούς εναπομένοντες περιορισμούς: πολύ μικρό κείμενο και μεγάλα αποσπάσματα μπορεί να αποδίδονται ανεπαρκώς, η εμφάνιση χαρακτήρα μπορεί να αλλάζει μεταξύ αναφοράς και αποτελέσματος και επεξεργασίες με μάσκα ή πρόχειρο σκίτσο μπορεί να ακολουθούν μόνο εν μέρει την οδηγία ή να αφήνουν σημάδια. Μπορεί επίσης να συγχέει αριστερά και δεξιά ή να αντιγράφει στοιχείο πηγής στη νέα σύνθεση. Για αναθεώρηση προϊόντος, δηλώστε ρητά διατηρούμενη γεωμετρία και ετικέτες και επιθεωρήστε την επεξεργασμένη περιοχή· για διάγραμμα, συγκρίνετε κατεύθυνση βελών και σχετικές θέσεις αντικειμένων.
Ο τρέχων πίνακας API δίνει όριο εισόδου 65,536 token και όριο εξόδου 32,768 token. Υποστηρίζονται παραγωγή εικόνας, σκέψη, τεκμηρίωση μέσω αναζήτησης και μαζική επεξεργασία· παραγωγή ήχου, κλήση συναρτήσεων, εκτέλεση κώδικα, προσωρινή αποθήκευση, δομημένες έξοδοι, αναζήτηση αρχείων, URL context και Live API δεν υποστηρίζονται. Η εργασία εικόνας δεν δέχεται ούτε ήχο ούτε βίντεο ως είσοδο σε αυτό το προφίλ. Οι παραγόμενες εικόνες περιλαμβάνουν SynthID και ένας ζητούμενος αριθμός εικόνων εξόδου δεν ακολουθείται πάντα ακριβώς.
Μια πρακτική περιγραφή προϊόντος μπορεί να συνδυάζει εικόνα προϊόντος, αναφορά φωτισμού και τον ακριβή τίτλο: «Διατήρησε τις αναλογίες και τη γραφή του προϊόντος, παρουσίασέ το σε ανοιχτόχρωμη πέτρινη επιφάνεια κάτω από απαλό πλευρικό φως και άφησε το επάνω τρίτο καθαρό για τον παρεχόμενο τίτλο». Για πραγματολογικό διάγραμμα, προσδιορίστε κάθε οντότητα και σύνδεση και δώστε τις εγκεκριμένες ετικέτες. Βελτιώστε το αποτέλεσμα σε συνομιλία ονομάζοντας μία αλλαγή και τα χαρακτηριστικά προς διατήρηση, κρατώντας την επιλεγμένη εικόνα και το επεξηγηματικό της κείμενο μαζί ως σχεδιαστικό παραδοτέο.
POST /v1/chat/completionstexttext| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια google/gemini-3-pro-image | Προεπιλογή— |
Πεδίο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.
Το μήκος συμφραζομένων δεν είναι ανώτατο όριο εξόδου.
Ένα αρχείο κειμένου μπορεί να παρέχει αυτούσιο κείμενο· οι είσοδοι εικόνας/ήχου/αντικειμένων αρχείων χρειάζονται ακριβή αντιστοίχιση.
Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Πίνακας χρεώσεων | 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: Nano Banana Pro (Gemini 3 Pro Image) · Προεπιλεγμένη διαμόρφωση | Συνθήκες χρέωσηςΠροεπιλεγμένη διαμόρφωση | Χρέωση Είσοδος · 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 δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "google/gemini-3-pro-image", "messages": [{"role": "user", "content": "Explain the difference between an observation and a hypothesis in three sentences."}]}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nfor x in r.get("choices",[]):\n if x.get("message",{}).get("content"): print(x["message"]["content"])\nPY_RESULT\nfrom openai import OpenAI\nimport os\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.chat.completions.create(model='google/gemini-3-pro-image',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}])\nimport base64, json\nfrom pathlib import Path\n\ndef save_result(data, stem="result"):\n # Keep every field, including usage, IDs, reasoning and tool requests.\n Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")\n print(json.dumps(data, ensure_ascii=False, indent=2))\n def save_blob(encoded, suffix, label):\n raw = base64.b64decode(encoded, altchars=b"-_", validate=True)\n 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\n file = Path(stem + "-" + label + "." + ext)\n file.write_bytes(raw)\n print("Saved", file)\n for index, block in enumerate(data.get("content") or []):\n print("Content", index, json.dumps(block, ensure_ascii=False))\n for choice in data.get("choices") or []:\n print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))\n for index, item in enumerate(data.get("output") or []):\n print("Output", index, json.dumps(item, ensure_ascii=False))\n if item.get("type") == "image_generation_call" and item.get("result"):\n save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))\n for ci, candidate in enumerate(data.get("candidates") or []):\n for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):\n print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))\n blob = part.get("inlineData") or part.get("inline_data")\n if blob and blob.get("data"):\n mime = blob.get("mimeType") or blob.get("mime_type")\n suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")\n save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))\n\nsave_result(result.to_dict(mode="json"))\nfrom openai import OpenAI\nimport os\nfrom pathlib import Path\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nimport base64, json\nfrom pathlib import Path\n\ndef save_result(data, stem="result"):\n # Keep every field, including usage, IDs, reasoning and tool requests.\n Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")\n print(json.dumps(data, ensure_ascii=False, indent=2))\n def save_blob(encoded, suffix, label):\n raw = base64.b64decode(encoded, altchars=b"-_", validate=True)\n 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\n file = Path(stem + "-" + label + "." + ext)\n file.write_bytes(raw)\n print("Saved", file)\n for index, block in enumerate(data.get("content") or []):\n print("Content", index, json.dumps(block, ensure_ascii=False))\n for choice in data.get("choices") or []:\n print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))\n for index, item in enumerate(data.get("output") or []):\n print("Output", index, json.dumps(item, ensure_ascii=False))\n if item.get("type") == "image_generation_call" and item.get("result"):\n save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))\n for ci, candidate in enumerate(data.get("candidates") or []):\n for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):\n print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))\n blob = part.get("inlineData") or part.get("inline_data")\n if blob and blob.get("data"):\n mime = blob.get("mimeType") or blob.get("mime_type")\n suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")\n save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))\n\nwith client.chat.completions.stream(model='google/gemini-3-pro-image',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) as stream:\n with Path("stream-events.jsonl").open("w",encoding="utf-8") as log:\n for event in stream:\n payload=event.to_dict(mode="json")\n log.write(json.dumps(payload,ensure_ascii=False)+"\\n"); log.flush()\n print(json.dumps(payload,ensure_ascii=False))\n final=stream.get_final_completion()\n save_result(final.to_dict(mode="json"),"stream-result")\njson ή 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 gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro
Ailoot Ultra google/gemini-3-pro-image
/v1/images
google/gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro, gemini-3-pro-image
google/gemini-3-pro-imageΤο Nano Banana Pro (Gemini 3 Pro Image) είναι το μοντέλο εικόνας της Google που καθοδηγείται από συλλογιστική για σύνθετο σχεδιασμό, μακέτες προϊόντων και πραγματολογικές οπτικοποιήσεις. Δέχεται κείμενο και εικόνες αναφοράς και παράγει εικόνες με κείμενο, με έξοδο 1K–4K και λεπτομερή δημιουργικό έλεγχο.
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Nano Banana Pro είναι το μοντέλο Gemini 3 Pro Image της Google για παραγωγή και επεξεργασία εικόνας καθοδηγούμενη από συλλογιστική. Ο κατασκευαστής θέτει σύνθετο γραφιστικό σχεδιασμό, μακέτες προϊόντων υψηλής πιστότητας και οπτικοποίηση πραγματολογικών δεδομένων στο επίκεντρο της προβλεπόμενης χρήσης του. Δέχεται κείμενο και εικόνες και παράγει εικόνα και κείμενο. Αυτή η ονομασμένη έκδοση εικόνας Pro βασίζεται στο Gemini 3 Pro, διατηρώντας το δικό της προφίλ εισόδου και δυνατοτήτων εργασιών εικόνας.
Το μοντέλο υποστηρίζει εικόνες 1K, 2K και 4K. Τα τεκμηριωμένα σχήματα περιλαμβάνουν 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 και 21:9. Μια τετράγωνη εικόνα 4K είναι 4096 × 4096· μια εικόνα 16:9 4K είναι 5504 × 3072. Επιλέξτε ανάλυση και αναλογία για το παραδοτέο που χρειάζεστε, είτε κατακόρυφη αφίσα, σκηνή προϊόντος ή πλατύ επεξηγηματικό γραφικό. Η επιλογή 0.5K και οι πρόσθετες ακραίες αναλογίες του Gemini 3.1 Flash Image δεν αποτελούν μέρος αυτού του πίνακα Pro.
Η απόδοση κειμένου υποστηρίζει καθαρή γραφή σε αφίσες, διαγράμματα και άλλα σχεδιασμένα στοιχεία. Για σύνθετο πληροφοριογράφημα, δώστε τα υποκείμενα στοιχεία, την ακριβή διατύπωση, ακολουθία ανάγνωσης και σχέση μεταξύ ετικετών και οπτικών στοιχείων. Διαχωρίστε τις πληροφορίες προς επικοινωνία από το επιθυμητό καλλιτεχνικό ύφος. Η Google συνιστά προετοιμασία κειμένου πρώτα και κατόπιν παραγωγή εικόνας που το περιέχει. Αυτό είναι ιδιαίτερα χρήσιμο όταν σύνθεση συνδυάζει τίτλο, διάγραμμα και πολλές σύντομες λεζάντες.
Η είσοδος πολλών εικόνων υποστηρίζει έως 14 αναφορές. Ο πίνακας δυνατοτήτων της Google περιγράφει έως έξι αναφορές αντικειμένων για πιστότητα, έως πέντε αναφορές χαρακτήρων για συνέπεια και έως τρεις αναφορές ύφους. Αυτοί οι ρόλοι βοηθούν στην προετοιμασία σύνθετου οπτικού στοιχείου: φωτογραφία προϊόντος ορίζει εμφάνιση, χωριστή εικόνα καθορίζει περιβάλλον και μια εικόνα ύφους καθοδηγεί την αισθητική απόδοση. Πείτε στο μοντέλο ποιες λεπτομέρειες είναι δεσμευτικές και ποιες αναφορές παρέχουν έμπνευση αντί να του ζητάτε αδιάκριτο συνδυασμό κάθε ορατού χαρακτηριστικού.
Η τεκμηρίωση μέσω Google Search μπορεί να παρέχει πληροφορίες πραγματικού κόσμου για πραγματολογική οπτικοποίηση ή σκηνή που λαμβάνει υπόψη τις τρέχουσες συνθήκες. Η ροή εικόνας Pro τεκμηριώνει τη χρήση πηγών του ιστού· η επέκταση Image Search τεκμηριώνεται ειδικά για Nano Banana 2.1 και Gemini 3.1 Flash Image. Για γραφικό δεδομένων, δώστε τις τιμές που σκοπεύετε να εμφανίσετε ή ζητήστε τεκμηριωμένες πληροφορίες στη ροή του κατασκευαστή και έπειτα ορίστε ρητά σχέση, ετικέτες και διάταξη. Η παραγωγή που αξιοποιεί πληροφορίες αναζήτησης εξακολουθεί να παράγει εικόνα προς έλεγχο, όχι υποκατάστατο ελέγχου των απεικονιζόμενων στοιχείων.
Η συλλογιστική υποστηρίζει τη σύνθεση πολύπλοκης προτροπής πριν την τελική απόδοση. Ο οδηγός εικόνας περιγράφει ενδιάμεσες εικόνες που χρησιμοποιούνται για δοκιμή σύνθεσης και λογικής, διακριτές από το τελικό παραδοτέο. Μη μεταφέρετε τον πίνακα ελέγχων minimal/high του Nano Banana 2 ή τον πίνακα προεπιλογής medium του Nano Banana 2.1 σε αυτή την έκδοση Pro. Για απαιτητικό σχεδιασμό, δώστε πλήρη περιγραφή με οπτική ιεραρχία, απαιτούμενες σχέσεις αντικειμένων και στοιχεία που πρέπει να επιβιώσουν μεταγενέστερων επεξεργασιών.
Η κάρτα μοντέλου περιγράφει ουσιαστικούς εναπομένοντες περιορισμούς: πολύ μικρό κείμενο και μεγάλα αποσπάσματα μπορεί να αποδίδονται ανεπαρκώς, η εμφάνιση χαρακτήρα μπορεί να αλλάζει μεταξύ αναφοράς και αποτελέσματος και επεξεργασίες με μάσκα ή πρόχειρο σκίτσο μπορεί να ακολουθούν μόνο εν μέρει την οδηγία ή να αφήνουν σημάδια. Μπορεί επίσης να συγχέει αριστερά και δεξιά ή να αντιγράφει στοιχείο πηγής στη νέα σύνθεση. Για αναθεώρηση προϊόντος, δηλώστε ρητά διατηρούμενη γεωμετρία και ετικέτες και επιθεωρήστε την επεξεργασμένη περιοχή· για διάγραμμα, συγκρίνετε κατεύθυνση βελών και σχετικές θέσεις αντικειμένων.
Ο τρέχων πίνακας API δίνει όριο εισόδου 65,536 token και όριο εξόδου 32,768 token. Υποστηρίζονται παραγωγή εικόνας, σκέψη, τεκμηρίωση μέσω αναζήτησης και μαζική επεξεργασία· παραγωγή ήχου, κλήση συναρτήσεων, εκτέλεση κώδικα, προσωρινή αποθήκευση, δομημένες έξοδοι, αναζήτηση αρχείων, URL context και Live API δεν υποστηρίζονται. Η εργασία εικόνας δεν δέχεται ούτε ήχο ούτε βίντεο ως είσοδο σε αυτό το προφίλ. Οι παραγόμενες εικόνες περιλαμβάνουν SynthID και ένας ζητούμενος αριθμός εικόνων εξόδου δεν ακολουθείται πάντα ακριβώς.
Μια πρακτική περιγραφή προϊόντος μπορεί να συνδυάζει εικόνα προϊόντος, αναφορά φωτισμού και τον ακριβή τίτλο: «Διατήρησε τις αναλογίες και τη γραφή του προϊόντος, παρουσίασέ το σε ανοιχτόχρωμη πέτρινη επιφάνεια κάτω από απαλό πλευρικό φως και άφησε το επάνω τρίτο καθαρό για τον παρεχόμενο τίτλο». Για πραγματολογικό διάγραμμα, προσδιορίστε κάθε οντότητα και σύνδεση και δώστε τις εγκεκριμένες ετικέτες. Βελτιώστε το αποτέλεσμα σε συνομιλία ονομάζοντας μία αλλαγή και τα χαρακτηριστικά προς διατήρηση, κρατώντας την επιλεγμένη εικόνα και το επεξηγηματικό της κείμενο μαζί ως σχεδιαστικό παραδοτέο.
POST /v1/images/generationstext, imageimage| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια google/gemini-3-pro-image | Προεπιλογή— |
Πεδίο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}
Οι εμφανιζόμενες τιμές χρησιμοποιούνται για την εκτίμηση του κόστους πριν από την παραγωγή. Η τελική χρέωση υπολογίζεται από το κόστος που καταγράφηκε για την αρχική παραγωγή. Η μετρημένη διάρκεια της εξόδου και οι προβλεπόμενες ποσότητες δεν αποτελούν την τελική χρεώσιμη ποσότητα.
Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Πίνακας χρεώσεων | Προβλεπόμενη ποσότητα | Χρέωση |
|---|---|---|---|
| ΔιαμόρφωσηΒασικές χρεώσεις token | Πίνακας χρεώσεωνΒασική χρέωση | Προβλεπόμενη ποσότητα— | Χρέωση Είσοδος · Token εισόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Έξοδος · Token εξόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα · Εκτίμηση μόνο για σύγκριση — / 1K token |
| ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίας | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία | Χρέωση Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $0.98304 εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή. |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'google/gemini-3-pro-image', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nΚατεβάστε κάθε εικόνα που επιστρέφεται ή αποθηκεύστε το περιεχόμενο Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nΑποθηκεύστε κάθε ολοκληρωμένη εικόνα· ανακτήστε κάθε URL που επιστρέφεται ή αποκωδικοποιήστε το περιεχόμενο Base64.
Διατηρήστε ολόκληρη την απόκριση και τις κεφαλίδες, κάθε πραγματικό αποτέλεσμα εξόδου, τα αρχικά αναγνωριστικά που επιστράφηκαν και όλα τα πεδία χρήσης. Ανακτήστε την αρχική λειτουργία χωρίς να υποβάλετε ξανά αίτημα δημιουργίας.
Διατηρήστε το X-Client-Request-ID που επιστράφηκε για τη συμφωνία των εγγραφών. Διαβάστε μόνο πραγματικές τιμές task_id/asset_id που επιστράφηκαν ή τη βιβλιοθήκη πολυμέσων που σας ανήκει· μην κατασκευάσετε ποτέ URL εργασίας από το ID της λειτουργίας και μην υποβάλετε ποτέ ξανά αίτημα δημιουργίας.
| Πεδίο | Τύπος |
|---|---|
Πεδίοcreated | Τύπος |
Πεδίοdata[].url | Τύπος |
Πεδίοdata[].b64_json | Τύπος |
Πεδίοusage | Τύπος |
Ailoot gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro
Ailoot Ultra google/gemini-3-pro-image
/v1/images
google/gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro, gemini-3-pro-image
google/gemini-3-pro-imageΤο Nano Banana Pro (Gemini 3 Pro Image) είναι το μοντέλο εικόνας της Google που καθοδηγείται από συλλογιστική για σύνθετο σχεδιασμό, μακέτες προϊόντων και πραγματολογικές οπτικοποιήσεις. Δέχεται κείμενο και εικόνες αναφοράς και παράγει εικόνες με κείμενο, με έξοδο 1K–4K και λεπτομερή δημιουργικό έλεγχο.
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Nano Banana Pro είναι το μοντέλο Gemini 3 Pro Image της Google για παραγωγή και επεξεργασία εικόνας καθοδηγούμενη από συλλογιστική. Ο κατασκευαστής θέτει σύνθετο γραφιστικό σχεδιασμό, μακέτες προϊόντων υψηλής πιστότητας και οπτικοποίηση πραγματολογικών δεδομένων στο επίκεντρο της προβλεπόμενης χρήσης του. Δέχεται κείμενο και εικόνες και παράγει εικόνα και κείμενο. Αυτή η ονομασμένη έκδοση εικόνας Pro βασίζεται στο Gemini 3 Pro, διατηρώντας το δικό της προφίλ εισόδου και δυνατοτήτων εργασιών εικόνας.
Το μοντέλο υποστηρίζει εικόνες 1K, 2K και 4K. Τα τεκμηριωμένα σχήματα περιλαμβάνουν 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 και 21:9. Μια τετράγωνη εικόνα 4K είναι 4096 × 4096· μια εικόνα 16:9 4K είναι 5504 × 3072. Επιλέξτε ανάλυση και αναλογία για το παραδοτέο που χρειάζεστε, είτε κατακόρυφη αφίσα, σκηνή προϊόντος ή πλατύ επεξηγηματικό γραφικό. Η επιλογή 0.5K και οι πρόσθετες ακραίες αναλογίες του Gemini 3.1 Flash Image δεν αποτελούν μέρος αυτού του πίνακα Pro.
Η απόδοση κειμένου υποστηρίζει καθαρή γραφή σε αφίσες, διαγράμματα και άλλα σχεδιασμένα στοιχεία. Για σύνθετο πληροφοριογράφημα, δώστε τα υποκείμενα στοιχεία, την ακριβή διατύπωση, ακολουθία ανάγνωσης και σχέση μεταξύ ετικετών και οπτικών στοιχείων. Διαχωρίστε τις πληροφορίες προς επικοινωνία από το επιθυμητό καλλιτεχνικό ύφος. Η Google συνιστά προετοιμασία κειμένου πρώτα και κατόπιν παραγωγή εικόνας που το περιέχει. Αυτό είναι ιδιαίτερα χρήσιμο όταν σύνθεση συνδυάζει τίτλο, διάγραμμα και πολλές σύντομες λεζάντες.
Η είσοδος πολλών εικόνων υποστηρίζει έως 14 αναφορές. Ο πίνακας δυνατοτήτων της Google περιγράφει έως έξι αναφορές αντικειμένων για πιστότητα, έως πέντε αναφορές χαρακτήρων για συνέπεια και έως τρεις αναφορές ύφους. Αυτοί οι ρόλοι βοηθούν στην προετοιμασία σύνθετου οπτικού στοιχείου: φωτογραφία προϊόντος ορίζει εμφάνιση, χωριστή εικόνα καθορίζει περιβάλλον και μια εικόνα ύφους καθοδηγεί την αισθητική απόδοση. Πείτε στο μοντέλο ποιες λεπτομέρειες είναι δεσμευτικές και ποιες αναφορές παρέχουν έμπνευση αντί να του ζητάτε αδιάκριτο συνδυασμό κάθε ορατού χαρακτηριστικού.
Η τεκμηρίωση μέσω Google Search μπορεί να παρέχει πληροφορίες πραγματικού κόσμου για πραγματολογική οπτικοποίηση ή σκηνή που λαμβάνει υπόψη τις τρέχουσες συνθήκες. Η ροή εικόνας Pro τεκμηριώνει τη χρήση πηγών του ιστού· η επέκταση Image Search τεκμηριώνεται ειδικά για Nano Banana 2.1 και Gemini 3.1 Flash Image. Για γραφικό δεδομένων, δώστε τις τιμές που σκοπεύετε να εμφανίσετε ή ζητήστε τεκμηριωμένες πληροφορίες στη ροή του κατασκευαστή και έπειτα ορίστε ρητά σχέση, ετικέτες και διάταξη. Η παραγωγή που αξιοποιεί πληροφορίες αναζήτησης εξακολουθεί να παράγει εικόνα προς έλεγχο, όχι υποκατάστατο ελέγχου των απεικονιζόμενων στοιχείων.
Η συλλογιστική υποστηρίζει τη σύνθεση πολύπλοκης προτροπής πριν την τελική απόδοση. Ο οδηγός εικόνας περιγράφει ενδιάμεσες εικόνες που χρησιμοποιούνται για δοκιμή σύνθεσης και λογικής, διακριτές από το τελικό παραδοτέο. Μη μεταφέρετε τον πίνακα ελέγχων minimal/high του Nano Banana 2 ή τον πίνακα προεπιλογής medium του Nano Banana 2.1 σε αυτή την έκδοση Pro. Για απαιτητικό σχεδιασμό, δώστε πλήρη περιγραφή με οπτική ιεραρχία, απαιτούμενες σχέσεις αντικειμένων και στοιχεία που πρέπει να επιβιώσουν μεταγενέστερων επεξεργασιών.
Η κάρτα μοντέλου περιγράφει ουσιαστικούς εναπομένοντες περιορισμούς: πολύ μικρό κείμενο και μεγάλα αποσπάσματα μπορεί να αποδίδονται ανεπαρκώς, η εμφάνιση χαρακτήρα μπορεί να αλλάζει μεταξύ αναφοράς και αποτελέσματος και επεξεργασίες με μάσκα ή πρόχειρο σκίτσο μπορεί να ακολουθούν μόνο εν μέρει την οδηγία ή να αφήνουν σημάδια. Μπορεί επίσης να συγχέει αριστερά και δεξιά ή να αντιγράφει στοιχείο πηγής στη νέα σύνθεση. Για αναθεώρηση προϊόντος, δηλώστε ρητά διατηρούμενη γεωμετρία και ετικέτες και επιθεωρήστε την επεξεργασμένη περιοχή· για διάγραμμα, συγκρίνετε κατεύθυνση βελών και σχετικές θέσεις αντικειμένων.
Ο τρέχων πίνακας API δίνει όριο εισόδου 65,536 token και όριο εξόδου 32,768 token. Υποστηρίζονται παραγωγή εικόνας, σκέψη, τεκμηρίωση μέσω αναζήτησης και μαζική επεξεργασία· παραγωγή ήχου, κλήση συναρτήσεων, εκτέλεση κώδικα, προσωρινή αποθήκευση, δομημένες έξοδοι, αναζήτηση αρχείων, URL context και Live API δεν υποστηρίζονται. Η εργασία εικόνας δεν δέχεται ούτε ήχο ούτε βίντεο ως είσοδο σε αυτό το προφίλ. Οι παραγόμενες εικόνες περιλαμβάνουν SynthID και ένας ζητούμενος αριθμός εικόνων εξόδου δεν ακολουθείται πάντα ακριβώς.
Μια πρακτική περιγραφή προϊόντος μπορεί να συνδυάζει εικόνα προϊόντος, αναφορά φωτισμού και τον ακριβή τίτλο: «Διατήρησε τις αναλογίες και τη γραφή του προϊόντος, παρουσίασέ το σε ανοιχτόχρωμη πέτρινη επιφάνεια κάτω από απαλό πλευρικό φως και άφησε το επάνω τρίτο καθαρό για τον παρεχόμενο τίτλο». Για πραγματολογικό διάγραμμα, προσδιορίστε κάθε οντότητα και σύνδεση και δώστε τις εγκεκριμένες ετικέτες. Βελτιώστε το αποτέλεσμα σε συνομιλία ονομάζοντας μία αλλαγή και τα χαρακτηριστικά προς διατήρηση, κρατώντας την επιλεγμένη εικόνα και το επεξηγηματικό της κείμενο μαζί ως σχεδιαστικό παραδοτέο.
POST /v1/messagestextjson, sse| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια google/gemini-3-pro-image | Προεπιλογή— |
Πεδίοmessages | Τύποςmessage[] | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοmessages[].role | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια user, assistant | Προεπιλογή— |
Πεδίοmessages[].content | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοmax_tokens | Τύποςinteger | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοstream | Τύποςboolean | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογήfalse |
Κείμενο · Κείμενο UTF-8
Συμβολοσειρά messages[].content
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηmodel, messages, max_tokens |
Παράμετροςoptional_controls | Σύμβασηstream |
Παράμετροςmaterial_types | Σύμβασηtext |
Παράμετροςtext_file_material | ΣύμβασηΔιαβάστε το πραγματικό έγγραφο UTF-8 και τοποθετήστε το κείμενό του στην υποδεικνυόμενη συμβολοσειρά εισόδου ή περιεχομένου του μηνύματος. |
Κύκλος ζωής: synchronous_or_streamed
Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Πίνακας χρεώσεων | 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 δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
{\n "model": "google/gemini-3-pro-image",\n "max_tokens": 128,\n "messages": [\n {\n "role": "user",\n "content": "Summarize the incident report."\n }\n ],\n "stream": false\n}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 document}"\nexport AILOOT_TEXT_FILE\npython3 - <<'PY_REQUEST'\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'google/gemini-3-pro-image', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nPath('request.json').write_text(json.dumps(payload, ensure_ascii=False), encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/messages \\\n -H "x-api-key: $AILOOT_API_KEY" -H 'anthropic-version: 2023-06-01' -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nPY_RESULT\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'google/gemini-3-pro-image', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nfrom urllib.request import Request, urlopen\nfrom urllib.error import HTTPError\n\napi_key = os.environ['AILOOT_API_KEY']\nif not api_key.strip():\n raise SystemExit('Set AILOOT_API_KEY before making a request')\nheaders = {'x-api-key': 'PLACEHOLDER_KEY', 'anthropic-version': '2023-06-01', 'Content-Type': 'application/json'}\nheaders['x-api-key'] = api_key\nrequest = Request('https://api.ailoot.ai/v1/messages', data=json.dumps(payload, ensure_ascii=False).encode('utf-8'), headers=headers, method='POST')\ntry:\n with urlopen(request, timeout=120) as response:\n raw = response.read()\n Path('response-headers.txt').write_text(str(response.headers), encoding='utf-8')\nexcept HTTPError as error:\n Path('result.json').write_bytes(error.read())\n Path('response-headers.txt').write_text(str(error.headers), encoding='utf-8')\n raise\nPath('result.json').write_bytes(raw)\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nJSON ή SSE
Διατηρήστε κάθε πλήρη απάντηση, αρχείο και τμήμα περιεχομένου που επιστρέφεται.
Διατηρήστε όλα τα μπλοκ περιεχομένου, τις υπογραφές συλλογιστικής και τα πραγματικά ID χρήσης εργαλείων. Συνθέστε όλες τις διαφορικές ενημερώσεις μπλοκ SSE· το πρώτο μπλοκ κειμένου δεν είναι η πλήρης έξοδος.
Διατηρήστε τα ID αιτήματος/απάντησης και τις κεφαλίδες. Δεν παρέχεται γενικό URL ανάκτησης εργασιών κειμένου.
| Πεδίο | Τύπος |
|---|---|
Πεδίοid | Τύποςstring |
Πεδίοmodel | Τύποςstring |
Πεδίοcontent[] | Τύποςtext|thinking|tool_use|other content block |
Πεδίοstop_reason | Τύποςstring|null |
Πεδίοusage | Τύποςobject |
| Απάντηση | Συνθήκη | Επόμενο βήμα |
|---|---|---|
Απάντηση400 · invalid_request_error | ΣυνθήκηΜη έγκυρα υποχρεωτικά πεδία, μη έγκυρη αναπαράσταση υλικού ή μη έγκυρη τιμή παραμέτρου | Επόμενο βήμαΔιορθώστε τα υποδεικνυόμενα πεδία πριν από νέο αίτημα δημιουργίας. |
Ailoot gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro
Ailoot Ultra google/gemini-3-pro-image
/v1/images
google/gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro, gemini-3-pro-image
Τεχνικό παράδειγμα στα αγγλικά
Visualize a supplied packaging cycle\n\nCreate one landscape explanatory graphic showing this packaging return cycle: customer returns an empty jar, store inspects it, accepted jars are washed, clean jars are refilled. Use four large illustrated stages connected clockwise. Add only these exact labels: 'RETURN', 'INSPECT', 'WASH', 'REFILL'. Make the arrow direction and stage order unmistakable.One landscape image with four labeled stages and arrows matching the supplied cycle.Inspect that arrows connect RETURN to INSPECT to WASH to REFILL in that order, with exact labels.