Το GPT Image 1.5 είναι ένα μοντέλο της OpenAI για δημιουργία εικόνων από περιγραφή σε κείμενο. Ο κατασκευαστής δίνει έμφαση στην τήρηση οδηγιών και την επεξεργασία λεπτομερούς περιγραφής: μπορούν να οριστούν το περιεχόμενο της σκηνής, η σύνθεση, η εμφάνιση των αντικειμένων και το επιθυμητό ύφος. Το αποτέλεσμα της μεθόδου εικόνων είναι μια έτοιμη εικόνα.
Στο Ailoot, αυτή η κάρτα αφορά δημιουργία με είσοδο κειμένου. Η OpenAI περιγράφει επίσης τη χρήση αρχικών εικόνων, την επεξεργασία και την τροποποίηση επιμέρους περιοχών. Αυτές οι δυνατότητες απαιτούν χωριστή υποστήριξη οπτικής εισόδου και δεν περιλαμβάνονται στον τρόπο δημιουργίας από κείμενο που παρουσιάζεται εδώ.
Στη χωριστή λειτουργία επεξεργασίας που προβλέπει η OpenAI, η μάσκα χρησιμεύει ως οδηγός: δεν εγγυάται ότι το αποτέλεσμα θα συμπέσει ακριβώς με το περίγραμμά της. Για μια τέτοια λειτουργία απαιτείται υποστήριξη παροχής της αρχικής εικόνας· η τρέχουσα κάρτα του Ailoot εξακολουθεί να αφορά δημιουργία με είσοδο κειμένου.
Προβλέπονται τετράγωνες διαστάσεις 1024x1024, οριζόντιες 1536x1024 και κατακόρυφες 1024x1536, καθώς και αυτόματη επιλογή. Σε αυτή την έκδοση δεν πρέπει να μεταφέρονται αυθαίρετες διαστάσεις από άλλα μοντέλα.
Τα επίπεδα ποιότητας είναι low, medium, high και auto. Η επιλογή ποιότητας επηρεάζει τον όγκο επεξεργασίας και τη λεπτομέρεια του αποτελέσματος. Η ποιότητα και οι διαστάσεις είναι διαφορετικές ρυθμίσεις: ο προσανατολισμός του κάδρου καθορίζει τον χώρο της σύνθεσης και το επίπεδο ποιότητας τον τρόπο διαμόρφωσής της. Τα επίπεδα xhigh και max δεν δηλώνονται για το GPT Image 1.5.
Από προεπιλογή, το αποτέλεσμα δημιουργείται σε PNG· προβλέπονται επίσης JPEG και WebP. Για JPEG και WebP μπορεί να οριστεί ο βαθμός συμπίεσης. Αυτή είναι ρύθμιση του αρχείου αποτελέσματος και διαφέρει από την ποιότητα δημιουργίας.
Ο κατασκευαστής προβλέπει διαφανές και αδιαφανές φόντο, καθώς και αυτόματη επιλογή. Για διαφάνεια απαιτείται PNG ή WebP: το JPEG δεν διατηρεί κανάλι άλφα. Το διαφανές φόντο είναι χρήσιμο όταν η εικόνα πρόκειται να χρησιμοποιηθεί ως ξεχωριστό αντικείμενο σε μεταγενέστερη σύνθεση. Η υποστήριξη συγκεκριμένων παραμέτρων πρέπει να εξετάζεται σε σχέση με την επιλεγμένη μέθοδο.
Το μοντέλο μπορεί να ενσωματώνει επιγραφές στην εικόνα και να συνθέτει μια σκηνή από πολλά στοιχεία, αλλά δεν εγγυάται την ακριβή τοποθέτηση κειμένου και αντικειμένων. Η συνέπεια στην εμφάνιση του ίδιου χαρακτήρα ή στον σχεδιασμό μεταξύ διαφορετικών δημιουργιών χρειάζεται επίσης έλεγχο.
Μια σύνθετη εικόνα μπορεί να χρειάζεται περισσότερο χρόνο από μια απλή· σύμφωνα με την OpenAI, ορισμένες σύνθετες εργασίες μπορεί να διαρκέσουν έως δύο λεπτά. Για το αποτέλεσμα έχουν σημασία τόσο η πληρότητα της αρχικής περιγραφής όσο και ο έλεγχος της έτοιμης εικόνας: η αναγνωσιμότητα των επιγραφών, η θέση των λεπτομερειών και η αντιστοιχία με τη ζητούμενη σκηνή αξιολογούνται στο ίδιο το αρχείο.
", "aboutText": "### Εικόνα από λεπτομερή περιγραφή\n\nΤο GPT Image 1.5 είναι ένα μοντέλο της OpenAI για δημιουργία εικόνων από περιγραφή σε κείμενο. Ο κατασκευαστής δίνει έμφαση στην τήρηση οδηγιών και την επεξεργασία λεπτομερούς περιγραφής: μπορούν να οριστούν το περιεχόμενο της σκηνής, η σύνθεση, η εμφάνιση των αντικειμένων και το επιθυμητό ύφος. Το αποτέλεσμα της μεθόδου εικόνων είναι μια έτοιμη εικόνα.\n\nΣτο Ailoot, αυτή η κάρτα αφορά δημιουργία με είσοδο κειμένου. Η OpenAI περιγράφει επίσης τη χρήση αρχικών εικόνων, την επεξεργασία και την τροποποίηση επιμέρους περιοχών. Αυτές οι δυνατότητες απαιτούν χωριστή υποστήριξη οπτικής εισόδου και δεν περιλαμβάνονται στον τρόπο δημιουργίας από κείμενο που παρουσιάζεται εδώ.\n\nΣτη χωριστή λειτουργία επεξεργασίας που προβλέπει η OpenAI, η μάσκα χρησιμεύει ως οδηγός: δεν εγγυάται ότι το αποτέλεσμα θα συμπέσει ακριβώς με το περίγραμμά της. Για μια τέτοια λειτουργία απαιτείται υποστήριξη παροχής της αρχικής εικόνας· η τρέχουσα κάρτα του Ailoot εξακολουθεί να αφορά δημιουργία με είσοδο κειμένου.\n\n### Τρία σχήματα κάδρου και ρύθμιση ποιότητας\n\nΠροβλέπονται τετράγωνες διαστάσεις `1024x1024`, οριζόντιες `1536x1024` και κατακόρυφες `1024x1536`, καθώς και αυτόματη επιλογή. Σε αυτή την έκδοση δεν πρέπει να μεταφέρονται αυθαίρετες διαστάσεις από άλλα μοντέλα.\n\nΤα επίπεδα ποιότητας είναι `low`, `medium`, `high` και `auto`. Η επιλογή ποιότητας επηρεάζει τον όγκο επεξεργασίας και τη λεπτομέρεια του αποτελέσματος. Η ποιότητα και οι διαστάσεις είναι διαφορετικές ρυθμίσεις: ο προσανατολισμός του κάδρου καθορίζει τον χώρο της σύνθεσης και το επίπεδο ποιότητας τον τρόπο διαμόρφωσής της. Τα επίπεδα `xhigh` και `max` δεν δηλώνονται για το GPT Image 1.5.\n\n### Μορφή αρχείου και φόντο\n\nΑπό προεπιλογή, το αποτέλεσμα δημιουργείται σε PNG· προβλέπονται επίσης JPEG και WebP. Για JPEG και WebP μπορεί να οριστεί ο βαθμός συμπίεσης. Αυτή είναι ρύθμιση του αρχείου αποτελέσματος και διαφέρει από την ποιότητα δημιουργίας.\n\nΟ κατασκευαστής προβλέπει διαφανές και αδιαφανές φόντο, καθώς και αυτόματη επιλογή. Για διαφάνεια απαιτείται PNG ή WebP: το JPEG δεν διατηρεί κανάλι άλφα. Το διαφανές φόντο είναι χρήσιμο όταν η εικόνα πρόκειται να χρησιμοποιηθεί ως ξεχωριστό αντικείμενο σε μεταγενέστερη σύνθεση. Η υποστήριξη συγκεκριμένων παραμέτρων πρέπει να εξετάζεται σε σχέση με την επιλεγμένη μέθοδο.\n\n### Το κείμενο και η σύνθεση χρειάζονται έλεγχο\n\nΤο μοντέλο μπορεί να ενσωματώνει επιγραφές στην εικόνα και να συνθέτει μια σκηνή από πολλά στοιχεία, αλλά δεν εγγυάται την ακριβή τοποθέτηση κειμένου και αντικειμένων. Η συνέπεια στην εμφάνιση του ίδιου χαρακτήρα ή στον σχεδιασμό μεταξύ διαφορετικών δημιουργιών χρειάζεται επίσης έλεγχο.\n\nΜια σύνθετη εικόνα μπορεί να χρειάζεται περισσότερο χρόνο από μια απλή· σύμφωνα με την OpenAI, ορισμένες σύνθετες εργασίες μπορεί να διαρκέσουν έως δύο λεπτά. Για το αποτέλεσμα έχουν σημασία τόσο η πληρότητα της αρχικής περιγραφής όσο και ο έλεγχος της έτοιμης εικόνας: η αναγνωσιμότητα των επιγραφών, η θέση των λεπτομερειών και η αντιστοιχία με τη ζητούμενη σκηνή αξιολογούνται στο ίδιο το αρχείο.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "079e2aa181a98f73160c5f9e8b221dc9a690e55309c2ed14bae2286973b0795f", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "el", "methods": [ { "html": "gpt-image-1.5Το GPT Image 1.5 δημιουργεί εικόνες από περιγραφή σε κείμενο, με έμφαση στην τήρηση λεπτομερών οδηγιών. Προβλέπονται τρία σχήματα κάδρου και πολλά επίπεδα ποιότητας και μορφές αποτελέσματος.
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το GPT Image 1.5 είναι ένα μοντέλο της OpenAI για δημιουργία εικόνων από περιγραφή σε κείμενο. Ο κατασκευαστής δίνει έμφαση στην τήρηση οδηγιών και την επεξεργασία λεπτομερούς περιγραφής: μπορούν να οριστούν το περιεχόμενο της σκηνής, η σύνθεση, η εμφάνιση των αντικειμένων και το επιθυμητό ύφος. Το αποτέλεσμα της μεθόδου εικόνων είναι μια έτοιμη εικόνα.
Στο Ailoot, αυτή η κάρτα αφορά δημιουργία με είσοδο κειμένου. Η OpenAI περιγράφει επίσης τη χρήση αρχικών εικόνων, την επεξεργασία και την τροποποίηση επιμέρους περιοχών. Αυτές οι δυνατότητες απαιτούν χωριστή υποστήριξη οπτικής εισόδου και δεν περιλαμβάνονται στον τρόπο δημιουργίας από κείμενο που παρουσιάζεται εδώ.
Στη χωριστή λειτουργία επεξεργασίας που προβλέπει η OpenAI, η μάσκα χρησιμεύει ως οδηγός: δεν εγγυάται ότι το αποτέλεσμα θα συμπέσει ακριβώς με το περίγραμμά της. Για μια τέτοια λειτουργία απαιτείται υποστήριξη παροχής της αρχικής εικόνας· η τρέχουσα κάρτα του Ailoot εξακολουθεί να αφορά δημιουργία με είσοδο κειμένου.
Προβλέπονται τετράγωνες διαστάσεις 1024x1024, οριζόντιες 1536x1024 και κατακόρυφες 1024x1536, καθώς και αυτόματη επιλογή. Σε αυτή την έκδοση δεν πρέπει να μεταφέρονται αυθαίρετες διαστάσεις από άλλα μοντέλα.
Τα επίπεδα ποιότητας είναι low, medium, high και auto. Η επιλογή ποιότητας επηρεάζει τον όγκο επεξεργασίας και τη λεπτομέρεια του αποτελέσματος. Η ποιότητα και οι διαστάσεις είναι διαφορετικές ρυθμίσεις: ο προσανατολισμός του κάδρου καθορίζει τον χώρο της σύνθεσης και το επίπεδο ποιότητας τον τρόπο διαμόρφωσής της. Τα επίπεδα xhigh και max δεν δηλώνονται για το GPT Image 1.5.
Από προεπιλογή, το αποτέλεσμα δημιουργείται σε PNG· προβλέπονται επίσης JPEG και WebP. Για JPEG και WebP μπορεί να οριστεί ο βαθμός συμπίεσης. Αυτή είναι ρύθμιση του αρχείου αποτελέσματος και διαφέρει από την ποιότητα δημιουργίας.
Ο κατασκευαστής προβλέπει διαφανές και αδιαφανές φόντο, καθώς και αυτόματη επιλογή. Για διαφάνεια απαιτείται PNG ή WebP: το JPEG δεν διατηρεί κανάλι άλφα. Το διαφανές φόντο είναι χρήσιμο όταν η εικόνα πρόκειται να χρησιμοποιηθεί ως ξεχωριστό αντικείμενο σε μεταγενέστερη σύνθεση. Η υποστήριξη συγκεκριμένων παραμέτρων πρέπει να εξετάζεται σε σχέση με την επιλεγμένη μέθοδο.
Το μοντέλο μπορεί να ενσωματώνει επιγραφές στην εικόνα και να συνθέτει μια σκηνή από πολλά στοιχεία, αλλά δεν εγγυάται την ακριβή τοποθέτηση κειμένου και αντικειμένων. Η συνέπεια στην εμφάνιση του ίδιου χαρακτήρα ή στον σχεδιασμό μεταξύ διαφορετικών δημιουργιών χρειάζεται επίσης έλεγχο.
Μια σύνθετη εικόνα μπορεί να χρειάζεται περισσότερο χρόνο από μια απλή· σύμφωνα με την OpenAI, ορισμένες σύνθετες εργασίες μπορεί να διαρκέσουν έως δύο λεπτά. Για το αποτέλεσμα έχουν σημασία τόσο η πληρότητα της αρχικής περιγραφής όσο και ο έλεγχος της έτοιμης εικόνας: η αναγνωσιμότητα των επιγραφών, η θέση των λεπτομερειών και η αντιστοιχία με τη ζητούμενη σκηνή αξιολογούνται στο ίδιο το αρχείο.
POST /v1/images/generationstextimage| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια gpt-image-1.5 | Προεπιλογή— |
Πεδίο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 δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
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": "gpt-image-1.5", "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': 'gpt-image-1.5', '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": "gpt-image-1.5", "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 gpt-image-1.5
Ailoot Ultra gpt-image-1.5
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.
gpt-image-1.5Το GPT Image 1.5 δημιουργεί εικόνες από περιγραφή σε κείμενο, με έμφαση στην τήρηση λεπτομερών οδηγιών. Προβλέπονται τρία σχήματα κάδρου και πολλά επίπεδα ποιότητας και μορφές αποτελέσματος.
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το GPT Image 1.5 είναι ένα μοντέλο της OpenAI για δημιουργία εικόνων από περιγραφή σε κείμενο. Ο κατασκευαστής δίνει έμφαση στην τήρηση οδηγιών και την επεξεργασία λεπτομερούς περιγραφής: μπορούν να οριστούν το περιεχόμενο της σκηνής, η σύνθεση, η εμφάνιση των αντικειμένων και το επιθυμητό ύφος. Το αποτέλεσμα της μεθόδου εικόνων είναι μια έτοιμη εικόνα.
Στο Ailoot, αυτή η κάρτα αφορά δημιουργία με είσοδο κειμένου. Η OpenAI περιγράφει επίσης τη χρήση αρχικών εικόνων, την επεξεργασία και την τροποποίηση επιμέρους περιοχών. Αυτές οι δυνατότητες απαιτούν χωριστή υποστήριξη οπτικής εισόδου και δεν περιλαμβάνονται στον τρόπο δημιουργίας από κείμενο που παρουσιάζεται εδώ.
Στη χωριστή λειτουργία επεξεργασίας που προβλέπει η OpenAI, η μάσκα χρησιμεύει ως οδηγός: δεν εγγυάται ότι το αποτέλεσμα θα συμπέσει ακριβώς με το περίγραμμά της. Για μια τέτοια λειτουργία απαιτείται υποστήριξη παροχής της αρχικής εικόνας· η τρέχουσα κάρτα του Ailoot εξακολουθεί να αφορά δημιουργία με είσοδο κειμένου.
Προβλέπονται τετράγωνες διαστάσεις 1024x1024, οριζόντιες 1536x1024 και κατακόρυφες 1024x1536, καθώς και αυτόματη επιλογή. Σε αυτή την έκδοση δεν πρέπει να μεταφέρονται αυθαίρετες διαστάσεις από άλλα μοντέλα.
Τα επίπεδα ποιότητας είναι low, medium, high και auto. Η επιλογή ποιότητας επηρεάζει τον όγκο επεξεργασίας και τη λεπτομέρεια του αποτελέσματος. Η ποιότητα και οι διαστάσεις είναι διαφορετικές ρυθμίσεις: ο προσανατολισμός του κάδρου καθορίζει τον χώρο της σύνθεσης και το επίπεδο ποιότητας τον τρόπο διαμόρφωσής της. Τα επίπεδα xhigh και max δεν δηλώνονται για το GPT Image 1.5.
Από προεπιλογή, το αποτέλεσμα δημιουργείται σε PNG· προβλέπονται επίσης JPEG και WebP. Για JPEG και WebP μπορεί να οριστεί ο βαθμός συμπίεσης. Αυτή είναι ρύθμιση του αρχείου αποτελέσματος και διαφέρει από την ποιότητα δημιουργίας.
Ο κατασκευαστής προβλέπει διαφανές και αδιαφανές φόντο, καθώς και αυτόματη επιλογή. Για διαφάνεια απαιτείται PNG ή WebP: το JPEG δεν διατηρεί κανάλι άλφα. Το διαφανές φόντο είναι χρήσιμο όταν η εικόνα πρόκειται να χρησιμοποιηθεί ως ξεχωριστό αντικείμενο σε μεταγενέστερη σύνθεση. Η υποστήριξη συγκεκριμένων παραμέτρων πρέπει να εξετάζεται σε σχέση με την επιλεγμένη μέθοδο.
Το μοντέλο μπορεί να ενσωματώνει επιγραφές στην εικόνα και να συνθέτει μια σκηνή από πολλά στοιχεία, αλλά δεν εγγυάται την ακριβή τοποθέτηση κειμένου και αντικειμένων. Η συνέπεια στην εμφάνιση του ίδιου χαρακτήρα ή στον σχεδιασμό μεταξύ διαφορετικών δημιουργιών χρειάζεται επίσης έλεγχο.
Μια σύνθετη εικόνα μπορεί να χρειάζεται περισσότερο χρόνο από μια απλή· σύμφωνα με την OpenAI, ορισμένες σύνθετες εργασίες μπορεί να διαρκέσουν έως δύο λεπτά. Για το αποτέλεσμα έχουν σημασία τόσο η πληρότητα της αρχικής περιγραφής όσο και ο έλεγχος της έτοιμης εικόνας: η αναγνωσιμότητα των επιγραφών, η θέση των λεπτομερειών και η αντιστοιχία με τη ζητούμενη σκηνή αξιολογούνται στο ίδιο το αρχείο.
POST /v1/images/generationstextimage| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια gpt-image-1.5 | Προεπιλογή— |
Πεδίοprompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Μέγιστο μήκος: 32.000 | Προεπιλογή— |
Πεδίοsize | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 1024x1024, 1536x1024, 1024x1536, auto | Προεπιλογήauto |
Πεδίοbackground | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια transparent, opaque, auto | Προεπιλογήauto |
Πεδίοmoderation | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια low, auto Συνθήκες: Χρησιμοποιήστε auto για τον τυπικό έλεγχο περιεχομένου. | Προεπιλογή— |
Πεδίοn | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: 1 Μέγιστο: 10 | Προεπιλογή1 |
Πεδίοquality | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια auto, high, medium, low | Προεπιλογήauto |
Πεδίοoutput_compression | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: 0 Μέγιστο: 100 Συνθήκες: Ισχύει για έξοδο JPEG και WebP· στείλτε την τεκμηριωμένη ακέραια τιμή. | Προεπιλογή100 |
Πεδίοoutput_format | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια webp, png, jpeg | Προεπιλογήpng |
Πεδίοstream | Τύποςboolean | ΑπαίτησηΠροαιρετικό | Τιμές και όρια false Συνθήκες: Αυτή η διαδρομή επιστρέφει μία ολοκληρωμένη απόκριση JSON. | Προεπιλογήfalse |
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηprompt, model |
Παράμετροςmaterial_types | Σύμβασηtext |
Παράμετροςoptional | Σύμβασηsize, background, moderation, n, quality, output_compression, output_format, stream |
Παράμετροςconditions | ΣύμβασηΤο διαφανές φόντο απαιτεί PNG ή WebP., Η συμπίεση εξόδου ισχύει για JPEG ή WebP., Η επιλεγμένη μέθοδος δημιουργεί από κείμενο. Οι παράμετροι επεξεργασίας και ροής που περιγράφονται για τον κατασκευαστή αποτελούν ξεχωριστές δυνατότητες. |
Κύκλος ζωής: 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.32768 εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή. |
Το 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={'prompt': 'A cute baby sea otter', 'model': 'gpt-image-1.5', 'size': '1024x1024', 'n': 1, 'background': 'auto', 'moderation': 'auto', 'output_format': 'png'}\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 gpt-image-1.5
Ailoot Ultra gpt-image-1.5
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.