Wan2.7-Image-Pro ialah model Alibaba untuk menghasilkan imej daripada teks. Kad Ailoot semasa menerbitkan input teks dan hasil berbentuk imej. Pengeluar turut menyediakan penyuntingan, penggabungan rujukan dan perubahan setempat; kaedah ini memerlukan sokongan input imej yang berasingan dan tidak disediakan oleh kaedah semasa pada kad ini.
Dalam mod rujukan pengeluar, sehingga sembilan imej asal boleh dihantar bersama penerangan tentang unsur setiap imej yang perlu digunakan. Semasa penyuntingan, model mengekalkan objek utama, mengubah butiran yang dipilih atau membina komposisi baharu daripada beberapa bahan. Untuk mengarahkan perubahan dengan lebih tepat, sehingga dua kawasan segi empat tepat boleh ditandakan pada satu imej input.
Di luar siri berurutan, palet dengan 3–10 warna boleh ditetapkan. Mod penaakulan digunakan untuk penjanaan biasa daripada teks tanpa rujukan dan tanpa siri berurutan: model menganalisis penerangan adegan terlebih dahulu.
Dalam spesifikasi Alibaba, output biasa merangkumi satu hingga empat imej. Bagi siri bercerita, had atas sehingga 12 boleh ditetapkan; model memilih bilangan sebenar berdasarkan arahan. Siri boleh mengambil kira teks dan rujukan untuk mengekalkan ciri watak yang sama serta perkembangan cerita yang berkait. Palet dan penaakulan tidak digunakan dalam mod ini.
Tahap 4K disokong untuk penjanaan biasa daripada teks tanpa rujukan dan tanpa siri berurutan. Penyuntingan berdasarkan imej dan siri berurutan dihadkan kepada tahap 2K. Label ini menentukan keluasan piksel, bukannya panjang yang sama bagi setiap sisi. Format bingkai boleh dipilih dari 1:8 hingga 8:1; semasa penyuntingan dengan resolusi pratetap, nisbah aspek mengikut rujukan terakhir. Hasil disimpan dalam PNG.
Bagi kaedah yang menggunakan imej input, Alibaba membenarkan JPEG, JPG, PNG tanpa ketelusan, BMP dan WEBP. Hadnya ialah 20 MB bagi setiap fail, dari 240 hingga 8000 piksel bagi setiap sisi dan nisbah dari 1:8 hingga 8:1. Arahan teks menyokong bahasa Cina dan Inggeris; had maksimum ialah 5000 aksara, dengan bahagian berlebihan dipotong. Penerangan negatif dan peluasan arahan tidak disediakan bagi versi ini. Nilai benih rawak awal membantu mengekalkan keserupaan variasi, tetapi tidak menjamin penghasilan semula secara tepat.
", "aboutText": "Wan2.7-Image-Pro ialah model Alibaba untuk menghasilkan imej daripada teks. Kad Ailoot semasa menerbitkan input teks dan hasil berbentuk imej. Pengeluar turut menyediakan penyuntingan, penggabungan rujukan dan perubahan setempat; kaedah ini memerlukan sokongan input imej yang berasingan dan tidak disediakan oleh kaedah semasa pada kad ini.\n\nDalam mod rujukan pengeluar, sehingga sembilan imej asal boleh dihantar bersama penerangan tentang unsur setiap imej yang perlu digunakan. Semasa penyuntingan, model mengekalkan objek utama, mengubah butiran yang dipilih atau membina komposisi baharu daripada beberapa bahan. Untuk mengarahkan perubahan dengan lebih tepat, sehingga dua kawasan segi empat tepat boleh ditandakan pada satu imej input.\n\n### Palet dan arahan rumit\n\nDi luar siri berurutan, palet dengan 3–10 warna boleh ditetapkan. Mod penaakulan digunakan untuk penjanaan biasa daripada teks tanpa rujukan dan tanpa siri berurutan: model menganalisis penerangan adegan terlebih dahulu.\n\nDalam spesifikasi Alibaba, output biasa merangkumi satu hingga empat imej. Bagi siri bercerita, had atas sehingga 12 boleh ditetapkan; model memilih bilangan sebenar berdasarkan arahan. Siri boleh mengambil kira teks dan rujukan untuk mengekalkan ciri watak yang sama serta perkembangan cerita yang berkait. Palet dan penaakulan tidak digunakan dalam mod ini.\n\n### Resolusi bergantung pada mod\n\nTahap 4K disokong untuk penjanaan biasa daripada teks tanpa rujukan dan tanpa siri berurutan. Penyuntingan berdasarkan imej dan siri berurutan dihadkan kepada tahap 2K. Label ini menentukan keluasan piksel, bukannya panjang yang sama bagi setiap sisi. Format bingkai boleh dipilih dari 1:8 hingga 8:1; semasa penyuntingan dengan resolusi pratetap, nisbah aspek mengikut rujukan terakhir. Hasil disimpan dalam PNG.\n\nBagi kaedah yang menggunakan imej input, Alibaba membenarkan JPEG, JPG, PNG tanpa ketelusan, BMP dan WEBP. Hadnya ialah 20 MB bagi setiap fail, dari 240 hingga 8000 piksel bagi setiap sisi dan nisbah dari 1:8 hingga 8:1. Arahan teks menyokong bahasa Cina dan Inggeris; had maksimum ialah 5000 aksara, dengan bahagian berlebihan dipotong. Penerangan negatif dan peluasan arahan tidak disediakan bagi versi ini. Nilai benih rawak awal membantu mengekalkan keserupaan variasi, tetapi tidak menjamin penghasilan semula secara tepat.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "74297e28b6e05ae6f5298c906118206e52644b84f2799b83224a31112d1c40f1", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ms", "methods": [ { "html": "wan2.7-image-proModel untuk menghasilkan imej daripada arahan teks. Pengeluar menyediakan kawalan palet warna dan resolusi sehingga 4K untuk penjanaan biasa daripada teks.
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Wan2.7-Image-Pro ialah model Alibaba untuk menghasilkan imej daripada teks. Kad Ailoot semasa menerbitkan input teks dan hasil berbentuk imej. Pengeluar turut menyediakan penyuntingan, penggabungan rujukan dan perubahan setempat; kaedah ini memerlukan sokongan input imej yang berasingan dan tidak disediakan oleh kaedah semasa pada kad ini.
Dalam mod rujukan pengeluar, sehingga sembilan imej asal boleh dihantar bersama penerangan tentang unsur setiap imej yang perlu digunakan. Semasa penyuntingan, model mengekalkan objek utama, mengubah butiran yang dipilih atau membina komposisi baharu daripada beberapa bahan. Untuk mengarahkan perubahan dengan lebih tepat, sehingga dua kawasan segi empat tepat boleh ditandakan pada satu imej input.
Di luar siri berurutan, palet dengan 3–10 warna boleh ditetapkan. Mod penaakulan digunakan untuk penjanaan biasa daripada teks tanpa rujukan dan tanpa siri berurutan: model menganalisis penerangan adegan terlebih dahulu.
Dalam spesifikasi Alibaba, output biasa merangkumi satu hingga empat imej. Bagi siri bercerita, had atas sehingga 12 boleh ditetapkan; model memilih bilangan sebenar berdasarkan arahan. Siri boleh mengambil kira teks dan rujukan untuk mengekalkan ciri watak yang sama serta perkembangan cerita yang berkait. Palet dan penaakulan tidak digunakan dalam mod ini.
Tahap 4K disokong untuk penjanaan biasa daripada teks tanpa rujukan dan tanpa siri berurutan. Penyuntingan berdasarkan imej dan siri berurutan dihadkan kepada tahap 2K. Label ini menentukan keluasan piksel, bukannya panjang yang sama bagi setiap sisi. Format bingkai boleh dipilih dari 1:8 hingga 8:1; semasa penyuntingan dengan resolusi pratetap, nisbah aspek mengikut rujukan terakhir. Hasil disimpan dalam PNG.
Bagi kaedah yang menggunakan imej input, Alibaba membenarkan JPEG, JPG, PNG tanpa ketelusan, BMP dan WEBP. Hadnya ialah 20 MB bagi setiap fail, dari 240 hingga 8000 piksel bagi setiap sisi dan nisbah dari 1:8 hingga 8:1. Arahan teks menyokong bahasa Cina dan Inggeris; had maksimum ialah 5000 aksara, dengan bahagian berlebihan dipotong. Penerangan negatif dan peluasan arahan tidak disediakan bagi versi ini. Nilai benih rawak awal membantu mengekalkan keserupaan variasi, tetapi tidak menjamin penghasilan semula secara tepat.
POST /v1/images/generationstextimage| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had wan2.7-image-pro | Lalai— |
Medanprompt | Jenisstring | KeperluanDiperlukan | Nilai & had Panjang minimum: 1 | Lalai— |
Medann | Jenisinteger | KeperluanPilihan | Nilai & had Minimum: 1 | Lalai1 |
Medanresponse_format | Jenisstring | KeperluanPilihan | Nilai & had url, b64_json | Lalai— |
Medanstream | Jenisboolean | KeperluanPilihan | Nilai & had | Lalaifalse |
Medansize | Jenisstring | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanpartial_images | Jenisinteger | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanimages[].image_url | Jenisstring | KeperluanTidak disokong | Nilai & had Bait ternyahkod maksimum: 20,971,520 Jenis MIME: image/png, image/jpeg Imej maksimum setiap tatasusunan: 9 Syarat: Satu URL sebenar bagi setiap objek images[]. Bilangan item tatasusunan berbeza daripada nod daun rentetan ini. Terpakai apabila: Hanya JSON images/edits; JSON images/generations tidak menghuraikan rujukan images. | Lalai— |
Medanimage | Jenisfile | KeperluanPilihan | Nilai & had Bait ternyahkod maksimum: 20,971,520 Jenis MIME: image/png, image/jpeg Terpakai apabila: penjanaan multipart/form-data | Lalai— |
Medanimage[] | Jenisfile[] | KeperluanPilihan | Nilai & had Item maksimum: 9 Bait ternyahkod maksimum: 20,971,520 Jenis MIME: image/png, image/jpeg Terpakai apabila: penjanaan multipart/form-data | Lalai— |
Teks kepada imej · Diperlukan: prompt
reference_images_generation · Diperlukan: prompt
| Parameter | Kontrak |
|---|---|
Parametermaterial_types | Kontraktext |
Parameterrequired | Kontrakmodel, prompt |
Parameteroptional_controls | Kontraknull |
Parametercontent_type | Kontrakapplication/json |
Kitar hayat: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id sebenar yang dikembalikan atau rekod pustaka media
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Struktur kaedah dan ID adalah tepat; keupayaan pembekal berasingan daripada penerimaan permintaan.
POST /v1/images/generationsAiloot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. Cara rizab dan penyelesaian caj berfungsi →
Jadual rujukan peringkat model tidak mengubah pemilihan kaedah, sebut harga atau caj. Caj aktif menggunakan kadar kaedah Ailoot yang dipilih.
| Konfigurasi | Syarat pengebilan | Caj |
|---|---|---|
| Konfigurasiwan2.7-image-pro · Konfigurasi lalai | Syarat pengebilanKonfigurasi lalai | Caj Input · Input USD 0.00 bagi setiap panggilan Output · Output USD 0.16 bagi setiap panggilan |
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");\nMuat turun setiap imej yang dikembalikan atau simpan kandungan Base64-nya
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Simpan setiap imej yang selesai; dapatkan setiap URL yang dikembalikan atau nyahkod kandungan Base64-nya.
Simpan setiap item data. Nyahkod setiap b64_json atau dapatkan setiap URL bertandatangan yang dikembalikan. Pilih sambungan nama fail berdasarkan MIME/bait sebenar.
Jika hasil penjanaan atau penyuntingan imej memerlukan semakan, simpan operation_id/X-Client-Request-ID asal serta maklumat hasil yang dikembalikan. Pulihkan hasil sedia ada milik anda melalui pustaka media menggunakan nilai task_id atau asset_id sebenar. Jangan hantar semula permintaan penjanaan/penyuntingan atau bina URL tinjauan status daripada operation_id.
| Medan | Jenis |
|---|---|
Medancreated | Jenisinteger |
Medandata[].url | Jenisstring |
Medandata[].b64_json | Jenisbase64 string |
Medanusage | Jenisobject |
| Respons | Syarat | Langkah seterusnya |
|---|---|---|
Respons400 · invalid_request_error | SyaratMedan wajib, perwakilan bahan atau nilai parameter tidak sah | Langkah seterusnyaBetulkan medan yang ditunjukkan sebelum permintaan penciptaan baharu. |
Responsserver_error | SyaratRespons yang dikembalikan menyatakan bahawa operasi atau hasil memerlukan semakan | Langkah seterusnyaSimpan ID operasi/tugas asal yang dikembalikan, pengepala permintaan dan respons; teruskan pembacaan yang disokong bagi operasi asal tersebut. Jangan hantar semula permintaan penciptaan. |
Ailoot wan2.7-image-pro, wan-image, wan-image-latest
Gunakan laluan kaedah yang dipaparkan di atas.
wan-imageModel untuk menghasilkan imej daripada arahan teks. Pengeluar menyediakan kawalan palet warna dan resolusi sehingga 4K untuk penjanaan biasa daripada teks.
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Wan2.7-Image-Pro ialah model Alibaba untuk menghasilkan imej daripada teks. Kad Ailoot semasa menerbitkan input teks dan hasil berbentuk imej. Pengeluar turut menyediakan penyuntingan, penggabungan rujukan dan perubahan setempat; kaedah ini memerlukan sokongan input imej yang berasingan dan tidak disediakan oleh kaedah semasa pada kad ini.
Dalam mod rujukan pengeluar, sehingga sembilan imej asal boleh dihantar bersama penerangan tentang unsur setiap imej yang perlu digunakan. Semasa penyuntingan, model mengekalkan objek utama, mengubah butiran yang dipilih atau membina komposisi baharu daripada beberapa bahan. Untuk mengarahkan perubahan dengan lebih tepat, sehingga dua kawasan segi empat tepat boleh ditandakan pada satu imej input.
Di luar siri berurutan, palet dengan 3–10 warna boleh ditetapkan. Mod penaakulan digunakan untuk penjanaan biasa daripada teks tanpa rujukan dan tanpa siri berurutan: model menganalisis penerangan adegan terlebih dahulu.
Dalam spesifikasi Alibaba, output biasa merangkumi satu hingga empat imej. Bagi siri bercerita, had atas sehingga 12 boleh ditetapkan; model memilih bilangan sebenar berdasarkan arahan. Siri boleh mengambil kira teks dan rujukan untuk mengekalkan ciri watak yang sama serta perkembangan cerita yang berkait. Palet dan penaakulan tidak digunakan dalam mod ini.
Tahap 4K disokong untuk penjanaan biasa daripada teks tanpa rujukan dan tanpa siri berurutan. Penyuntingan berdasarkan imej dan siri berurutan dihadkan kepada tahap 2K. Label ini menentukan keluasan piksel, bukannya panjang yang sama bagi setiap sisi. Format bingkai boleh dipilih dari 1:8 hingga 8:1; semasa penyuntingan dengan resolusi pratetap, nisbah aspek mengikut rujukan terakhir. Hasil disimpan dalam PNG.
Bagi kaedah yang menggunakan imej input, Alibaba membenarkan JPEG, JPG, PNG tanpa ketelusan, BMP dan WEBP. Hadnya ialah 20 MB bagi setiap fail, dari 240 hingga 8000 piksel bagi setiap sisi dan nisbah dari 1:8 hingga 8:1. Arahan teks menyokong bahasa Cina dan Inggeris; had maksimum ialah 5000 aksara, dengan bahagian berlebihan dipotong. Penerangan negatif dan peluasan arahan tidak disediakan bagi versi ini. Nilai benih rawak awal membantu mengekalkan keserupaan variasi, tetapi tidak menjamin penghasilan semula secara tepat.
POST /v1/images/generationstextimage| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had wan-image | Lalai— |
Medanprompt | Jenisstring | KeperluanDiperlukan | Nilai & had Panjang minimum: 1 | Lalai— |
Medann | Jenisinteger | KeperluanPilihan | Nilai & had Minimum: 1 | Lalai1 |
Medanresponse_format | Jenisstring | KeperluanPilihan | Nilai & had url, b64_json | Lalai— |
Medanstream | Jenisboolean | KeperluanPilihan | Nilai & had | Lalaifalse |
Medansize | Jenisstring | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanpartial_images | Jenisinteger | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanimages[].image_url | Jenisstring | KeperluanTidak disokong | Nilai & had Bait ternyahkod maksimum: 20,971,520 Jenis MIME: image/png, image/jpeg Imej maksimum setiap tatasusunan: 9 Syarat: Satu URL sebenar bagi setiap objek images[]. Bilangan item tatasusunan berbeza daripada nod daun rentetan ini. Terpakai apabila: Hanya JSON images/edits; JSON images/generations tidak menghuraikan rujukan images. | Lalai— |
Medanimage | Jenisfile | KeperluanPilihan | Nilai & had Bait ternyahkod maksimum: 20,971,520 Jenis MIME: image/png, image/jpeg Terpakai apabila: penjanaan multipart/form-data | Lalai— |
Medanimage[] | Jenisfile[] | KeperluanPilihan | Nilai & had Item maksimum: 9 Bait ternyahkod maksimum: 20,971,520 Jenis MIME: image/png, image/jpeg Terpakai apabila: penjanaan multipart/form-data | Lalai— |
Teks kepada imej · Diperlukan: prompt
reference_images_generation · Diperlukan: prompt
| Parameter | Kontrak |
|---|---|
Parametermaterial_types | Kontraktext |
Parameterrequired | Kontrakmodel, prompt |
Parameteroptional_controls | Kontraknull |
Parametercontent_type | Kontrakapplication/json |
Kitar hayat: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id sebenar yang dikembalikan atau rekod pustaka media
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Struktur kaedah dan ID adalah tepat; keupayaan pembekal berasingan daripada penerimaan permintaan.
POST /v1/images/generationsAiloot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. Cara rizab dan penyelesaian caj berfungsi →
Jadual rujukan peringkat model tidak mengubah pemilihan kaedah, sebut harga atau caj. Caj aktif menggunakan kadar kaedah Ailoot yang dipilih.
| Konfigurasi | Syarat pengebilan | Caj |
|---|---|---|
| Konfigurasiwan2.7-image-pro · Konfigurasi lalai | Syarat pengebilanKonfigurasi lalai | Caj Input · Input USD 0.00 bagi setiap panggilan Output · Output USD 0.16 bagi setiap panggilan |
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");\nMuat turun setiap imej yang dikembalikan atau simpan kandungan Base64-nya
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Simpan setiap imej yang selesai; dapatkan setiap URL yang dikembalikan atau nyahkod kandungan Base64-nya.
Simpan setiap item data. Nyahkod setiap b64_json atau dapatkan setiap URL bertandatangan yang dikembalikan. Pilih sambungan nama fail berdasarkan MIME/bait sebenar.
Jika hasil penjanaan atau penyuntingan imej memerlukan semakan, simpan operation_id/X-Client-Request-ID asal serta maklumat hasil yang dikembalikan. Pulihkan hasil sedia ada milik anda melalui pustaka media menggunakan nilai task_id atau asset_id sebenar. Jangan hantar semula permintaan penjanaan/penyuntingan atau bina URL tinjauan status daripada operation_id.
| Medan | Jenis |
|---|---|
Medancreated | Jenisinteger |
Medandata[].url | Jenisstring |
Medandata[].b64_json | Jenisbase64 string |
Medanusage | Jenisobject |
| Respons | Syarat | Langkah seterusnya |
|---|---|---|
Respons400 · invalid_request_error | SyaratMedan wajib, perwakilan bahan atau nilai parameter tidak sah | Langkah seterusnyaBetulkan medan yang ditunjukkan sebelum permintaan penciptaan baharu. |
Responsserver_error | SyaratRespons yang dikembalikan menyatakan bahawa operasi atau hasil memerlukan semakan | Langkah seterusnyaSimpan ID operasi/tugas asal yang dikembalikan, pengepala permintaan dan respons; teruskan pembacaan yang disokong bagi operasi asal tersebut. Jangan hantar semula permintaan penciptaan. |
Ailoot wan2.7-image-pro, wan-image, wan-image-latest
Gunakan laluan kaedah yang dipaparkan di atas.
wan-image-latestModel untuk menghasilkan imej daripada arahan teks. Pengeluar menyediakan kawalan palet warna dan resolusi sehingga 4K untuk penjanaan biasa daripada teks.
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Wan2.7-Image-Pro ialah model Alibaba untuk menghasilkan imej daripada teks. Kad Ailoot semasa menerbitkan input teks dan hasil berbentuk imej. Pengeluar turut menyediakan penyuntingan, penggabungan rujukan dan perubahan setempat; kaedah ini memerlukan sokongan input imej yang berasingan dan tidak disediakan oleh kaedah semasa pada kad ini.
Dalam mod rujukan pengeluar, sehingga sembilan imej asal boleh dihantar bersama penerangan tentang unsur setiap imej yang perlu digunakan. Semasa penyuntingan, model mengekalkan objek utama, mengubah butiran yang dipilih atau membina komposisi baharu daripada beberapa bahan. Untuk mengarahkan perubahan dengan lebih tepat, sehingga dua kawasan segi empat tepat boleh ditandakan pada satu imej input.
Di luar siri berurutan, palet dengan 3–10 warna boleh ditetapkan. Mod penaakulan digunakan untuk penjanaan biasa daripada teks tanpa rujukan dan tanpa siri berurutan: model menganalisis penerangan adegan terlebih dahulu.
Dalam spesifikasi Alibaba, output biasa merangkumi satu hingga empat imej. Bagi siri bercerita, had atas sehingga 12 boleh ditetapkan; model memilih bilangan sebenar berdasarkan arahan. Siri boleh mengambil kira teks dan rujukan untuk mengekalkan ciri watak yang sama serta perkembangan cerita yang berkait. Palet dan penaakulan tidak digunakan dalam mod ini.
Tahap 4K disokong untuk penjanaan biasa daripada teks tanpa rujukan dan tanpa siri berurutan. Penyuntingan berdasarkan imej dan siri berurutan dihadkan kepada tahap 2K. Label ini menentukan keluasan piksel, bukannya panjang yang sama bagi setiap sisi. Format bingkai boleh dipilih dari 1:8 hingga 8:1; semasa penyuntingan dengan resolusi pratetap, nisbah aspek mengikut rujukan terakhir. Hasil disimpan dalam PNG.
Bagi kaedah yang menggunakan imej input, Alibaba membenarkan JPEG, JPG, PNG tanpa ketelusan, BMP dan WEBP. Hadnya ialah 20 MB bagi setiap fail, dari 240 hingga 8000 piksel bagi setiap sisi dan nisbah dari 1:8 hingga 8:1. Arahan teks menyokong bahasa Cina dan Inggeris; had maksimum ialah 5000 aksara, dengan bahagian berlebihan dipotong. Penerangan negatif dan peluasan arahan tidak disediakan bagi versi ini. Nilai benih rawak awal membantu mengekalkan keserupaan variasi, tetapi tidak menjamin penghasilan semula secara tepat.
POST /v1/images/generationstextimage| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had wan-image-latest | Lalai— |
Medanprompt | Jenisstring | KeperluanDiperlukan | Nilai & had Panjang minimum: 1 | Lalai— |
Medann | Jenisinteger | KeperluanPilihan | Nilai & had Minimum: 1 | Lalai1 |
Medanresponse_format | Jenisstring | KeperluanPilihan | Nilai & had url, b64_json | Lalai— |
Medanstream | Jenisboolean | KeperluanPilihan | Nilai & had | Lalaifalse |
Medansize | Jenisstring | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanpartial_images | Jenisinteger | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanimages[].image_url | Jenisstring | KeperluanTidak disokong | Nilai & had Bait ternyahkod maksimum: 20,971,520 Jenis MIME: image/png, image/jpeg Imej maksimum setiap tatasusunan: 9 Syarat: Satu URL sebenar bagi setiap objek images[]. Bilangan item tatasusunan berbeza daripada nod daun rentetan ini. Terpakai apabila: Hanya JSON images/edits; JSON images/generations tidak menghuraikan rujukan images. | Lalai— |
Medanimage | Jenisfile | KeperluanPilihan | Nilai & had Bait ternyahkod maksimum: 20,971,520 Jenis MIME: image/png, image/jpeg Terpakai apabila: penjanaan multipart/form-data | Lalai— |
Medanimage[] | Jenisfile[] | KeperluanPilihan | Nilai & had Item maksimum: 9 Bait ternyahkod maksimum: 20,971,520 Jenis MIME: image/png, image/jpeg Terpakai apabila: penjanaan multipart/form-data | Lalai— |
Teks kepada imej · Diperlukan: prompt
reference_images_generation · Diperlukan: prompt
| Parameter | Kontrak |
|---|---|
Parametermaterial_types | Kontraktext |
Parameterrequired | Kontrakmodel, prompt |
Parameteroptional_controls | Kontraknull |
Parametercontent_type | Kontrakapplication/json |
Kitar hayat: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id sebenar yang dikembalikan atau rekod pustaka media
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Struktur kaedah dan ID adalah tepat; keupayaan pembekal berasingan daripada penerimaan permintaan.
POST /v1/images/generationsAiloot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. Cara rizab dan penyelesaian caj berfungsi →
Jadual rujukan peringkat model tidak mengubah pemilihan kaedah, sebut harga atau caj. Caj aktif menggunakan kadar kaedah Ailoot yang dipilih.
| Konfigurasi | Syarat pengebilan | Caj |
|---|---|---|
| Konfigurasiwan2.7-image-pro · Konfigurasi lalai | Syarat pengebilanKonfigurasi lalai | Caj Input · Input USD 0.00 bagi setiap panggilan Output · Output USD 0.16 bagi setiap panggilan |
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");\nMuat turun setiap imej yang dikembalikan atau simpan kandungan Base64-nya
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Simpan setiap imej yang selesai; dapatkan setiap URL yang dikembalikan atau nyahkod kandungan Base64-nya.
Simpan setiap item data. Nyahkod setiap b64_json atau dapatkan setiap URL bertandatangan yang dikembalikan. Pilih sambungan nama fail berdasarkan MIME/bait sebenar.
Jika hasil penjanaan atau penyuntingan imej memerlukan semakan, simpan operation_id/X-Client-Request-ID asal serta maklumat hasil yang dikembalikan. Pulihkan hasil sedia ada milik anda melalui pustaka media menggunakan nilai task_id atau asset_id sebenar. Jangan hantar semula permintaan penjanaan/penyuntingan atau bina URL tinjauan status daripada operation_id.
| Medan | Jenis |
|---|---|
Medancreated | Jenisinteger |
Medandata[].url | Jenisstring |
Medandata[].b64_json | Jenisbase64 string |
Medanusage | Jenisobject |
| Respons | Syarat | Langkah seterusnya |
|---|---|---|
Respons400 · invalid_request_error | SyaratMedan wajib, perwakilan bahan atau nilai parameter tidak sah | Langkah seterusnyaBetulkan medan yang ditunjukkan sebelum permintaan penciptaan baharu. |
Responsserver_error | SyaratRespons yang dikembalikan menyatakan bahawa operasi atau hasil memerlukan semakan | Langkah seterusnyaSimpan ID operasi/tugas asal yang dikembalikan, pengepala permintaan dan respons; teruskan pembacaan yang disokong bagi operasi asal tersebut. Jangan hantar semula permintaan penciptaan. |
Ailoot wan2.7-image-pro, wan-image, wan-image-latest
Gunakan laluan kaedah yang dipaparkan di atas.