OpenAI: DALL·E 3
Το DALL·E 3 δημιουργεί εικόνες από γραπτή περιγραφή σκηνής. Χρησιμοποιήστε το ακριβές ID μοντέλου openai/dall-e-3 ή το ψευδώνυμό του dall-e-3 με τη μέθοδο δημιουργίας εικόνων και στη συνέχεια αποθηκεύστε κάθε επιστρεφόμενο URL εικόνας και το συνοδευτικό αποτέλεσμα. Ένα τεκμηριωμένο αρχικό αίτημα παράγει μία εικόνα 1024x1024 από κείμενο.
- Ailoot Ultra · Images
POST /v1/images/generationsopenai/dall-e-3 - Ailoot Ultra · Images
POST /v1/images/generationsdall-e-3
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το DALL·E 3 είναι το μοντέλο μετατροπής κειμένου σε εικόνα της OpenAI. Χρησιμοποιήστε γραπτή περιγραφή για να δημιουργήσετε εικονογράφηση, ιδέα σκηνής ή οπτική κατεύθυνση για ένα σχέδιο. Περιγράψτε στο prompt το θέμα, το περιβάλλον, τη σύνθεση, τον φωτισμό και την αισθητική απόδοση. Για παράδειγμα, μια περιγραφή ιδέας μπορεί να ζητά ένα ποδήλατο διανομής δίπλα σε ένα μικρό κατάστημα το σούρουπο, με θέα από τον δρόμο, σαφές θέμα στο προσκήνιο και συγκρατημένη χρωματική παλέτα.
Στείλτε POST /v1/images/generations με σώμα application/json. Το ακριβές δημόσιο ID μοντέλου είναι openai/dall-e-3· το επιτρεπόμενο ψευδώνυμο dall-e-3 επιλέγει την ίδια κάρτα μοντέλου. Η τεκμηριωμένη αρχική δομή παρέχει model, prompt, n:1 και size:"1024x1024". Το n είναι προαιρετικός ακέραιος και έχει προεπιλογή 1. Στείλτε stream:false ή παραλείψτε το stream για ολόκληρο το αποτέλεσμα JSON. Χρησιμοποιήστε μη κενό prompt κειμένου και εστιάστε αυτό το αίτημα σε μία πλήρη περιγραφή εικόνας. Η προσφερόμενη μέθοδος είναι δημιουργία εικόνας από κείμενο.
Διατυπώστε ρητά τις απαιτήσεις που έχουν σημασία για τη θέση χρήσης. Μια εκδοτική εικονογράφηση μπορεί να κατονομάζει την κεντρική ιδέα και τα αντικείμενα που την εκφράζουν. Μια ιδέα σκηνής μπορεί να ορίζει τη θέση της κάμερας, την ώρα της ημέρας και ποια μέρη της σύνθεσης χρειάζονται χώρο γύρω τους. Κρατήστε την ακριβή διατύπωση που πρέπει να εμφανιστεί στην εικόνα ξεχωριστή από τις περιγραφές της σκηνής και στη συνέχεια ελέγξτε τα αποδοσμένα γράμματα και την οπτική διάταξη πριν χρησιμοποιήσετε το επιλεγμένο αποτέλεσμα.
Η απάντηση δημιουργίας είναι JSON με χρονική σήμανση created και πίνακα data. Το τεκμηριωμένο στοιχείο αποτελέσματος περιλαμβάνει url και μπορεί να περιλαμβάνει revised_prompt, prompt_filter_results και content_filter_results. Διατηρήστε αυτά τα πεδία μαζί με ολόκληρη την απάντηση και κατεβάστε την εικόνα σε κάθε επιστρεφόμενο υπογεγραμμένο URL του Ailoot. Οι υπογεγραμμένοι σύνδεσμοι αρχείων του Ailoot ισχύουν για 24 ώρες από την έκδοσή τους. Κρατήστε το ακριβές επιστρεφόμενο URL, συμπεριλαμβανομένης της συμβολοσειράς ερωτήματός του, έως ότου αποθηκευτεί το αρχείο· προσδιορίστε τη μορφή της αποθηκευμένης εικόνας από την πραγματική απάντηση ή τα bytes του αρχείου.
Αντιμετωπίστε το επιστρεφόμενο αρχείο εικόνας ως το αξιοποιήσιμο σχεδιαστικό αρχείο και το JSON ως τη συνοδευτική εγγραφή δημιουργίας του. Ελέγξτε την εικόνα σε σχέση με την παρεχόμενη περιγραφή πριν την τοποθετήσετε σε σελίδα, παρουσίαση ή εφαρμογή. Αν η απάντηση είναι ελλιπής ή η έκβαση της αποστολής είναι αβέβαιη, διατηρήστε το αρχικό αναγνωριστικό αιτήματος και τις επιστρεφόμενες πληροφορίες κατά τον έλεγχο της υπάρχουσας προσπάθειας, αντί να δημιουργήσετε άλλη εικόνα αποκλειστικά για να ανακτήσετε το αποτέλεσμα που λείπει. Για να ανακτήσετε αποθηκευμένα αποτελέσματα, χρησιμοποιήστε το ίδιο κλειδί API για GET /v1/media/assets?family=image και ακολουθήστε κάθε next_cursor. Το ID του αρχείου εμφανίζεται σε κάθε επιστρεφόμενο URL /v1/media/assets/{asset_id}/content και στην εγγραφή του στη βιβλιοθήκη πολυμέσων. Διαβάστε το GET /v1/media/assets/{asset_id} για κάθε επιλεγμένη εγγραφή και κατεβάστε το ακριβές content_url της. Αν το αίτημα αρχείου επιστρέψει 404 με κωδικό link_expired, διαβάστε ξανά το ίδιο αρχείο για να λάβετε ανανεωμένο σύνδεσμο. Η ανανέωση συνδέσμου αρχείου δεν απαιτεί άλλο αίτημα δημιουργίας εικόνας.
Ailoot Ultra · Images POST /v1/images/generations openai/dall-e-3
openai/dall-e-3openai/dall-e-3dall-e-3
Εισαγωγή
Το DALL·E 3 δημιουργεί εικόνες από γραπτή περιγραφή σκηνής. Χρησιμοποιήστε το ακριβές ID μοντέλου openai/dall-e-3 ή το ψευδώνυμό του dall-e-3 με τη μέθοδο δημιουργίας εικόνων και στη συνέχεια αποθηκεύστε κάθε επιστρεφόμενο URL εικόνας και το συνοδευτικό αποτέλεσμα. Ένα τεκμηριωμένο αρχικό αίτημα παράγει μία εικόνα 1024x1024 από κείμενο.
- Αποδεκτές είσοδοι
- Κείμενο
- Αποτελέσματα
- Εικόνες
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Images POST /v1/images/generations
- Είσοδος
text- Έξοδος
image- Μορφή εξόδου
- Αρχείο εικόνας
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια openai/dall-e-3 | Προεπιλογή— |
Πεδίοprompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοstream | Τύποςboolean | ΑπαίτησηΠροαιρετικό | Τιμές και όρια false | Προεπιλογήfalse |
Πεδίοn | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 1 | Προεπιλογή— |
Πεδίοsize | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 1024x1024 | Προεπιλογή— |
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηmodel, prompt |
Παράμετροςoptional | Σύμβασηstream, n, size |
Παράμετροςmaterial_types | Σύμβασηtext |
Παράμετροςconditions | ΣύμβασηUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Κύκλος ζωής: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Τιμολόγηση
Πώς υπολογίζεται η τελική χρέωση
Οι εμφανιζόμενες τιμές χρησιμοποιούνται για την εκτίμηση του κόστους πριν από την παραγωγή. Η τελική χρέωση υπολογίζεται από το κόστος που καταγράφηκε για την αρχική παραγωγή. Η μετρημένη διάρκεια της εξόδου και οι προβλεπόμενες ποσότητες δεν αποτελούν την τελική χρεώσιμη ποσότητα.
Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.
- Γρήγορη λειτουργία
- Δεν έχει οριστεί Όταν επιλέγεται η γρήγορη λειτουργία
- Λειτουργία flex
- Δεν έχει οριστεί Όταν επιλέγεται η λειτουργία flex
- Μέγιστη προσπάθεια συλλογισμού
- Δεν έχει οριστεί Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default
Εκτιμώμενες χρεώσεις για σύγκριση
Τιμές ανά διαμόρφωση
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Πίνακας χρεώσεων | Προβλεπόμενη ποσότητα | Χρέωση |
|---|---|---|---|
| ΔιαμόρφωσηΒασικές χρεώσεις token | Πίνακας χρεώσεωνΒασική χρέωση | Προβλεπόμενη ποσότητα— | Χρέωση Είσοδος · Token εισόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Έξοδος · Token εξόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα · Εκτίμηση μόνο για σύγκριση — / 1K token |
| ΔιαμόρφωσηEstimated generation cost | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία | Χρέωση Είσοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $0.32768 εκτίμηση πριν από τη δημιουργία This estimate is not an additional charge or a fixed rate for the completed generation. |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Παραδείγματα αιτημάτων
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "openai/dall-e-3", "prompt": "A calm studio product photograph with a plain background.", "n": 1, "size": "1024x1024"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Λήψη και αποθήκευση αποτελεσμάτων
Ailoot Ultra · Images
Κατεβάστε κάθε εικόνα που επιστρέφεται ή αποθηκεύστε το περιεχόμενο Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα
Αποθηκεύστε κάθε ολοκληρωμένη εικόνα· ανακτήστε κάθε URL που επιστρέφεται ή αποκωδικοποιήστε το περιεχόμενο Base64.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Αν χρειάζεται έλεγχος της αρχικής απάντησης
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Εναλλακτικά ονόματα
Εναλλακτικά ονόματα μοντέλου
Ailoot Ultra openai/dall-e-3, dall-e-3
Εναλλακτικές διαδρομές μεθόδων
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.
Σχετικά ID μοντέλων
Ailoot Ultra · Images POST /v1/images/generations dall-e-3
dall-e-3openai/dall-e-3dall-e-3
Εισαγωγή
Το DALL·E 3 δημιουργεί εικόνες από γραπτή περιγραφή σκηνής. Χρησιμοποιήστε το ακριβές ID μοντέλου openai/dall-e-3 ή το ψευδώνυμό του dall-e-3 με τη μέθοδο δημιουργίας εικόνων και στη συνέχεια αποθηκεύστε κάθε επιστρεφόμενο URL εικόνας και το συνοδευτικό αποτέλεσμα. Ένα τεκμηριωμένο αρχικό αίτημα παράγει μία εικόνα 1024x1024 από κείμενο.
- Αποδεκτές είσοδοι
- Κείμενο
- Αποτελέσματα
- Εικόνες
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Images POST /v1/images/generations
- Είσοδος
text- Έξοδος
image- Μορφή εξόδου
- Αρχείο εικόνας
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια dall-e-3 | Προεπιλογή— |
Πεδίοprompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοstream | Τύποςboolean | ΑπαίτησηΠροαιρετικό | Τιμές και όρια false | Προεπιλογήfalse |
Πεδίοn | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 1 | Προεπιλογή— |
Πεδίοsize | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 1024x1024 | Προεπιλογή— |
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηmodel, prompt |
Παράμετροςoptional | Σύμβασηstream, n, size |
Παράμετροςmaterial_types | Σύμβασηtext |
Παράμετροςconditions | ΣύμβασηUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Κύκλος ζωής: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Τιμολόγηση
Πώς υπολογίζεται η τελική χρέωση
Οι εμφανιζόμενες τιμές χρησιμοποιούνται για την εκτίμηση του κόστους πριν από την παραγωγή. Η τελική χρέωση υπολογίζεται από το κόστος που καταγράφηκε για την αρχική παραγωγή. Η μετρημένη διάρκεια της εξόδου και οι προβλεπόμενες ποσότητες δεν αποτελούν την τελική χρεώσιμη ποσότητα.
Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.
- Γρήγορη λειτουργία
- Δεν έχει οριστεί Όταν επιλέγεται η γρήγορη λειτουργία
- Λειτουργία flex
- Δεν έχει οριστεί Όταν επιλέγεται η λειτουργία flex
- Μέγιστη προσπάθεια συλλογισμού
- Δεν έχει οριστεί Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default
Εκτιμώμενες χρεώσεις για σύγκριση
Τιμές ανά διαμόρφωση
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Πίνακας χρεώσεων | Προβλεπόμενη ποσότητα | Χρέωση |
|---|---|---|---|
| ΔιαμόρφωσηΒασικές χρεώσεις token | Πίνακας χρεώσεωνΒασική χρέωση | Προβλεπόμενη ποσότητα— | Χρέωση Είσοδος · Token εισόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Έξοδος · Token εξόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα · Εκτίμηση μόνο για σύγκριση — / 1K token |
| ΔιαμόρφωσηEstimated generation cost | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία | Χρέωση Είσοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $0.32768 εκτίμηση πριν από τη δημιουργία This estimate is not an additional charge or a fixed rate for the completed generation. |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Παραδείγματα αιτημάτων
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "dall-e-3", "prompt": "A calm studio product photograph with a plain background.", "n": 1, "size": "1024x1024"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Λήψη και αποθήκευση αποτελεσμάτων
Ailoot Ultra · Images
Κατεβάστε κάθε εικόνα που επιστρέφεται ή αποθηκεύστε το περιεχόμενο Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα
Αποθηκεύστε κάθε ολοκληρωμένη εικόνα· ανακτήστε κάθε URL που επιστρέφεται ή αποκωδικοποιήστε το περιεχόμενο Base64.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Αν χρειάζεται έλεγχος της αρχικής απάντησης
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Εναλλακτικά ονόματα
Εναλλακτικά ονόματα μοντέλου
Ailoot Ultra openai/dall-e-3, dall-e-3
Εναλλακτικές διαδρομές μεθόδων
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.
Σχετικά ID μοντέλων
FAQ · OpenAI: DALL·E 3
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/images/generations·openai/dall-e-3:text→imagePOST /v1/images/generations·dall-e-3:text→image- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/images/generations·openai/dall-e-3:model,prompt,stream,n,sizePOST /v1/images/generations·dall-e-3:model,prompt,stream,n,size