Το Wan2.7-Image-Pro είναι μοντέλο της Alibaba για δημιουργία εικόνων από κείμενο. Η τρέχουσα κάρτα του Ailoot δημοσιεύει είσοδο κειμένου και αποτέλεσμα σε μορφή εικόνας. Ο κατασκευαστής προβλέπει επίσης επεξεργασία, συνδυασμό εικόνων αναφοράς και τοπικές αλλαγές· αυτοί οι τρόποι χρήσης απαιτούν ξεχωριστή υποστήριξη εικόνων εισόδου και δεν περιλαμβάνονται στην τρέχουσα μέθοδο της κάρτας.
Στη λειτουργία με εικόνες αναφοράς της υλοποίησης του κατασκευαστή μπορούν να δοθούν έως εννέα αρχικές εικόνες και να περιγραφεί ποια στοιχεία της καθεμιάς πρέπει να χρησιμοποιηθούν. Κατά την επεξεργασία το μοντέλο διατηρεί το κύριο αντικείμενο, αλλάζει τις επιλεγμένες λεπτομέρειες ή συνθέτει νέα εικόνα από διαφορετικό υλικό. Για ακριβέστερη καθοδήγηση των αλλαγών μπορούν να οριστούν έως δύο ορθογώνιες περιοχές σε μία εικόνα εισόδου.
Εκτός διαδοχικών σειρών μπορεί να οριστεί παλέτα από 3–10 χρώματα. Η λειτουργία συλλογισμού προορίζεται για κανονική δημιουργία από κείμενο χωρίς εικόνες αναφοράς και διαδοχική σειρά: το μοντέλο αναλύει προκαταρκτικά την περιγραφή της σκηνής.
Στις προδιαγραφές της Alibaba η κανονική έξοδος περιλαμβάνει από μία έως τέσσερις εικόνες. Σε αφηγηματική σειρά μπορεί να τεθεί ανώτατο όριο έως 12· τον πραγματικό αριθμό τον επιλέγει το μοντέλο σύμφωνα με τις οδηγίες. Η σειρά μπορεί να χρησιμοποιεί κείμενο και εικόνες αναφοράς για κοινά χαρακτηριστικά χαρακτήρων και συνεκτική εξέλιξη της ιστορίας. Η παλέτα και ο συλλογισμός δεν εφαρμόζονται σε αυτή τη λειτουργία.
Το επίπεδο 4K υποστηρίζεται σε κανονική δημιουργία από κείμενο χωρίς εικόνες αναφοράς και διαδοχική σειρά. Η επεξεργασία από εικόνες και οι διαδοχικές σειρές περιορίζονται στο επίπεδο 2K. Αυτοί οι όροι ορίζουν την επιφάνεια σε pixel, όχι ίδιο μήκος για κάθε πλευρά. Το σχήμα του καρέ μπορεί να επιλεγεί από 1:8 έως 8:1· κατά την επεξεργασία με προκαθορισμένη ανάλυση ο λόγος διαστάσεων ακολουθεί την τελευταία εικόνα αναφοράς. Τα αποτελέσματα αποθηκεύονται σε PNG.
Για τρόπους χρήσης με εικόνες εισόδου, η Alibaba δέχεται JPEG, JPG, PNG χωρίς διαφάνεια, BMP και WEBP. Τα όρια είναι 20 MB ανά αρχείο, από 240 έως 8000 pixel για κάθε πλευρά και λόγος διαστάσεων από 1:8 έως 8:1. Για οδηγίες κειμένου υποστηρίζονται κινεζικά και αγγλικά· το μέγιστο είναι 5000 χαρακτήρες και το επιπλέον τμήμα απορρίπτεται. Για τη συγκεκριμένη έκδοση δεν προβλέπονται αρνητική περιγραφή και επέκταση των οδηγιών. Η αρχική τιμή τυχαιότητας βοηθά στη διατήρηση ομοιότητας μεταξύ παραλλαγών, αλλά δεν εξασφαλίζει ακριβή επανάληψη.
", "aboutText": "Το Wan2.7-Image-Pro είναι μοντέλο της Alibaba για δημιουργία εικόνων από κείμενο. Η τρέχουσα κάρτα του Ailoot δημοσιεύει είσοδο κειμένου και αποτέλεσμα σε μορφή εικόνας. Ο κατασκευαστής προβλέπει επίσης επεξεργασία, συνδυασμό εικόνων αναφοράς και τοπικές αλλαγές· αυτοί οι τρόποι χρήσης απαιτούν ξεχωριστή υποστήριξη εικόνων εισόδου και δεν περιλαμβάνονται στην τρέχουσα μέθοδο της κάρτας.\n\nΣτη λειτουργία με εικόνες αναφοράς της υλοποίησης του κατασκευαστή μπορούν να δοθούν έως εννέα αρχικές εικόνες και να περιγραφεί ποια στοιχεία της καθεμιάς πρέπει να χρησιμοποιηθούν. Κατά την επεξεργασία το μοντέλο διατηρεί το κύριο αντικείμενο, αλλάζει τις επιλεγμένες λεπτομέρειες ή συνθέτει νέα εικόνα από διαφορετικό υλικό. Για ακριβέστερη καθοδήγηση των αλλαγών μπορούν να οριστούν έως δύο ορθογώνιες περιοχές σε μία εικόνα εισόδου.\n\n### Παλέτα και σύνθετες οδηγίες\n\nΕκτός διαδοχικών σειρών μπορεί να οριστεί παλέτα από 3–10 χρώματα. Η λειτουργία συλλογισμού προορίζεται για κανονική δημιουργία από κείμενο χωρίς εικόνες αναφοράς και διαδοχική σειρά: το μοντέλο αναλύει προκαταρκτικά την περιγραφή της σκηνής.\n\nΣτις προδιαγραφές της Alibaba η κανονική έξοδος περιλαμβάνει από μία έως τέσσερις εικόνες. Σε αφηγηματική σειρά μπορεί να τεθεί ανώτατο όριο έως 12· τον πραγματικό αριθμό τον επιλέγει το μοντέλο σύμφωνα με τις οδηγίες. Η σειρά μπορεί να χρησιμοποιεί κείμενο και εικόνες αναφοράς για κοινά χαρακτηριστικά χαρακτήρων και συνεκτική εξέλιξη της ιστορίας. Η παλέτα και ο συλλογισμός δεν εφαρμόζονται σε αυτή τη λειτουργία.\n\n### Η ανάλυση εξαρτάται από τη λειτουργία\n\nΤο επίπεδο 4K υποστηρίζεται σε κανονική δημιουργία από κείμενο χωρίς εικόνες αναφοράς και διαδοχική σειρά. Η επεξεργασία από εικόνες και οι διαδοχικές σειρές περιορίζονται στο επίπεδο 2K. Αυτοί οι όροι ορίζουν την επιφάνεια σε pixel, όχι ίδιο μήκος για κάθε πλευρά. Το σχήμα του καρέ μπορεί να επιλεγεί από 1:8 έως 8:1· κατά την επεξεργασία με προκαθορισμένη ανάλυση ο λόγος διαστάσεων ακολουθεί την τελευταία εικόνα αναφοράς. Τα αποτελέσματα αποθηκεύονται σε PNG.\n\nΓια τρόπους χρήσης με εικόνες εισόδου, η Alibaba δέχεται JPEG, JPG, PNG χωρίς διαφάνεια, BMP και WEBP. Τα όρια είναι 20 MB ανά αρχείο, από 240 έως 8000 pixel για κάθε πλευρά και λόγος διαστάσεων από 1:8 έως 8:1. Για οδηγίες κειμένου υποστηρίζονται κινεζικά και αγγλικά· το μέγιστο είναι 5000 χαρακτήρες και το επιπλέον τμήμα απορρίπτεται. Για τη συγκεκριμένη έκδοση δεν προβλέπονται αρνητική περιγραφή και επέκταση των οδηγιών. Η αρχική τιμή τυχαιότητας βοηθά στη διατήρηση ομοιότητας μεταξύ παραλλαγών, αλλά δεν εξασφαλίζει ακριβή επανάληψη.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "a17d75022506346934a50b1fd66ae8cc6f5d0febb0025006ec45624a30e8949d", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "el", "methods": [ { "html": "wan2.7-image-proΜοντέλο δημιουργίας εικόνων από οδηγίες κειμένου. Ο κατασκευαστής προβλέπει έλεγχο χρωματικής παλέτας και ανάλυση έως 4K για κανονική δημιουργία από κείμενο.
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Wan2.7-Image-Pro είναι μοντέλο της Alibaba για δημιουργία εικόνων από κείμενο. Η τρέχουσα κάρτα του Ailoot δημοσιεύει είσοδο κειμένου και αποτέλεσμα σε μορφή εικόνας. Ο κατασκευαστής προβλέπει επίσης επεξεργασία, συνδυασμό εικόνων αναφοράς και τοπικές αλλαγές· αυτοί οι τρόποι χρήσης απαιτούν ξεχωριστή υποστήριξη εικόνων εισόδου και δεν περιλαμβάνονται στην τρέχουσα μέθοδο της κάρτας.
Στη λειτουργία με εικόνες αναφοράς της υλοποίησης του κατασκευαστή μπορούν να δοθούν έως εννέα αρχικές εικόνες και να περιγραφεί ποια στοιχεία της καθεμιάς πρέπει να χρησιμοποιηθούν. Κατά την επεξεργασία το μοντέλο διατηρεί το κύριο αντικείμενο, αλλάζει τις επιλεγμένες λεπτομέρειες ή συνθέτει νέα εικόνα από διαφορετικό υλικό. Για ακριβέστερη καθοδήγηση των αλλαγών μπορούν να οριστούν έως δύο ορθογώνιες περιοχές σε μία εικόνα εισόδου.
Εκτός διαδοχικών σειρών μπορεί να οριστεί παλέτα από 3–10 χρώματα. Η λειτουργία συλλογισμού προορίζεται για κανονική δημιουργία από κείμενο χωρίς εικόνες αναφοράς και διαδοχική σειρά: το μοντέλο αναλύει προκαταρκτικά την περιγραφή της σκηνής.
Στις προδιαγραφές της Alibaba η κανονική έξοδος περιλαμβάνει από μία έως τέσσερις εικόνες. Σε αφηγηματική σειρά μπορεί να τεθεί ανώτατο όριο έως 12· τον πραγματικό αριθμό τον επιλέγει το μοντέλο σύμφωνα με τις οδηγίες. Η σειρά μπορεί να χρησιμοποιεί κείμενο και εικόνες αναφοράς για κοινά χαρακτηριστικά χαρακτήρων και συνεκτική εξέλιξη της ιστορίας. Η παλέτα και ο συλλογισμός δεν εφαρμόζονται σε αυτή τη λειτουργία.
Το επίπεδο 4K υποστηρίζεται σε κανονική δημιουργία από κείμενο χωρίς εικόνες αναφοράς και διαδοχική σειρά. Η επεξεργασία από εικόνες και οι διαδοχικές σειρές περιορίζονται στο επίπεδο 2K. Αυτοί οι όροι ορίζουν την επιφάνεια σε pixel, όχι ίδιο μήκος για κάθε πλευρά. Το σχήμα του καρέ μπορεί να επιλεγεί από 1:8 έως 8:1· κατά την επεξεργασία με προκαθορισμένη ανάλυση ο λόγος διαστάσεων ακολουθεί την τελευταία εικόνα αναφοράς. Τα αποτελέσματα αποθηκεύονται σε PNG.
Για τρόπους χρήσης με εικόνες εισόδου, η Alibaba δέχεται JPEG, JPG, PNG χωρίς διαφάνεια, BMP και WEBP. Τα όρια είναι 20 MB ανά αρχείο, από 240 έως 8000 pixel για κάθε πλευρά και λόγος διαστάσεων από 1:8 έως 8:1. Για οδηγίες κειμένου υποστηρίζονται κινεζικά και αγγλικά· το μέγιστο είναι 5000 χαρακτήρες και το επιπλέον τμήμα απορρίπτεται. Για τη συγκεκριμένη έκδοση δεν προβλέπονται αρνητική περιγραφή και επέκταση των οδηγιών. Η αρχική τιμή τυχαιότητας βοηθά στη διατήρηση ομοιότητας μεταξύ παραλλαγών, αλλά δεν εξασφαλίζει ακριβή επανάληψη.
POST /v1/images/generationstextimage| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια wan2.7-image-pro | Προεπιλογή— |
Πεδίοprompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Ελάχιστο μήκος: 1 | Προεπιλογή— |
Πεδίοn | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: 1 | Προεπιλογή1 |
Πεδίοresponse_format | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια url, b64_json | Προεπιλογή— |
Πεδίοstream | Τύποςboolean | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογήfalse |
Πεδίοsize | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοpartial_images | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοimages[].image_url | Τύποςstring | ΑπαίτησηΔεν υποστηρίζεται | Τιμές και όρια Μέγιστο πλήθος αποκωδικοποιημένων byte: 20.971.520 Τύποι MIME: image/png, image/jpeg Μέγιστο πλήθος εικόνων ανά πίνακα: 9 Συνθήκες: Ένα πραγματικό URL ανά αντικείμενο images[]. Το πλήθος του πίνακα διαφέρει από αυτή την τελική τιμή συμβολοσειράς. Εφαρμόζεται όταν: Μόνο JSON images/edits· το JSON images/generations δεν αναλύει αναφορές images. | Προεπιλογή— |
Πεδίοimage | Τύποςfile | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Μέγιστο πλήθος αποκωδικοποιημένων byte: 20.971.520 Τύποι MIME: image/png, image/jpeg Εφαρμόζεται όταν: δημιουργία με multipart/form-data | Προεπιλογή— |
Πεδίοimage[] | Τύποςfile[] | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Μέγιστο πλήθος στοιχείων: 9 Μέγιστο πλήθος αποκωδικοποιημένων byte: 20.971.520 Τύποι MIME: image/png, image/jpeg Εφαρμόζεται όταν: δημιουργία με multipart/form-data | Προεπιλογή— |
Κείμενο σε εικόνα · Υποχρεωτικό: prompt
reference_images_generation · Υποχρεωτικό: 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.
| Διαμόρφωση | Συνθήκες χρέωσης | Χρέωση |
|---|---|---|
| Διαμόρφωσηwan2.7-image-pro · Προεπιλεγμένη διαμόρφωση | Συνθήκες χρέωσηςΠροεπιλεγμένη διαμόρφωση | Χρέωση Είσοδος · Είσοδος 0,00 $ ανά κλήση Έξοδος · Έξοδος 0,16 $ ανά κλήση |
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": "wan2.7-image-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': 'wan2.7-image-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": "wan2.7-image-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 wan2.7-image-pro, wan-image, wan-image-latest
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.
wan-imageΜοντέλο δημιουργίας εικόνων από οδηγίες κειμένου. Ο κατασκευαστής προβλέπει έλεγχο χρωματικής παλέτας και ανάλυση έως 4K για κανονική δημιουργία από κείμενο.
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Wan2.7-Image-Pro είναι μοντέλο της Alibaba για δημιουργία εικόνων από κείμενο. Η τρέχουσα κάρτα του Ailoot δημοσιεύει είσοδο κειμένου και αποτέλεσμα σε μορφή εικόνας. Ο κατασκευαστής προβλέπει επίσης επεξεργασία, συνδυασμό εικόνων αναφοράς και τοπικές αλλαγές· αυτοί οι τρόποι χρήσης απαιτούν ξεχωριστή υποστήριξη εικόνων εισόδου και δεν περιλαμβάνονται στην τρέχουσα μέθοδο της κάρτας.
Στη λειτουργία με εικόνες αναφοράς της υλοποίησης του κατασκευαστή μπορούν να δοθούν έως εννέα αρχικές εικόνες και να περιγραφεί ποια στοιχεία της καθεμιάς πρέπει να χρησιμοποιηθούν. Κατά την επεξεργασία το μοντέλο διατηρεί το κύριο αντικείμενο, αλλάζει τις επιλεγμένες λεπτομέρειες ή συνθέτει νέα εικόνα από διαφορετικό υλικό. Για ακριβέστερη καθοδήγηση των αλλαγών μπορούν να οριστούν έως δύο ορθογώνιες περιοχές σε μία εικόνα εισόδου.
Εκτός διαδοχικών σειρών μπορεί να οριστεί παλέτα από 3–10 χρώματα. Η λειτουργία συλλογισμού προορίζεται για κανονική δημιουργία από κείμενο χωρίς εικόνες αναφοράς και διαδοχική σειρά: το μοντέλο αναλύει προκαταρκτικά την περιγραφή της σκηνής.
Στις προδιαγραφές της Alibaba η κανονική έξοδος περιλαμβάνει από μία έως τέσσερις εικόνες. Σε αφηγηματική σειρά μπορεί να τεθεί ανώτατο όριο έως 12· τον πραγματικό αριθμό τον επιλέγει το μοντέλο σύμφωνα με τις οδηγίες. Η σειρά μπορεί να χρησιμοποιεί κείμενο και εικόνες αναφοράς για κοινά χαρακτηριστικά χαρακτήρων και συνεκτική εξέλιξη της ιστορίας. Η παλέτα και ο συλλογισμός δεν εφαρμόζονται σε αυτή τη λειτουργία.
Το επίπεδο 4K υποστηρίζεται σε κανονική δημιουργία από κείμενο χωρίς εικόνες αναφοράς και διαδοχική σειρά. Η επεξεργασία από εικόνες και οι διαδοχικές σειρές περιορίζονται στο επίπεδο 2K. Αυτοί οι όροι ορίζουν την επιφάνεια σε pixel, όχι ίδιο μήκος για κάθε πλευρά. Το σχήμα του καρέ μπορεί να επιλεγεί από 1:8 έως 8:1· κατά την επεξεργασία με προκαθορισμένη ανάλυση ο λόγος διαστάσεων ακολουθεί την τελευταία εικόνα αναφοράς. Τα αποτελέσματα αποθηκεύονται σε PNG.
Για τρόπους χρήσης με εικόνες εισόδου, η Alibaba δέχεται JPEG, JPG, PNG χωρίς διαφάνεια, BMP και WEBP. Τα όρια είναι 20 MB ανά αρχείο, από 240 έως 8000 pixel για κάθε πλευρά και λόγος διαστάσεων από 1:8 έως 8:1. Για οδηγίες κειμένου υποστηρίζονται κινεζικά και αγγλικά· το μέγιστο είναι 5000 χαρακτήρες και το επιπλέον τμήμα απορρίπτεται. Για τη συγκεκριμένη έκδοση δεν προβλέπονται αρνητική περιγραφή και επέκταση των οδηγιών. Η αρχική τιμή τυχαιότητας βοηθά στη διατήρηση ομοιότητας μεταξύ παραλλαγών, αλλά δεν εξασφαλίζει ακριβή επανάληψη.
POST /v1/images/generationstextimage| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια wan-image | Προεπιλογή— |
Πεδίοprompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Ελάχιστο μήκος: 1 | Προεπιλογή— |
Πεδίοn | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: 1 | Προεπιλογή1 |
Πεδίοresponse_format | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια url, b64_json | Προεπιλογή— |
Πεδίοstream | Τύποςboolean | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογήfalse |
Πεδίοsize | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοpartial_images | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοimages[].image_url | Τύποςstring | ΑπαίτησηΔεν υποστηρίζεται | Τιμές και όρια Μέγιστο πλήθος αποκωδικοποιημένων byte: 20.971.520 Τύποι MIME: image/png, image/jpeg Μέγιστο πλήθος εικόνων ανά πίνακα: 9 Συνθήκες: Ένα πραγματικό URL ανά αντικείμενο images[]. Το πλήθος του πίνακα διαφέρει από αυτή την τελική τιμή συμβολοσειράς. Εφαρμόζεται όταν: Μόνο JSON images/edits· το JSON images/generations δεν αναλύει αναφορές images. | Προεπιλογή— |
Πεδίοimage | Τύποςfile | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Μέγιστο πλήθος αποκωδικοποιημένων byte: 20.971.520 Τύποι MIME: image/png, image/jpeg Εφαρμόζεται όταν: δημιουργία με multipart/form-data | Προεπιλογή— |
Πεδίοimage[] | Τύποςfile[] | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Μέγιστο πλήθος στοιχείων: 9 Μέγιστο πλήθος αποκωδικοποιημένων byte: 20.971.520 Τύποι MIME: image/png, image/jpeg Εφαρμόζεται όταν: δημιουργία με multipart/form-data | Προεπιλογή— |
Κείμενο σε εικόνα · Υποχρεωτικό: prompt
reference_images_generation · Υποχρεωτικό: 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.
| Διαμόρφωση | Συνθήκες χρέωσης | Χρέωση |
|---|---|---|
| Διαμόρφωσηwan2.7-image-pro · Προεπιλεγμένη διαμόρφωση | Συνθήκες χρέωσηςΠροεπιλεγμένη διαμόρφωση | Χρέωση Είσοδος · Είσοδος 0,00 $ ανά κλήση Έξοδος · Έξοδος 0,16 $ ανά κλήση |
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": "wan-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': 'wan-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": "wan-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 wan2.7-image-pro, wan-image, wan-image-latest
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.
wan-image-latestΜοντέλο δημιουργίας εικόνων από οδηγίες κειμένου. Ο κατασκευαστής προβλέπει έλεγχο χρωματικής παλέτας και ανάλυση έως 4K για κανονική δημιουργία από κείμενο.
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Wan2.7-Image-Pro είναι μοντέλο της Alibaba για δημιουργία εικόνων από κείμενο. Η τρέχουσα κάρτα του Ailoot δημοσιεύει είσοδο κειμένου και αποτέλεσμα σε μορφή εικόνας. Ο κατασκευαστής προβλέπει επίσης επεξεργασία, συνδυασμό εικόνων αναφοράς και τοπικές αλλαγές· αυτοί οι τρόποι χρήσης απαιτούν ξεχωριστή υποστήριξη εικόνων εισόδου και δεν περιλαμβάνονται στην τρέχουσα μέθοδο της κάρτας.
Στη λειτουργία με εικόνες αναφοράς της υλοποίησης του κατασκευαστή μπορούν να δοθούν έως εννέα αρχικές εικόνες και να περιγραφεί ποια στοιχεία της καθεμιάς πρέπει να χρησιμοποιηθούν. Κατά την επεξεργασία το μοντέλο διατηρεί το κύριο αντικείμενο, αλλάζει τις επιλεγμένες λεπτομέρειες ή συνθέτει νέα εικόνα από διαφορετικό υλικό. Για ακριβέστερη καθοδήγηση των αλλαγών μπορούν να οριστούν έως δύο ορθογώνιες περιοχές σε μία εικόνα εισόδου.
Εκτός διαδοχικών σειρών μπορεί να οριστεί παλέτα από 3–10 χρώματα. Η λειτουργία συλλογισμού προορίζεται για κανονική δημιουργία από κείμενο χωρίς εικόνες αναφοράς και διαδοχική σειρά: το μοντέλο αναλύει προκαταρκτικά την περιγραφή της σκηνής.
Στις προδιαγραφές της Alibaba η κανονική έξοδος περιλαμβάνει από μία έως τέσσερις εικόνες. Σε αφηγηματική σειρά μπορεί να τεθεί ανώτατο όριο έως 12· τον πραγματικό αριθμό τον επιλέγει το μοντέλο σύμφωνα με τις οδηγίες. Η σειρά μπορεί να χρησιμοποιεί κείμενο και εικόνες αναφοράς για κοινά χαρακτηριστικά χαρακτήρων και συνεκτική εξέλιξη της ιστορίας. Η παλέτα και ο συλλογισμός δεν εφαρμόζονται σε αυτή τη λειτουργία.
Το επίπεδο 4K υποστηρίζεται σε κανονική δημιουργία από κείμενο χωρίς εικόνες αναφοράς και διαδοχική σειρά. Η επεξεργασία από εικόνες και οι διαδοχικές σειρές περιορίζονται στο επίπεδο 2K. Αυτοί οι όροι ορίζουν την επιφάνεια σε pixel, όχι ίδιο μήκος για κάθε πλευρά. Το σχήμα του καρέ μπορεί να επιλεγεί από 1:8 έως 8:1· κατά την επεξεργασία με προκαθορισμένη ανάλυση ο λόγος διαστάσεων ακολουθεί την τελευταία εικόνα αναφοράς. Τα αποτελέσματα αποθηκεύονται σε PNG.
Για τρόπους χρήσης με εικόνες εισόδου, η Alibaba δέχεται JPEG, JPG, PNG χωρίς διαφάνεια, BMP και WEBP. Τα όρια είναι 20 MB ανά αρχείο, από 240 έως 8000 pixel για κάθε πλευρά και λόγος διαστάσεων από 1:8 έως 8:1. Για οδηγίες κειμένου υποστηρίζονται κινεζικά και αγγλικά· το μέγιστο είναι 5000 χαρακτήρες και το επιπλέον τμήμα απορρίπτεται. Για τη συγκεκριμένη έκδοση δεν προβλέπονται αρνητική περιγραφή και επέκταση των οδηγιών. Η αρχική τιμή τυχαιότητας βοηθά στη διατήρηση ομοιότητας μεταξύ παραλλαγών, αλλά δεν εξασφαλίζει ακριβή επανάληψη.
POST /v1/images/generationstextimage| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια wan-image-latest | Προεπιλογή— |
Πεδίοprompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Ελάχιστο μήκος: 1 | Προεπιλογή— |
Πεδίοn | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: 1 | Προεπιλογή1 |
Πεδίοresponse_format | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια url, b64_json | Προεπιλογή— |
Πεδίοstream | Τύποςboolean | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογήfalse |
Πεδίοsize | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοpartial_images | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
Πεδίοimages[].image_url | Τύποςstring | ΑπαίτησηΔεν υποστηρίζεται | Τιμές και όρια Μέγιστο πλήθος αποκωδικοποιημένων byte: 20.971.520 Τύποι MIME: image/png, image/jpeg Μέγιστο πλήθος εικόνων ανά πίνακα: 9 Συνθήκες: Ένα πραγματικό URL ανά αντικείμενο images[]. Το πλήθος του πίνακα διαφέρει από αυτή την τελική τιμή συμβολοσειράς. Εφαρμόζεται όταν: Μόνο JSON images/edits· το JSON images/generations δεν αναλύει αναφορές images. | Προεπιλογή— |
Πεδίοimage | Τύποςfile | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Μέγιστο πλήθος αποκωδικοποιημένων byte: 20.971.520 Τύποι MIME: image/png, image/jpeg Εφαρμόζεται όταν: δημιουργία με multipart/form-data | Προεπιλογή— |
Πεδίοimage[] | Τύποςfile[] | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Μέγιστο πλήθος στοιχείων: 9 Μέγιστο πλήθος αποκωδικοποιημένων byte: 20.971.520 Τύποι MIME: image/png, image/jpeg Εφαρμόζεται όταν: δημιουργία με multipart/form-data | Προεπιλογή— |
Κείμενο σε εικόνα · Υποχρεωτικό: prompt
reference_images_generation · Υποχρεωτικό: 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.
| Διαμόρφωση | Συνθήκες χρέωσης | Χρέωση |
|---|---|---|
| Διαμόρφωσηwan2.7-image-pro · Προεπιλεγμένη διαμόρφωση | Συνθήκες χρέωσηςΠροεπιλεγμένη διαμόρφωση | Χρέωση Είσοδος · Είσοδος 0,00 $ ανά κλήση Έξοδος · Έξοδος 0,16 $ ανά κλήση |
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": "wan-image-latest", "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': 'wan-image-latest', '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": "wan-image-latest", "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 wan2.7-image-pro, wan-image, wan-image-latest
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.