{ "aboutHtml": "

Το Recraft V4 είναι το βασικό μοντέλο raster στη γενιά V4 της Recraft. Ο κατασκευαστής τονίζει τη σχεδιαστική κρίση: ισορροπημένη σύνθεση, συνεκτικές χρωματικές σχέσεις και λεπτομέρεια που υποστηρίζει την οπτική πρόθεση. Μπορεί να δουλεύει με στυλιζαρισμένη εικονογράφηση, φωτογραφικές σκηνές και ιδέες γραφιστικού σχεδιασμού. Χρησιμοποιήστε το όταν η περιγραφή ζητά εικόνα που συνδυάζει αισθητικές επιλογές με ακρίβεια προτροπής, είτε εξερευνώντας διάθεση από σύντομη κατεύθυνση είτε ορίζοντας λεπτομερώς σκόπιμη διάταξη.

Ο συγκεκριμένος κωδικός μοντέλου είναι recraftv4. Η αναφορά παραγωγού αναφέρει έξοδο raster 1K σε WebP χωρίς απώλειες ή PNG. Μια τετράγωνη εικόνα είναι 1024 × 1024 pixel, το 16:9 είναι 1344 × 768 και το 2:3 είναι 832 × 1280· άλλες υποστηριζόμενες αναλογίες χρησιμοποιούν δικές τους διαστάσεις. Το V4 Pro είναι χωριστή έκδοση raster 2K, ενώ τα V4 Vector και Pro Vector επιστρέφουν επεξεργάσιμο SVG. Επιλέξτε τη συγκεκριμένη παραλλαγή V4 για το επιθυμητό παραδοτέο, αντί να συνδυάζετε αυτές τις διαφορετικές ιδιότητες εξόδου.

Ο οδηγός κατασκευαστή διακρίνει σύντομες ερμηνευτικές προτροπές από δομημένη δημιουργική κατεύθυνση. Μια σύντομη φράση μπορεί να αφήνει χώρο για εξερεύνηση μορφής, διάθεσης και κάδρου. Μια δομημένη περιγραφή μπορεί να ονομάζει θέμα, περιβάλλον, στάση, υλικό, δευτερεύοντα στοιχεία, φωτισμό και οπτική ιεραρχία. Για αφηγηματική εικονογράφηση, περιγράψτε ποδηλάτη που διασχίζει μικρή γέφυρα, τολμηρά απλοποιημένα σχήματα, θερμά ήπια χρώματα και καθαρή κίνηση από αριστερά προς τα δεξιά. Αυτές οι αποφάσεις περιεχομένου και σύνθεσης είναι πιο εφαρμόσιμες από μακρά λίστα άσχετων επιθέτων ύφους.

Το εύρος V4 περιλαμβάνει εικονογράφηση, εικόνες με όγκο και φωτορεαλιστικά οπτικά. Ο οδηγός συνιστά περιγραφή λογικής σχεδίασης για εικονογράφηση και υλικού, φωτός, κάμερας και βάθους για εικόνα που μοιάζει 3D. Η δεύτερη παραμένει οπτικό raster αντί για επεξεργάσιμο πλέγμα. Για ιδέα αφίσας ή συσκευασίας, δηλώστε ποιες λέξεις είναι κύριες, πού ανήκουν και πώς αλληλεπιδρούν εικόνα και τυπογραφία. Ο κατασκευαστής τονίζει ευανάγνωστο σύντομο και μεσαίου μήκους κείμενο· εξετάστε την πραγματική διατύπωση και διάταξη στην επιστρεφόμενη εικόνα πριν τη χρησιμοποιήσετε.

Η δημιουργία υποστηρίζει προτροπές έως 10,000 χαρακτήρες, τυχαίο seed, από μία έως έξι εξόδους, προτιμώμενα χρώματα και επιθυμητό χρώμα φόντου. Προαιρετικά συμβατά προσαρμοσμένα ύφη και εικόνες αναφοράς μπορούν να καθοδηγούν την οπτική απόδοση μέσω ευέλικτης ή ακριβούς αντιστοίχισης. Επιλέξτε καθαρή αναφορά ή σύνολο που ανήκει σε έναν οπτικό κόσμο και αφήστε την προτροπή να περιγράφει νέο θέμα και σκηνή. Δεν είναι εγγυημένη η χρωματική αντιστοίχιση αναφοράς και εξόδου, επομένως κρατήστε ρητή την απαιτούμενη παλέτα και συγκρίνετε το αποτέλεσμα μαζί της. Για δημιουργία με αναφορές ύφους, χρησιμοποιήστε μία έως δέκα εικόνες PNG, JPG ή WebP, έως 64 MB συνολικά και κάτω από 20 MB καθεμία. Κάθε αναφορά χρειάζεται μικρότερη πλευρά τουλάχιστον 256 pixel, μεγαλύτερη πλευρά έως 4,096 pixel και ανάλυση έως 16 megapixel. Χρησιμοποιήστε είτε αυτές τις αναφορές είτε ένα συμβατό αποθηκευμένο ύφος, χωρίς να τα συνδυάζετε στο ίδιο αίτημα.

Η τεκμηριωμένη λειτουργία εικόνας προς εικόνα συνδυάζει υπάρχουσα εικόνα και προτροπή, με ισχύ από 0 έως 1 που καθορίζει πόσο απομακρύνεται η νέα έξοδος από την πηγή. Δεν δέχεται ελέγχους ύφους V4 σε αυτή τη λειτουργία. Η τρέχουσα αναφορά δημιουργίας αποκλείει επίσης επιμελημένα ονόματα ύφους, negative_prompt, text_layout, artistic_level και no_text. Προετοιμάστε θετική περιγραφή επιθυμητού αποτελέσματος και αξιολογήστε το οπτικό μέσα στη σύνθεση στόχου. Το βασικό V4 παρέχει εστιασμένη σχεδιαστική ερμηνεία raster, με συγκεκριμένη έκδοση, μορφή και μέγεθος εξόδου. Για εικόνα προς εικόνα, δώστε PNG, JPG, WebP ή SVG κάτω από 20 MB, έως 16 megapixel, με αμφότερες τις πλευρές από 256 έως 4,096 pixel.

", "aboutText": "Το Recraft V4 είναι το βασικό μοντέλο raster στη γενιά V4 της Recraft. Ο κατασκευαστής τονίζει τη σχεδιαστική κρίση: ισορροπημένη σύνθεση, συνεκτικές χρωματικές σχέσεις και λεπτομέρεια που υποστηρίζει την οπτική πρόθεση. Μπορεί να δουλεύει με στυλιζαρισμένη εικονογράφηση, φωτογραφικές σκηνές και ιδέες γραφιστικού σχεδιασμού. Χρησιμοποιήστε το όταν η περιγραφή ζητά εικόνα που συνδυάζει αισθητικές επιλογές με ακρίβεια προτροπής, είτε εξερευνώντας διάθεση από σύντομη κατεύθυνση είτε ορίζοντας λεπτομερώς σκόπιμη διάταξη.\n\nΟ συγκεκριμένος κωδικός μοντέλου είναι recraftv4. Η αναφορά παραγωγού αναφέρει έξοδο raster 1K σε WebP χωρίς απώλειες ή PNG. Μια τετράγωνη εικόνα είναι 1024 × 1024 pixel, το 16:9 είναι 1344 × 768 και το 2:3 είναι 832 × 1280· άλλες υποστηριζόμενες αναλογίες χρησιμοποιούν δικές τους διαστάσεις. Το V4 Pro είναι χωριστή έκδοση raster 2K, ενώ τα V4 Vector και Pro Vector επιστρέφουν επεξεργάσιμο SVG. Επιλέξτε τη συγκεκριμένη παραλλαγή V4 για το επιθυμητό παραδοτέο, αντί να συνδυάζετε αυτές τις διαφορετικές ιδιότητες εξόδου.\n\nΟ οδηγός κατασκευαστή διακρίνει σύντομες ερμηνευτικές προτροπές από δομημένη δημιουργική κατεύθυνση. Μια σύντομη φράση μπορεί να αφήνει χώρο για εξερεύνηση μορφής, διάθεσης και κάδρου. Μια δομημένη περιγραφή μπορεί να ονομάζει θέμα, περιβάλλον, στάση, υλικό, δευτερεύοντα στοιχεία, φωτισμό και οπτική ιεραρχία. Για αφηγηματική εικονογράφηση, περιγράψτε ποδηλάτη που διασχίζει μικρή γέφυρα, τολμηρά απλοποιημένα σχήματα, θερμά ήπια χρώματα και καθαρή κίνηση από αριστερά προς τα δεξιά. Αυτές οι αποφάσεις περιεχομένου και σύνθεσης είναι πιο εφαρμόσιμες από μακρά λίστα άσχετων επιθέτων ύφους.\n\nΤο εύρος V4 περιλαμβάνει εικονογράφηση, εικόνες με όγκο και φωτορεαλιστικά οπτικά. Ο οδηγός συνιστά περιγραφή λογικής σχεδίασης για εικονογράφηση και υλικού, φωτός, κάμερας και βάθους για εικόνα που μοιάζει 3D. Η δεύτερη παραμένει οπτικό raster αντί για επεξεργάσιμο πλέγμα. Για ιδέα αφίσας ή συσκευασίας, δηλώστε ποιες λέξεις είναι κύριες, πού ανήκουν και πώς αλληλεπιδρούν εικόνα και τυπογραφία. Ο κατασκευαστής τονίζει ευανάγνωστο σύντομο και μεσαίου μήκους κείμενο· εξετάστε την πραγματική διατύπωση και διάταξη στην επιστρεφόμενη εικόνα πριν τη χρησιμοποιήσετε.\n\nΗ δημιουργία υποστηρίζει προτροπές έως 10,000 χαρακτήρες, τυχαίο seed, από μία έως έξι εξόδους, προτιμώμενα χρώματα και επιθυμητό χρώμα φόντου. Προαιρετικά συμβατά προσαρμοσμένα ύφη και εικόνες αναφοράς μπορούν να καθοδηγούν την οπτική απόδοση μέσω ευέλικτης ή ακριβούς αντιστοίχισης. Επιλέξτε καθαρή αναφορά ή σύνολο που ανήκει σε έναν οπτικό κόσμο και αφήστε την προτροπή να περιγράφει νέο θέμα και σκηνή. Δεν είναι εγγυημένη η χρωματική αντιστοίχιση αναφοράς και εξόδου, επομένως κρατήστε ρητή την απαιτούμενη παλέτα και συγκρίνετε το αποτέλεσμα μαζί της. Για δημιουργία με αναφορές ύφους, χρησιμοποιήστε μία έως δέκα εικόνες PNG, JPG ή WebP, έως 64 MB συνολικά και κάτω από 20 MB καθεμία. Κάθε αναφορά χρειάζεται μικρότερη πλευρά τουλάχιστον 256 pixel, μεγαλύτερη πλευρά έως 4,096 pixel και ανάλυση έως 16 megapixel. Χρησιμοποιήστε είτε αυτές τις αναφορές είτε ένα συμβατό αποθηκευμένο ύφος, χωρίς να τα συνδυάζετε στο ίδιο αίτημα.\n\nΗ τεκμηριωμένη λειτουργία εικόνας προς εικόνα συνδυάζει υπάρχουσα εικόνα και προτροπή, με ισχύ από 0 έως 1 που καθορίζει πόσο απομακρύνεται η νέα έξοδος από την πηγή. Δεν δέχεται ελέγχους ύφους V4 σε αυτή τη λειτουργία. Η τρέχουσα αναφορά δημιουργίας αποκλείει επίσης επιμελημένα ονόματα ύφους, negative_prompt, text_layout, artistic_level και no_text. Προετοιμάστε θετική περιγραφή επιθυμητού αποτελέσματος και αξιολογήστε το οπτικό μέσα στη σύνθεση στόχου. Το βασικό V4 παρέχει εστιασμένη σχεδιαστική ερμηνεία raster, με συγκεκριμένη έκδοση, μορφή και μέγεθος εξόδου. Για εικόνα προς εικόνα, δώστε PNG, JPG, WebP ή SVG κάτω από 20 MB, έως 16 megapixel, με αμφότερες τις πλευρές από 256 έως 4,096 pixel.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "16d0d90978b999f42d0ca7613eb4d324032621b4a47fd996fb581a3aae82b49a", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "el", "methods": [ { "html": "

•

Recraft: Recraft V4

Recraft /recraft/recraft-v4

Εισαγωγή

Το Recraft V4 δημιουργεί εικόνες raster 1K με έμφαση στη σύνθεση, τις χρωματικές σχέσεις και τη λεπτομερή δημιουργική κατεύθυνση. Καλύπτει εικονογράφηση, φωτορεαλιστικές σκηνές και ιδέες γραφιστικού σχεδιασμού, με προαιρετικές εισόδους ύφους και χωριστή ροή εικόνας προς εικόνα.

Αποδεκτές είσοδοι: Κείμενο · Εικόνες
Αποτελέσματα: Εικόνες

Σχετικά με το μοντέλο

Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.

Το Recraft V4 είναι το βασικό μοντέλο raster στη γενιά V4 της Recraft. Ο κατασκευαστής τονίζει τη σχεδιαστική κρίση: ισορροπημένη σύνθεση, συνεκτικές χρωματικές σχέσεις και λεπτομέρεια που υποστηρίζει την οπτική πρόθεση. Μπορεί να δουλεύει με στυλιζαρισμένη εικονογράφηση, φωτογραφικές σκηνές και ιδέες γραφιστικού σχεδιασμού. Χρησιμοποιήστε το όταν η περιγραφή ζητά εικόνα που συνδυάζει αισθητικές επιλογές με ακρίβεια προτροπής, είτε εξερευνώντας διάθεση από σύντομη κατεύθυνση είτε ορίζοντας λεπτομερώς σκόπιμη διάταξη.

Ο συγκεκριμένος κωδικός μοντέλου είναι recraftv4. Η αναφορά παραγωγού αναφέρει έξοδο raster 1K σε WebP χωρίς απώλειες ή PNG. Μια τετράγωνη εικόνα είναι 1024 × 1024 pixel, το 16:9 είναι 1344 × 768 και το 2:3 είναι 832 × 1280· άλλες υποστηριζόμενες αναλογίες χρησιμοποιούν δικές τους διαστάσεις. Το V4 Pro είναι χωριστή έκδοση raster 2K, ενώ τα V4 Vector και Pro Vector επιστρέφουν επεξεργάσιμο SVG. Επιλέξτε τη συγκεκριμένη παραλλαγή V4 για το επιθυμητό παραδοτέο, αντί να συνδυάζετε αυτές τις διαφορετικές ιδιότητες εξόδου.

Ο οδηγός κατασκευαστή διακρίνει σύντομες ερμηνευτικές προτροπές από δομημένη δημιουργική κατεύθυνση. Μια σύντομη φράση μπορεί να αφήνει χώρο για εξερεύνηση μορφής, διάθεσης και κάδρου. Μια δομημένη περιγραφή μπορεί να ονομάζει θέμα, περιβάλλον, στάση, υλικό, δευτερεύοντα στοιχεία, φωτισμό και οπτική ιεραρχία. Για αφηγηματική εικονογράφηση, περιγράψτε ποδηλάτη που διασχίζει μικρή γέφυρα, τολμηρά απλοποιημένα σχήματα, θερμά ήπια χρώματα και καθαρή κίνηση από αριστερά προς τα δεξιά. Αυτές οι αποφάσεις περιεχομένου και σύνθεσης είναι πιο εφαρμόσιμες από μακρά λίστα άσχετων επιθέτων ύφους.

Το εύρος V4 περιλαμβάνει εικονογράφηση, εικόνες με όγκο και φωτορεαλιστικά οπτικά. Ο οδηγός συνιστά περιγραφή λογικής σχεδίασης για εικονογράφηση και υλικού, φωτός, κάμερας και βάθους για εικόνα που μοιάζει 3D. Η δεύτερη παραμένει οπτικό raster αντί για επεξεργάσιμο πλέγμα. Για ιδέα αφίσας ή συσκευασίας, δηλώστε ποιες λέξεις είναι κύριες, πού ανήκουν και πώς αλληλεπιδρούν εικόνα και τυπογραφία. Ο κατασκευαστής τονίζει ευανάγνωστο σύντομο και μεσαίου μήκους κείμενο· εξετάστε την πραγματική διατύπωση και διάταξη στην επιστρεφόμενη εικόνα πριν τη χρησιμοποιήσετε.

Η δημιουργία υποστηρίζει προτροπές έως 10,000 χαρακτήρες, τυχαίο seed, από μία έως έξι εξόδους, προτιμώμενα χρώματα και επιθυμητό χρώμα φόντου. Προαιρετικά συμβατά προσαρμοσμένα ύφη και εικόνες αναφοράς μπορούν να καθοδηγούν την οπτική απόδοση μέσω ευέλικτης ή ακριβούς αντιστοίχισης. Επιλέξτε καθαρή αναφορά ή σύνολο που ανήκει σε έναν οπτικό κόσμο και αφήστε την προτροπή να περιγράφει νέο θέμα και σκηνή. Δεν είναι εγγυημένη η χρωματική αντιστοίχιση αναφοράς και εξόδου, επομένως κρατήστε ρητή την απαιτούμενη παλέτα και συγκρίνετε το αποτέλεσμα μαζί της. Για δημιουργία με αναφορές ύφους, χρησιμοποιήστε μία έως δέκα εικόνες PNG, JPG ή WebP, έως 64 MB συνολικά και κάτω από 20 MB καθεμία. Κάθε αναφορά χρειάζεται μικρότερη πλευρά τουλάχιστον 256 pixel, μεγαλύτερη πλευρά έως 4,096 pixel και ανάλυση έως 16 megapixel. Χρησιμοποιήστε είτε αυτές τις αναφορές είτε ένα συμβατό αποθηκευμένο ύφος, χωρίς να τα συνδυάζετε στο ίδιο αίτημα.

Η τεκμηριωμένη λειτουργία εικόνας προς εικόνα συνδυάζει υπάρχουσα εικόνα και προτροπή, με ισχύ από 0 έως 1 που καθορίζει πόσο απομακρύνεται η νέα έξοδος από την πηγή. Δεν δέχεται ελέγχους ύφους V4 σε αυτή τη λειτουργία. Η τρέχουσα αναφορά δημιουργίας αποκλείει επίσης επιμελημένα ονόματα ύφους, negative_prompt, text_layout, artistic_level και no_text. Προετοιμάστε θετική περιγραφή επιθυμητού αποτελέσματος και αξιολογήστε το οπτικό μέσα στη σύνθεση στόχου. Το βασικό V4 παρέχει εστιασμένη σχεδιαστική ερμηνεία raster, με συγκεκριμένη έκδοση, μορφή και μέγεθος εξόδου. Για εικόνα προς εικόνα, δώστε PNG, JPG, WebP ή SVG κάτω από 20 MB, έως 16 megapixel, με αμφότερες τις πλευρές από 256 έως 4,096 pixel.

Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι

Ailoot Ultra · Εικόνες POST /v1/images/generations

Είσοδος: text, image
Έξοδος: image
Μορφή εξόδου: Αρχείο εικόνας

Πεδίο	Τύπος	Απαίτηση	Τιμές και όρια	Προεπιλογή
Πεδίο`model`	Τύπος`string`	ΑπαίτησηΥποχρεωτικό	Τιμές και όρια recraft/recraft-v4	Προεπιλογή—
Πεδίο`prompt`	Τύπος`string`	ΑπαίτησηΥποχρεωτικό	Τιμές και όρια Ελάχιστο μήκος: 1	Προεπιλογή—
Πεδίο`n`	Τύπος`integer`	ΑπαίτησηΠροαιρετικό	Τιμές και όρια Ελάχιστο: 1 Μέγιστο: 6	Προεπιλογή—
Πεδίο`aspect_ratio`	Τύπος`string`	ΑπαίτησηΠροαιρετικό	Τιμές και όρια 1:1, 4:3, 3:4, 16:9, 9:16, auto	Προεπιλογή—
Πεδίο`input_references`	Τύπος`array`	ΑπαίτησηΠροαιρετικό	Τιμές και όρια Ελάχιστο πλήθος στοιχείων: 0 Μέγιστο πλήθος στοιχείων: 1	Προεπιλογή—

Συνδυασμοί υλικών εισόδου

Κείμενο σε εικόνα · Υποχρεωτικό: prompt

reference_guided_image · Υποχρεωτικό: prompt, actual image reference

Παράμετροι και κύκλος ζωής μεθόδου

Παράμετρος	Σύμβαση
Παράμετρος`content_type`	Σύμβασηapplication/json
Παράμετρος`required`	Σύμβασηmodel, prompt
Παράμετρος`material_types`	Σύμβασηtext, image
Παράμετρος`optional_controls`	Σύμβασηn, aspect_ratio, input_references
Παράμετρος`n`	Σύμβαση{"minimum":1,"maximum":6}
Παράμετρος`reference_images`	Σύμβαση{"minimum":0,"maximum":1,"source":"πραγματικό υλικό που παρείχε ο πελάτης"}
Παράμετρος`provider_specific_options`	ΣύμβασηΜόνο τα ακριβή αποθηκευμένα style/controls/text_layout της λίστας επιτρεπόμενων του τελικού σημείου· χωρίς εικαζόμενες δομές.

Εναλλακτικά ονόματα μεθόδου: /v1/images

Κύκλος ζωής: 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}

Το παράδειγμα μόνο με προτροπή διατηρεί την επίσημη δομή ImageGenerationRequest.

Διατηρήστε κάθε εικόνα που επιστρέφεται και ολόκληρη την απόκριση· η ποσότητα εξόδου είναι η πραγματική, όχι το ζητούμενο n.

Τιμολόγηση

Πώς υπολογίζεται η τελική χρέωση

Οι εμφανιζόμενες τιμές χρησιμοποιούνται για την εκτίμηση του κόστους πριν από την παραγωγή. Η τελική χρέωση υπολογίζεται από το κόστος που καταγράφηκε για την αρχική παραγωγή. Η μετρημένη διάρκεια της εξόδου και οι προβλεπόμενες ποσότητες δεν αποτελούν την τελική χρεώσιμη ποσότητα.

Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.

Γρήγορη λειτουργία: Δεν έχει οριστεί Όταν επιλέγεται η γρήγορη λειτουργία
Λειτουργία flex: Δεν έχει οριστεί Όταν επιλέγεται η λειτουργία flex
Μέγιστη προσπάθεια συλλογισμού: Δεν έχει οριστεί Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default

Εκτιμώμενες χρεώσεις για σύγκριση

Τιμές ανά διαμόρφωση

Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.

Διαμόρφωση	Πίνακας χρεώσεων	Προβλεπόμενη ποσότητα	Μονάδα τιμολόγησης	Χρέωση
ΔιαμόρφωσηΒασικές χρεώσεις token	Πίνακας χρεώσεωνΒασική χρέωση	Προβλεπόμενη ποσότητα—	Μονάδα τιμολόγησης—	Χρέωση Είσοδος · Token εισόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Έξοδος · Token εξόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα · Εκτίμηση μόνο για σύγκριση — / 1K token
ΔιαμόρφωσηUltra	Πίνακας χρεώσεων—	Προβλεπόμενη ποσότητα—	Μονάδα τιμολόγησηςανά εικόνα εξόδου	Χρέωση Έξοδος · εικόνα εξόδου · Εκτίμηση μόνο για σύγκριση $0.08 ανά εικόνα εξόδου
ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίας	Πίνακας χρεώσεων—	Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία	Μονάδα τιμολόγησης—	Χρέωση Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $0.08 εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή.

Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →

Στοιχεία τιμοκαταλόγου αναφοράς

Οι πίνακες αναφοράς του μοντέλου δεν αλλάζουν την επιλογή μεθόδου, τις εκτιμήσεις τιμής ή τις χρεώσεις. Οι εφαρμοζόμενες χρεώσεις χρησιμοποιούν τις τιμές της επιλεγμένης μεθόδου Ailoot.

Διαμορφώσεις τιμολόγησης εικόνων

Τιμές ανά διαμόρφωση

Διαμόρφωση	Συνθήκες χρέωσης	Χρέωση
ΔιαμόρφωσηΕικόνα εξόδου	Συνθήκες χρέωσηςΔεν δηλώνεται παραλλαγή τιμολόγησης.	Χρέωση Έξοδος · Εικόνα εξόδου $0.08 ανά εικόνα Οι ισοδύναμες καταχωρίσεις περιγράφουν την ίδια χρέωση· δεν προσθέτουν δεύτερη χρέωση.

Παραδείγματα αιτημάτων

Ailoot Ultra · Εικόνες

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': 'recraft/recraft-v4', '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

from 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\nrequest={'model': 'recraft/recraft-v4', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\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])\n

import 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": "recraft/recraft-v4", "prompt": "a red panda astronaut floating in space, studio lighting"};\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

Λήψη και αποθήκευση αποτελεσμάτων

Ailoot Ultra · Εικόνες

Κατεβάστε κάθε εικόνα που επιστρέφεται ή αποθηκεύστε το περιεχόμενο Base64

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα

Αποθηκεύστε κάθε ολοκληρωμένη εικόνα· ανακτήστε κάθε URL που επιστρέφεται ή αποκωδικοποιήστε το περιεχόμενο Base64.

Διατηρήστε κάθε στοιχείο δεδομένων και ολόκληρη τη χρήση· εξασφαλίστε ότι όλες οι πραγματικές εικόνες που επιστρέφονται σας ανήκουν και αποθηκεύστε τις. Χωρίς επινοημένα URL ή ID.

Αν χρειάζεται έλεγχος της αρχικής απάντησης

Αν το αποτέλεσμα παραγωγής ή επεξεργασίας εικόνας χρειάζεται έλεγχο, διατηρήστε το αρχικό 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 Ultra recraft/recraft-v4

Εναλλακτικές διαδρομές μεθόδων

/v1/images

Σχετικά ID μοντέλων

recraft/recraft-v4

", "method_identity": { "effective_request_model_id": "recraft/recraft-v4", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "recraft/recraft-v4", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|recraft%2Frecraft-v4", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Οι εμφανιζόμενες τιμές χρησιμοποιούνται για την εκτίμηση του κόστους πριν από την παραγωγή. Η τελική χρέωση υπολογίζεται από το κόστος που καταγράφηκε για την αρχική παραγωγή. Η μετρημένη διάρκεια της εξόδου και οι προβλεπόμενες ποσότητες δεν αποτελούν την τελική χρεώσιμη ποσότητα.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain every data item and complete usage; own and save all actual returned images. No invented URLs or IDs.", "errors": [ { "code": null, "condition": "Μη έγκυρα υποχρεωτικά πεδία, μη έγκυρη αναπαράσταση υλικού ή μη έγκυρη τιμή παραμέτρου", "http_status": 400, "recovery": "Διορθώστε τα υποδεικνυόμενα πεδία πριν από νέο αίτημα δημιουργίας.", "type": "invalid_request_error" }, { "code": null, "condition": "Η απόκριση που επιστράφηκε αναφέρει ότι η λειτουργία ή το αποτέλεσμα χρειάζεται έλεγχο", "http_status": null, "recovery": "Διατηρήστε το αρχικό ID της λειτουργίας/εργασίας που επιστράφηκε, τις κεφαλίδες του αιτήματος και την απόκριση· συνεχίστε με τις υποστηριζόμενες αναγνώσεις αυτής της αρχικής λειτουργίας. Μην υποβάλετε ξανά το αίτημα δημιουργίας.", "type": "server_error" } ], "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Αν το αποτέλεσμα παραγωγής ή επεξεργασίας εικόνας χρειάζεται έλεγχο, διατηρήστε το αρχικό operation_id/X-Client-Request-ID και τις πληροφορίες αποτελέσματος που επιστράφηκαν. Ανακτήστε τα υπάρχοντα αποτελέσματα που σας ανήκουν μέσω της βιβλιοθήκης πολυμέσων χρησιμοποιώντας πραγματικές τιμές task_id ή asset_id. Μην υποβάλετε ξανά το αίτημα παραγωγής/επεξεργασίας και μην κατασκευάσετε URL περιοδικού ελέγχου από το operation_id." }, "material_combinations": [ { "content_type": "application/json", "mode": "text_to_image", "required": [ "prompt" ] }, { "content_type": "application/json", "maximum_references": 1, "mode": "reference_guided_image", "required": [ "prompt", "actual image reference" ] } ], "outputs": { "all_results": "Διατηρήστε κάθε στοιχείο δεδομένων και ολόκληρη τη χρήση· εξασφαλίστε ότι όλες οι πραγματικές εικόνες που επιστρέφονται σας ανήκουν και αποθηκεύστε τις. Χωρίς επινοημένα URL ή ID.", "family": "image", "fields": [ { "description": null, "name": "created", "type": "integer" }, { "description": null, "name": "data[].url", "type": "string" }, { "description": null, "name": "data[].b64_json", "type": "base64 string" }, { "description": null, "name": "usage", "type": "object" } ], "format": "actual validated raster MIME" }, "parameters": [ { "availability": "source_interface", "enum": [ "recraft/recraft-v4" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "availability": "saved_exact_supplier_endpoint", "maximum": 6, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "availability": "saved_exact_supplier_endpoint", "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ], "enum_known": true, "name": "aspect_ratio", "required": false, "type": "string" }, { "availability": "saved_exact_supplier_endpoint", "items": { "image_url": { "url": "actual HTTP(S) image URL or base64 data URI" }, "type": "image_url" }, "maximum_items": 1, "minimum_items": 0, "name": "input_references", "required": false, "type": "array" } ], "request_schema": { "properties": { "aspect_ratio": { "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ], "type": "string" }, "input_references": { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 1, "type": "array" }, "model": { "enum": [ "recraft/recraft-v4" ], "type": "string" }, "n": { "maximum": 6, "minimum": 1, "type": "integer" }, "prompt": { "minLength": 1, "type": "string" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "body": { "model": "recraft/recraft-v4", "prompt": "a red panda astronaut floating in space, studio lighting" }, "content_type": "application/json", "parameter_source": "parameters + request_schema; no fabricated reference URL" } }, "hints": [ "Το παράδειγμα μόνο με προτροπή διατηρεί την επίσημη δομή ImageGenerationRequest.", "Διατηρήστε κάθε εικόνα που επιστρέφεται και ολόκληρη την απόκριση· η ποσότητα εξόδου είναι η πραγματική, όχι το ζητούμενο n." ], "input": { "content_type": "application/json", "material_types": [ "text", "image" ], "n": { "maximum": 6, "minimum": 1 }, "optional_controls": [ "n", "aspect_ratio", "input_references" ], "provider_specific_options": "Μόνο τα ακριβή αποθηκευμένα style/controls/text_layout της λίστας επιτρεπόμενων του τελικού σημείου· χωρίς εικαζόμενες δομές.", "reference_images": { "maximum": 1, "minimum": 0, "source": "πραγματικό υλικό που παρείχε ο πελάτης" }, "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "Το πραγματικό task_id που επιστράφηκε ή μια εγγραφή στη βιβλιοθήκη πολυμέσων", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "If an image generation or edit result requires a check, keep the original operation_id/X-Client-Request-ID and returned result information. Recover existing owned results through the media library using actual task_id or asset_id values. Do not resubmit the generation/edit request or construct a polling URL from operation_id." }, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [ "/v1/images" ], "operation_modes": [ "text_to_image", "reference_guided_image" ], "output": { "all_results": true, "family": "image", "format": "actual validated raster MIME", "result": "every actual owned URL or b64_json" } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quantity_basis": "actual returned output images", "quoted_unit": "per image output" }, "label": "Ultra", "units": [ { "amount": "0.08", "amount_unit": "usd_per_output_image", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per image output", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Εκτιμώμενο κόστος δημιουργίας", "units": [ { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "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': 'recraft/recraft-v4', '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\"