Wan2.7-Image menghasilkan imej daripada arahan teks. Kad Ailoot semasa menyediakan khususnya input teks dan hasil berbentuk imej. Menurut Alibaba, versi ini menumpukan penghasilan variasi yang lebih pantas. Spesifikasi pengeluar turut menyediakan penyuntingan, penggabungan rujukan dan perubahan setempat; operasi ini memerlukan sokongan input imej yang berasingan dan tidak disediakan oleh kaedah semasa pada kad ini.
Bagi mod rujukan, Alibaba menyediakan sehingga sembilan imej asal dalam satu arahan. Imej ini menjadi panduan rupa objek, komposisi dan butiran. Model boleh menggabungkan beberapa bahan menjadi adegan baharu atau mengubah imej asal sambil mengekalkan objek utama. Untuk penyuntingan khusus, kawasan yang ditandakan secara jelas disediakan: sehingga dua kawasan segi empat tepat boleh ditentukan pada satu imej.
Dalam spesifikasi Alibaba, mod biasa menghasilkan satu hingga empat hasil. Siri berurutan membolehkan sehingga 12 imej diminta, dengan hubungan melalui cerita atau ciri watak yang sama. Bagi siri, ini ialah had atas: model menentukan sendiri bilangan bingkai yang diperlukan dan boleh mengembalikan bilangan yang lebih kecil. Arahan dan bahan asal membantu mengekalkan jalan cerita bersama.
Mod penaakulan disediakan untuk penjanaan biasa daripada teks tanpa rujukan dan tanpa siri berurutan. Dalam mod ini, model menganalisis penerangan rumit dengan lebih terperinci sebelum menghasilkan imej. Mod ini tidak digunakan semasa penyuntingan berdasarkan imej atau dalam siri berurutan. Palet yang ditetapkan dengan 3–10 warna tersedia di luar siri berurutan.
Dalam mod yang menggunakan imej asal, sistem pengeluar menyokong JPEG, JPG, PNG tanpa ketelusan, BMP dan WEBP. Setiap sisi boleh mengandungi dari 240 hingga 8000 piksel, saiz fail sehingga 20 MB dan nisbah aspek dari 1:8 hingga 8:1.
Arahan teks menyokong bahasa Cina dan Inggeris serta dihadkan kepada 5000 aksara; bahagian berlebihan dipotong. Penerangan negatif dan peluasan arahan tambahan tidak disediakan bagi versi ini.
Format output ialah PNG, dengan resolusi sehingga tahap 2K. Label ini merujuk kepada jumlah keluasan piksel, bukannya panjang sisi maksimum yang tetap; bentuk boleh dipilih dalam julat dari 1:8 hingga 8:1. Semasa penyuntingan dengan resolusi pratetap, hasil mengekalkan nisbah aspek rujukan terakhir. Nilai benih rawak awal yang sama membantu mendapatkan variasi yang serupa, tetapi tidak menjamin padanan sepenuhnya.
", "aboutText": "Wan2.7-Image menghasilkan imej daripada arahan teks. Kad Ailoot semasa menyediakan khususnya input teks dan hasil berbentuk imej. Menurut Alibaba, versi ini menumpukan penghasilan variasi yang lebih pantas. Spesifikasi pengeluar turut menyediakan penyuntingan, penggabungan rujukan dan perubahan setempat; operasi ini memerlukan sokongan input imej yang berasingan dan tidak disediakan oleh kaedah semasa pada kad ini.\n\n### Mod yang diterangkan oleh Alibaba\n\nBagi mod rujukan, Alibaba menyediakan sehingga sembilan imej asal dalam satu arahan. Imej ini menjadi panduan rupa objek, komposisi dan butiran. Model boleh menggabungkan beberapa bahan menjadi adegan baharu atau mengubah imej asal sambil mengekalkan objek utama. Untuk penyuntingan khusus, kawasan yang ditandakan secara jelas disediakan: sehingga dua kawasan segi empat tepat boleh ditentukan pada satu imej.\n\nDalam spesifikasi Alibaba, mod biasa menghasilkan satu hingga empat hasil. Siri berurutan membolehkan sehingga 12 imej diminta, dengan hubungan melalui cerita atau ciri watak yang sama. Bagi siri, ini ialah had atas: model menentukan sendiri bilangan bingkai yang diperlukan dan boleh mengembalikan bilangan yang lebih kecil. Arahan dan bahan asal membantu mengekalkan jalan cerita bersama.\n\nMod penaakulan disediakan untuk penjanaan biasa daripada teks tanpa rujukan dan tanpa siri berurutan. Dalam mod ini, model menganalisis penerangan rumit dengan lebih terperinci sebelum menghasilkan imej. Mod ini tidak digunakan semasa penyuntingan berdasarkan imej atau dalam siri berurutan. Palet yang ditetapkan dengan 3–10 warna tersedia di luar siri berurutan.\n\n### Input dan hasil\n\nDalam mod yang menggunakan imej asal, sistem pengeluar menyokong JPEG, JPG, PNG tanpa ketelusan, BMP dan WEBP. Setiap sisi boleh mengandungi dari 240 hingga 8000 piksel, saiz fail sehingga 20 MB dan nisbah aspek dari 1:8 hingga 8:1.\n\nArahan teks menyokong bahasa Cina dan Inggeris serta dihadkan kepada 5000 aksara; bahagian berlebihan dipotong. Penerangan negatif dan peluasan arahan tambahan tidak disediakan bagi versi ini.\n\nFormat output ialah PNG, dengan resolusi sehingga tahap 2K. Label ini merujuk kepada jumlah keluasan piksel, bukannya panjang sisi maksimum yang tetap; bentuk boleh dipilih dalam julat dari 1:8 hingga 8:1. Semasa penyuntingan dengan resolusi pratetap, hasil mengekalkan nisbah aspek rujukan terakhir. Nilai benih rawak awal yang sama membantu mendapatkan variasi yang serupa, tetapi tidak menjamin padanan sepenuhnya.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "c89468dd9fc17af7797b4c98617c2208dad6298907b8ecd3853e77de28a6deaa", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ms", "methods": [ { "html": "wan2.7-imageModel penjanaan imej daripada teks untuk menyediakan variasi reka bentuk dan ilustrasi. Menurut Alibaba, versi ini menumpukan penghasilan imej yang lebih pantas.
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Wan2.7-Image menghasilkan imej daripada arahan teks. Kad Ailoot semasa menyediakan khususnya input teks dan hasil berbentuk imej. Menurut Alibaba, versi ini menumpukan penghasilan variasi yang lebih pantas. Spesifikasi pengeluar turut menyediakan penyuntingan, penggabungan rujukan dan perubahan setempat; operasi ini memerlukan sokongan input imej yang berasingan dan tidak disediakan oleh kaedah semasa pada kad ini.
Bagi mod rujukan, Alibaba menyediakan sehingga sembilan imej asal dalam satu arahan. Imej ini menjadi panduan rupa objek, komposisi dan butiran. Model boleh menggabungkan beberapa bahan menjadi adegan baharu atau mengubah imej asal sambil mengekalkan objek utama. Untuk penyuntingan khusus, kawasan yang ditandakan secara jelas disediakan: sehingga dua kawasan segi empat tepat boleh ditentukan pada satu imej.
Dalam spesifikasi Alibaba, mod biasa menghasilkan satu hingga empat hasil. Siri berurutan membolehkan sehingga 12 imej diminta, dengan hubungan melalui cerita atau ciri watak yang sama. Bagi siri, ini ialah had atas: model menentukan sendiri bilangan bingkai yang diperlukan dan boleh mengembalikan bilangan yang lebih kecil. Arahan dan bahan asal membantu mengekalkan jalan cerita bersama.
Mod penaakulan disediakan untuk penjanaan biasa daripada teks tanpa rujukan dan tanpa siri berurutan. Dalam mod ini, model menganalisis penerangan rumit dengan lebih terperinci sebelum menghasilkan imej. Mod ini tidak digunakan semasa penyuntingan berdasarkan imej atau dalam siri berurutan. Palet yang ditetapkan dengan 3–10 warna tersedia di luar siri berurutan.
Dalam mod yang menggunakan imej asal, sistem pengeluar menyokong JPEG, JPG, PNG tanpa ketelusan, BMP dan WEBP. Setiap sisi boleh mengandungi dari 240 hingga 8000 piksel, saiz fail sehingga 20 MB dan nisbah aspek dari 1:8 hingga 8:1.
Arahan teks menyokong bahasa Cina dan Inggeris serta dihadkan kepada 5000 aksara; bahagian berlebihan dipotong. Penerangan negatif dan peluasan arahan tambahan tidak disediakan bagi versi ini.
Format output ialah PNG, dengan resolusi sehingga tahap 2K. Label ini merujuk kepada jumlah keluasan piksel, bukannya panjang sisi maksimum yang tetap; bentuk boleh dipilih dalam julat dari 1:8 hingga 8:1. Semasa penyuntingan dengan resolusi pratetap, hasil mengekalkan nisbah aspek rujukan terakhir. Nilai benih rawak awal yang sama membantu mendapatkan variasi yang serupa, tetapi tidak menjamin padanan sepenuhnya.
POST /v1/images/generationstextimage| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had wan2.7-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 · Konfigurasi lalai | Syarat pengebilanKonfigurasi lalai | Caj Input · Input USD 0.00 bagi setiap panggilan Output · Output USD 0.06 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", "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', '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", "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
Gunakan laluan kaedah yang dipaparkan di atas.