Wan2.7-Image-Pro adalah model Alibaba untuk membuat gambar dari teks. Kartu Ailoot saat ini memublikasikan masukan teks dan hasil berupa gambar. Produsen juga menyediakan penyuntingan, penggabungan referensi, dan perubahan lokal; cara-cara tersebut memerlukan dukungan gambar masukan tersendiri dan tidak tersedia pada metode dalam kartu saat ini.
Dalam mode dengan referensi pada layanan produsen, hingga sembilan gambar sumber dapat dikirim dengan deskripsi tentang unsur mana dari setiap gambar yang perlu digunakan. Saat menyunting, model mempertahankan objek utama, mengubah detail yang dipilih, atau menyusun komposisi baru dari beberapa materi. Untuk mengarahkan perubahan dengan lebih tepat, hingga dua area persegi panjang dapat ditandai pada satu gambar masukan.
Di luar seri berurutan, palet dengan 3–10 warna dapat ditentukan. Mode penalaran ditujukan untuk pembuatan gambar biasa dari teks tanpa referensi atau seri berurutan: model menganalisis deskripsi adegan terlebih dahulu.
Dalam spesifikasi Alibaba, keluaran biasa mencakup satu hingga empat gambar. Untuk seri cerita, batas atas dapat ditetapkan hingga 12; jumlah sebenarnya dipilih model berdasarkan instruksi. Seri dapat mempertimbangkan teks dan referensi untuk mempertahankan ciri karakter yang sama serta perkembangan cerita yang koheren. Palet dan penalaran tidak digunakan dalam mode ini.
Tingkat 4K didukung untuk pembuatan gambar biasa dari teks tanpa referensi atau seri berurutan. Penyuntingan berbasis gambar dan seri berurutan dibatasi pada tingkat 2K. Penamaan ini menentukan luas piksel, bukan panjang yang sama untuk setiap sisi. Format bingkai dapat dipilih dari 1:8 hingga 8:1; saat menyunting dengan resolusi yang telah ditentukan, rasio aspek mengikuti referensi terakhir. Hasil disimpan dalam PNG.
Untuk metode dengan gambar masukan, Alibaba menerima JPEG, JPG, PNG tanpa transparansi, BMP, dan WEBP. Batasnya adalah 20 MB per berkas, 240 hingga 8000 piksel untuk setiap sisi, dan rasio dari 1:8 hingga 8:1. Instruksi teks mendukung bahasa Tionghoa dan Inggris; panjang maksimum adalah 5000 karakter, dengan bagian yang melebihi batas dibuang. Deskripsi negatif dan perluasan instruksi tidak tersedia dalam versi ini. Nilai awal keacakan membantu mempertahankan kemiripan variasi, tetapi tidak menjamin pengulangan yang persis sama.
", "aboutText": "Wan2.7-Image-Pro adalah model Alibaba untuk membuat gambar dari teks. Kartu Ailoot saat ini memublikasikan masukan teks dan hasil berupa gambar. Produsen juga menyediakan penyuntingan, penggabungan referensi, dan perubahan lokal; cara-cara tersebut memerlukan dukungan gambar masukan tersendiri dan tidak tersedia pada metode dalam kartu saat ini.\n\nDalam mode dengan referensi pada layanan produsen, hingga sembilan gambar sumber dapat dikirim dengan deskripsi tentang unsur mana dari setiap gambar yang perlu digunakan. Saat menyunting, model mempertahankan objek utama, mengubah detail yang dipilih, atau menyusun komposisi baru dari beberapa materi. Untuk mengarahkan perubahan dengan lebih tepat, hingga dua area persegi panjang dapat ditandai pada satu gambar masukan.\n\n### Palet dan instruksi kompleks\n\nDi luar seri berurutan, palet dengan 3–10 warna dapat ditentukan. Mode penalaran ditujukan untuk pembuatan gambar biasa dari teks tanpa referensi atau seri berurutan: model menganalisis deskripsi adegan terlebih dahulu.\n\nDalam spesifikasi Alibaba, keluaran biasa mencakup satu hingga empat gambar. Untuk seri cerita, batas atas dapat ditetapkan hingga 12; jumlah sebenarnya dipilih model berdasarkan instruksi. Seri dapat mempertimbangkan teks dan referensi untuk mempertahankan ciri karakter yang sama serta perkembangan cerita yang koheren. Palet dan penalaran tidak digunakan dalam mode ini.\n\n### Resolusi bergantung pada mode\n\nTingkat 4K didukung untuk pembuatan gambar biasa dari teks tanpa referensi atau seri berurutan. Penyuntingan berbasis gambar dan seri berurutan dibatasi pada tingkat 2K. Penamaan ini menentukan luas piksel, bukan panjang yang sama untuk setiap sisi. Format bingkai dapat dipilih dari 1:8 hingga 8:1; saat menyunting dengan resolusi yang telah ditentukan, rasio aspek mengikuti referensi terakhir. Hasil disimpan dalam PNG.\n\nUntuk metode dengan gambar masukan, Alibaba menerima JPEG, JPG, PNG tanpa transparansi, BMP, dan WEBP. Batasnya adalah 20 MB per berkas, 240 hingga 8000 piksel untuk setiap sisi, dan rasio dari 1:8 hingga 8:1. Instruksi teks mendukung bahasa Tionghoa dan Inggris; panjang maksimum adalah 5000 karakter, dengan bagian yang melebihi batas dibuang. Deskripsi negatif dan perluasan instruksi tidak tersedia dalam versi ini. Nilai awal keacakan membantu mempertahankan kemiripan variasi, tetapi tidak menjamin pengulangan yang persis sama.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "9e1ffeae61bd06e7757c354d4f64e74b893f804af3e00239245217d4e5da393d", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "id", "methods": [ { "html": "wan2.7-image-proModel pembuat gambar dari instruksi teks. Produsen menyediakan pengaturan palet warna dan resolusi hingga 4K untuk pembuatan gambar biasa dari teks.
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Wan2.7-Image-Pro adalah model Alibaba untuk membuat gambar dari teks. Kartu Ailoot saat ini memublikasikan masukan teks dan hasil berupa gambar. Produsen juga menyediakan penyuntingan, penggabungan referensi, dan perubahan lokal; cara-cara tersebut memerlukan dukungan gambar masukan tersendiri dan tidak tersedia pada metode dalam kartu saat ini.
Dalam mode dengan referensi pada layanan produsen, hingga sembilan gambar sumber dapat dikirim dengan deskripsi tentang unsur mana dari setiap gambar yang perlu digunakan. Saat menyunting, model mempertahankan objek utama, mengubah detail yang dipilih, atau menyusun komposisi baru dari beberapa materi. Untuk mengarahkan perubahan dengan lebih tepat, hingga dua area persegi panjang dapat ditandai pada satu gambar masukan.
Di luar seri berurutan, palet dengan 3–10 warna dapat ditentukan. Mode penalaran ditujukan untuk pembuatan gambar biasa dari teks tanpa referensi atau seri berurutan: model menganalisis deskripsi adegan terlebih dahulu.
Dalam spesifikasi Alibaba, keluaran biasa mencakup satu hingga empat gambar. Untuk seri cerita, batas atas dapat ditetapkan hingga 12; jumlah sebenarnya dipilih model berdasarkan instruksi. Seri dapat mempertimbangkan teks dan referensi untuk mempertahankan ciri karakter yang sama serta perkembangan cerita yang koheren. Palet dan penalaran tidak digunakan dalam mode ini.
Tingkat 4K didukung untuk pembuatan gambar biasa dari teks tanpa referensi atau seri berurutan. Penyuntingan berbasis gambar dan seri berurutan dibatasi pada tingkat 2K. Penamaan ini menentukan luas piksel, bukan panjang yang sama untuk setiap sisi. Format bingkai dapat dipilih dari 1:8 hingga 8:1; saat menyunting dengan resolusi yang telah ditentukan, rasio aspek mengikuti referensi terakhir. Hasil disimpan dalam PNG.
Untuk metode dengan gambar masukan, Alibaba menerima JPEG, JPG, PNG tanpa transparansi, BMP, dan WEBP. Batasnya adalah 20 MB per berkas, 240 hingga 8000 piksel untuk setiap sisi, dan rasio dari 1:8 hingga 8:1. Instruksi teks mendukung bahasa Tionghoa dan Inggris; panjang maksimum adalah 5000 karakter, dengan bagian yang melebihi batas dibuang. Deskripsi negatif dan perluasan instruksi tidak tersedia dalam versi ini. Nilai awal keacakan membantu mempertahankan kemiripan variasi, tetapi tidak menjamin pengulangan yang persis sama.
POST /v1/images/generationstextimage| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan wan2.7-image-pro | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanWajib | Nilai & batasan Panjang minimum: 1 | Bawaan— |
Kolomn | Jenisinteger | PersyaratanOpsional | Nilai & batasan Minimum: 1 | Bawaan1 |
Kolomresponse_format | Jenisstring | PersyaratanOpsional | Nilai & batasan url, b64_json | Bawaan— |
Kolomstream | Jenisboolean | PersyaratanOpsional | Nilai & batasan | Bawaanfalse |
Kolomsize | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolompartial_images | Jenisinteger | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomimages[].image_url | Jenisstring | PersyaratanTidak didukung | Nilai & batasan Byte terdekode maksimum: 20.971.520 Jenis MIME: image/png, image/jpeg Gambar maksimum per larik: 9 Kondisi: Satu URL aktual per objek images[]. Jumlah item array berbeda dari nilai string ini. Berlaku jika: Hanya JSON images/edits; JSON images/generations tidak mengurai referensi images. | Bawaan— |
Kolomimage | Jenisfile | PersyaratanOpsional | Nilai & batasan Byte terdekode maksimum: 20.971.520 Jenis MIME: image/png, image/jpeg Berlaku jika: pembuatan dengan multipart/form-data | Bawaan— |
Kolomimage[] | Jenisfile[] | PersyaratanOpsional | Nilai & batasan Item maksimum: 9 Byte terdekode maksimum: 20.971.520 Jenis MIME: image/png, image/jpeg Berlaku jika: pembuatan dengan multipart/form-data | Bawaan— |
Teks ke gambar · Wajib: prompt
reference_images_generation · Wajib: prompt
| Parameter | Kontrak |
|---|---|
Parametermaterial_types | Kontraktext |
Parameterrequired | Kontrakmodel, prompt |
Parameteroptional_controls | Kontraknull |
Parametercontent_type | Kontrakapplication/json |
Siklus hidup: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id aktual yang dikembalikan atau catatan pustaka media
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Struktur metode dan ID bersifat eksak; kemampuan pemasok terpisah dari penerimaan permintaan.
POST /v1/images/generationsAiloot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
Jadwal referensi tingkat model tidak mengubah pemilihan metode, estimasi harga, atau biaya. Biaya aktif menggunakan tarif metode Ailoot yang dipilih.
| Konfigurasi | Kondisi penagihan | Biaya |
|---|---|---|
| Konfigurasiwan2.7-image-pro · Konfigurasi bawaan | Kondisi penagihanKonfigurasi bawaan | Biaya Masukan · Masukan US$0,00 per pemanggilan Keluaran · Keluaran US$0,16 per pemanggilan |
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");\nUnduh setiap gambar yang dikembalikan atau simpan konten 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 gambar yang selesai; ambil setiap URL yang dikembalikan atau dekode konten Base64-nya.
Simpan setiap item data. Dekodekan setiap b64_json atau ambil data dari setiap URL bertanda tangan yang dikembalikan. Pilih ekstensi nama file berdasarkan MIME/bytes aktual.
Jika hasil pembuatan atau penyuntingan gambar perlu diperiksa, simpan operation_id/X-Client-Request-ID asli dan informasi hasil yang dikembalikan. Pulihkan hasil milik Anda yang sudah ada melalui pustaka media menggunakan nilai task_id atau asset_id aktual. Jangan mengirim ulang permintaan pembuatan/penyuntingan atau membuat URL polling dari operation_id.
| Kolom | Jenis |
|---|---|
Kolomcreated | Jenisinteger |
Kolomdata[].url | Jenisstring |
Kolomdata[].b64_json | Jenisbase64 string |
Kolomusage | Jenisobject |
| Respons | Kondisi | Langkah berikutnya |
|---|---|---|
Respons400 · invalid_request_error | KondisiBidang wajib, representasi materi, atau nilai parameter tidak valid | Langkah berikutnyaPerbaiki bidang yang ditunjukkan sebelum permintaan pembuatan baru. |
Responsserver_error | KondisiRespons yang dikembalikan menyatakan bahwa operasi atau hasil perlu diperiksa | Langkah berikutnyaSimpan ID operasi/tugas asli yang dikembalikan, header permintaan, dan respons; lanjutkan pembacaan yang didukung untuk operasi asli tersebut. Jangan kirim ulang permintaan pembuatan. |
Ailoot wan2.7-image-pro, wan-image, wan-image-latest
Gunakan jalur metode yang ditampilkan di atas.
wan-imageModel pembuat gambar dari instruksi teks. Produsen menyediakan pengaturan palet warna dan resolusi hingga 4K untuk pembuatan gambar biasa dari teks.
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Wan2.7-Image-Pro adalah model Alibaba untuk membuat gambar dari teks. Kartu Ailoot saat ini memublikasikan masukan teks dan hasil berupa gambar. Produsen juga menyediakan penyuntingan, penggabungan referensi, dan perubahan lokal; cara-cara tersebut memerlukan dukungan gambar masukan tersendiri dan tidak tersedia pada metode dalam kartu saat ini.
Dalam mode dengan referensi pada layanan produsen, hingga sembilan gambar sumber dapat dikirim dengan deskripsi tentang unsur mana dari setiap gambar yang perlu digunakan. Saat menyunting, model mempertahankan objek utama, mengubah detail yang dipilih, atau menyusun komposisi baru dari beberapa materi. Untuk mengarahkan perubahan dengan lebih tepat, hingga dua area persegi panjang dapat ditandai pada satu gambar masukan.
Di luar seri berurutan, palet dengan 3–10 warna dapat ditentukan. Mode penalaran ditujukan untuk pembuatan gambar biasa dari teks tanpa referensi atau seri berurutan: model menganalisis deskripsi adegan terlebih dahulu.
Dalam spesifikasi Alibaba, keluaran biasa mencakup satu hingga empat gambar. Untuk seri cerita, batas atas dapat ditetapkan hingga 12; jumlah sebenarnya dipilih model berdasarkan instruksi. Seri dapat mempertimbangkan teks dan referensi untuk mempertahankan ciri karakter yang sama serta perkembangan cerita yang koheren. Palet dan penalaran tidak digunakan dalam mode ini.
Tingkat 4K didukung untuk pembuatan gambar biasa dari teks tanpa referensi atau seri berurutan. Penyuntingan berbasis gambar dan seri berurutan dibatasi pada tingkat 2K. Penamaan ini menentukan luas piksel, bukan panjang yang sama untuk setiap sisi. Format bingkai dapat dipilih dari 1:8 hingga 8:1; saat menyunting dengan resolusi yang telah ditentukan, rasio aspek mengikuti referensi terakhir. Hasil disimpan dalam PNG.
Untuk metode dengan gambar masukan, Alibaba menerima JPEG, JPG, PNG tanpa transparansi, BMP, dan WEBP. Batasnya adalah 20 MB per berkas, 240 hingga 8000 piksel untuk setiap sisi, dan rasio dari 1:8 hingga 8:1. Instruksi teks mendukung bahasa Tionghoa dan Inggris; panjang maksimum adalah 5000 karakter, dengan bagian yang melebihi batas dibuang. Deskripsi negatif dan perluasan instruksi tidak tersedia dalam versi ini. Nilai awal keacakan membantu mempertahankan kemiripan variasi, tetapi tidak menjamin pengulangan yang persis sama.
POST /v1/images/generationstextimage| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan wan-image | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanWajib | Nilai & batasan Panjang minimum: 1 | Bawaan— |
Kolomn | Jenisinteger | PersyaratanOpsional | Nilai & batasan Minimum: 1 | Bawaan1 |
Kolomresponse_format | Jenisstring | PersyaratanOpsional | Nilai & batasan url, b64_json | Bawaan— |
Kolomstream | Jenisboolean | PersyaratanOpsional | Nilai & batasan | Bawaanfalse |
Kolomsize | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolompartial_images | Jenisinteger | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomimages[].image_url | Jenisstring | PersyaratanTidak didukung | Nilai & batasan Byte terdekode maksimum: 20.971.520 Jenis MIME: image/png, image/jpeg Gambar maksimum per larik: 9 Kondisi: Satu URL aktual per objek images[]. Jumlah item array berbeda dari nilai string ini. Berlaku jika: Hanya JSON images/edits; JSON images/generations tidak mengurai referensi images. | Bawaan— |
Kolomimage | Jenisfile | PersyaratanOpsional | Nilai & batasan Byte terdekode maksimum: 20.971.520 Jenis MIME: image/png, image/jpeg Berlaku jika: pembuatan dengan multipart/form-data | Bawaan— |
Kolomimage[] | Jenisfile[] | PersyaratanOpsional | Nilai & batasan Item maksimum: 9 Byte terdekode maksimum: 20.971.520 Jenis MIME: image/png, image/jpeg Berlaku jika: pembuatan dengan multipart/form-data | Bawaan— |
Teks ke gambar · Wajib: prompt
reference_images_generation · Wajib: prompt
| Parameter | Kontrak |
|---|---|
Parametermaterial_types | Kontraktext |
Parameterrequired | Kontrakmodel, prompt |
Parameteroptional_controls | Kontraknull |
Parametercontent_type | Kontrakapplication/json |
Siklus hidup: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id aktual yang dikembalikan atau catatan pustaka media
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Struktur metode dan ID bersifat eksak; kemampuan pemasok terpisah dari penerimaan permintaan.
POST /v1/images/generationsAiloot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
Jadwal referensi tingkat model tidak mengubah pemilihan metode, estimasi harga, atau biaya. Biaya aktif menggunakan tarif metode Ailoot yang dipilih.
| Konfigurasi | Kondisi penagihan | Biaya |
|---|---|---|
| Konfigurasiwan2.7-image-pro · Konfigurasi bawaan | Kondisi penagihanKonfigurasi bawaan | Biaya Masukan · Masukan US$0,00 per pemanggilan Keluaran · Keluaran US$0,16 per pemanggilan |
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");\nUnduh setiap gambar yang dikembalikan atau simpan konten 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 gambar yang selesai; ambil setiap URL yang dikembalikan atau dekode konten Base64-nya.
Simpan setiap item data. Dekodekan setiap b64_json atau ambil data dari setiap URL bertanda tangan yang dikembalikan. Pilih ekstensi nama file berdasarkan MIME/bytes aktual.
Jika hasil pembuatan atau penyuntingan gambar perlu diperiksa, simpan operation_id/X-Client-Request-ID asli dan informasi hasil yang dikembalikan. Pulihkan hasil milik Anda yang sudah ada melalui pustaka media menggunakan nilai task_id atau asset_id aktual. Jangan mengirim ulang permintaan pembuatan/penyuntingan atau membuat URL polling dari operation_id.
| Kolom | Jenis |
|---|---|
Kolomcreated | Jenisinteger |
Kolomdata[].url | Jenisstring |
Kolomdata[].b64_json | Jenisbase64 string |
Kolomusage | Jenisobject |
| Respons | Kondisi | Langkah berikutnya |
|---|---|---|
Respons400 · invalid_request_error | KondisiBidang wajib, representasi materi, atau nilai parameter tidak valid | Langkah berikutnyaPerbaiki bidang yang ditunjukkan sebelum permintaan pembuatan baru. |
Responsserver_error | KondisiRespons yang dikembalikan menyatakan bahwa operasi atau hasil perlu diperiksa | Langkah berikutnyaSimpan ID operasi/tugas asli yang dikembalikan, header permintaan, dan respons; lanjutkan pembacaan yang didukung untuk operasi asli tersebut. Jangan kirim ulang permintaan pembuatan. |
Ailoot wan2.7-image-pro, wan-image, wan-image-latest
Gunakan jalur metode yang ditampilkan di atas.
wan-image-latestModel pembuat gambar dari instruksi teks. Produsen menyediakan pengaturan palet warna dan resolusi hingga 4K untuk pembuatan gambar biasa dari teks.
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Wan2.7-Image-Pro adalah model Alibaba untuk membuat gambar dari teks. Kartu Ailoot saat ini memublikasikan masukan teks dan hasil berupa gambar. Produsen juga menyediakan penyuntingan, penggabungan referensi, dan perubahan lokal; cara-cara tersebut memerlukan dukungan gambar masukan tersendiri dan tidak tersedia pada metode dalam kartu saat ini.
Dalam mode dengan referensi pada layanan produsen, hingga sembilan gambar sumber dapat dikirim dengan deskripsi tentang unsur mana dari setiap gambar yang perlu digunakan. Saat menyunting, model mempertahankan objek utama, mengubah detail yang dipilih, atau menyusun komposisi baru dari beberapa materi. Untuk mengarahkan perubahan dengan lebih tepat, hingga dua area persegi panjang dapat ditandai pada satu gambar masukan.
Di luar seri berurutan, palet dengan 3–10 warna dapat ditentukan. Mode penalaran ditujukan untuk pembuatan gambar biasa dari teks tanpa referensi atau seri berurutan: model menganalisis deskripsi adegan terlebih dahulu.
Dalam spesifikasi Alibaba, keluaran biasa mencakup satu hingga empat gambar. Untuk seri cerita, batas atas dapat ditetapkan hingga 12; jumlah sebenarnya dipilih model berdasarkan instruksi. Seri dapat mempertimbangkan teks dan referensi untuk mempertahankan ciri karakter yang sama serta perkembangan cerita yang koheren. Palet dan penalaran tidak digunakan dalam mode ini.
Tingkat 4K didukung untuk pembuatan gambar biasa dari teks tanpa referensi atau seri berurutan. Penyuntingan berbasis gambar dan seri berurutan dibatasi pada tingkat 2K. Penamaan ini menentukan luas piksel, bukan panjang yang sama untuk setiap sisi. Format bingkai dapat dipilih dari 1:8 hingga 8:1; saat menyunting dengan resolusi yang telah ditentukan, rasio aspek mengikuti referensi terakhir. Hasil disimpan dalam PNG.
Untuk metode dengan gambar masukan, Alibaba menerima JPEG, JPG, PNG tanpa transparansi, BMP, dan WEBP. Batasnya adalah 20 MB per berkas, 240 hingga 8000 piksel untuk setiap sisi, dan rasio dari 1:8 hingga 8:1. Instruksi teks mendukung bahasa Tionghoa dan Inggris; panjang maksimum adalah 5000 karakter, dengan bagian yang melebihi batas dibuang. Deskripsi negatif dan perluasan instruksi tidak tersedia dalam versi ini. Nilai awal keacakan membantu mempertahankan kemiripan variasi, tetapi tidak menjamin pengulangan yang persis sama.
POST /v1/images/generationstextimage| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan wan-image-latest | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanWajib | Nilai & batasan Panjang minimum: 1 | Bawaan— |
Kolomn | Jenisinteger | PersyaratanOpsional | Nilai & batasan Minimum: 1 | Bawaan1 |
Kolomresponse_format | Jenisstring | PersyaratanOpsional | Nilai & batasan url, b64_json | Bawaan— |
Kolomstream | Jenisboolean | PersyaratanOpsional | Nilai & batasan | Bawaanfalse |
Kolomsize | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolompartial_images | Jenisinteger | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomimages[].image_url | Jenisstring | PersyaratanTidak didukung | Nilai & batasan Byte terdekode maksimum: 20.971.520 Jenis MIME: image/png, image/jpeg Gambar maksimum per larik: 9 Kondisi: Satu URL aktual per objek images[]. Jumlah item array berbeda dari nilai string ini. Berlaku jika: Hanya JSON images/edits; JSON images/generations tidak mengurai referensi images. | Bawaan— |
Kolomimage | Jenisfile | PersyaratanOpsional | Nilai & batasan Byte terdekode maksimum: 20.971.520 Jenis MIME: image/png, image/jpeg Berlaku jika: pembuatan dengan multipart/form-data | Bawaan— |
Kolomimage[] | Jenisfile[] | PersyaratanOpsional | Nilai & batasan Item maksimum: 9 Byte terdekode maksimum: 20.971.520 Jenis MIME: image/png, image/jpeg Berlaku jika: pembuatan dengan multipart/form-data | Bawaan— |
Teks ke gambar · Wajib: prompt
reference_images_generation · Wajib: prompt
| Parameter | Kontrak |
|---|---|
Parametermaterial_types | Kontraktext |
Parameterrequired | Kontrakmodel, prompt |
Parameteroptional_controls | Kontraknull |
Parametercontent_type | Kontrakapplication/json |
Siklus hidup: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id aktual yang dikembalikan atau catatan pustaka media
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Struktur metode dan ID bersifat eksak; kemampuan pemasok terpisah dari penerimaan permintaan.
POST /v1/images/generationsAiloot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
Jadwal referensi tingkat model tidak mengubah pemilihan metode, estimasi harga, atau biaya. Biaya aktif menggunakan tarif metode Ailoot yang dipilih.
| Konfigurasi | Kondisi penagihan | Biaya |
|---|---|---|
| Konfigurasiwan2.7-image-pro · Konfigurasi bawaan | Kondisi penagihanKonfigurasi bawaan | Biaya Masukan · Masukan US$0,00 per pemanggilan Keluaran · Keluaran US$0,16 per pemanggilan |
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");\nUnduh setiap gambar yang dikembalikan atau simpan konten 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 gambar yang selesai; ambil setiap URL yang dikembalikan atau dekode konten Base64-nya.
Simpan setiap item data. Dekodekan setiap b64_json atau ambil data dari setiap URL bertanda tangan yang dikembalikan. Pilih ekstensi nama file berdasarkan MIME/bytes aktual.
Jika hasil pembuatan atau penyuntingan gambar perlu diperiksa, simpan operation_id/X-Client-Request-ID asli dan informasi hasil yang dikembalikan. Pulihkan hasil milik Anda yang sudah ada melalui pustaka media menggunakan nilai task_id atau asset_id aktual. Jangan mengirim ulang permintaan pembuatan/penyuntingan atau membuat URL polling dari operation_id.
| Kolom | Jenis |
|---|---|
Kolomcreated | Jenisinteger |
Kolomdata[].url | Jenisstring |
Kolomdata[].b64_json | Jenisbase64 string |
Kolomusage | Jenisobject |
| Respons | Kondisi | Langkah berikutnya |
|---|---|---|
Respons400 · invalid_request_error | KondisiBidang wajib, representasi materi, atau nilai parameter tidak valid | Langkah berikutnyaPerbaiki bidang yang ditunjukkan sebelum permintaan pembuatan baru. |
Responsserver_error | KondisiRespons yang dikembalikan menyatakan bahwa operasi atau hasil perlu diperiksa | Langkah berikutnyaSimpan ID operasi/tugas asli yang dikembalikan, header permintaan, dan respons; lanjutkan pembacaan yang didukung untuk operasi asli tersebut. Jangan kirim ulang permintaan pembuatan. |
Ailoot wan2.7-image-pro, wan-image, wan-image-latest
Gunakan jalur metode yang ditampilkan di atas.