Qwen-Image-3.0-Pro ialah model Alibaba untuk menghasilkan dan menyunting imej yang mengutamakan komposisi, tulisan dan butiran kecil. Antara kegunaannya ialah reka letak padat, imej di dalam imej, susun atur akhbar, papan cerita, menu dan lembaran pembelajaran. Kad Ailoot semasa menyediakan mod penjanaan imej daripada arahan teks. Alibaba turut menyediakan penyuntingan dan penggunaan imej rujukan; operasi ini memerlukan sokongan input imej yang berasingan dan tidak disediakan oleh kaedah semasa pada kad ini.
Pengeluar menekankan arahan panjang sehingga 4,5 ribu token, tulisan dalam 12 bahasa dan penggunaan beberapa fon. Ini ialah keupayaan pemprosesan arahan yang diterangkan, bukannya saiz tetingkap konteks formal yang diterbitkan. Antara ciri yang dinyatakan ialah penghasilan tulisan kecil bersaiz 10 piksel, tekstur kulit dan rambut serta perubahan kecil pada ekspresi wajah. Butiran sebegini berguna untuk menyediakan bahan yang akan dilihat dari dekat.
Qwen-Image-3.0-Pro juga direka untuk konsep visual halaman web, permainan dan skrin siaran langsung. Hasil sebegini boleh menggabungkan ilustrasi, struktur skrin dan tulisan yang digayakan. Model menghasilkan imej reka letak; aplikasi yang berfungsi memerlukan pelaksanaan berasingan.
Bagi mod penyuntingan, Alibaba menyatakan satu hingga tiga imej. Dalam kaedah ini, pengeluar membolehkan objek dikaitkan dengan nombor rujukan dan gabungan bahan diterangkan. Penambahan, pembuangan dan pemindahan objek serta perubahan tindakan, gaya, butiran dan teks disediakan. Penerangan negatif membantu menyatakan unsur yang tidak dikehendaki.
Bahan input untuk mod penyuntingan pengeluar diterima dalam JPG, JPEG, PNG, BMP, TIFF, WEBP dan GIF. Bingkai pertama digunakan bagi GIF beranimasi. Saiz setiap fail ialah sehingga 10 MB; pengeluar mengesyorkan imej dengan sisi dari 384 hingga 3072 piksel. Ini ialah cadangan untuk input, bukannya dimensi hasil yang dihasilkan.
Spesifikasi pengeluar menyediakan satu hingga enam imej output dalam PNG bagi setiap permintaan. Julat keluasan hasil ialah dari 262 144 hingga 4 194 304 piksel, bersamaan dengan imej segi empat sama dari 512 × 512 hingga 2048 × 2048. Nisbah aspek dari 1:8 hingga 8:1 dibenarkan, jadi panjang sisi bagi komposisi memanjang turut bergantung pada bentuk bingkai yang dipilih. Pemprosesan semula arahan tambahan sebelum penjanaan disediakan.
", "aboutText": "Qwen-Image-3.0-Pro ialah model Alibaba untuk menghasilkan dan menyunting imej yang mengutamakan komposisi, tulisan dan butiran kecil. Antara kegunaannya ialah reka letak padat, imej di dalam imej, susun atur akhbar, papan cerita, menu dan lembaran pembelajaran. Kad Ailoot semasa menyediakan mod penjanaan imej daripada arahan teks. Alibaba turut menyediakan penyuntingan dan penggunaan imej rujukan; operasi ini memerlukan sokongan input imej yang berasingan dan tidak disediakan oleh kaedah semasa pada kad ini.\n\n### Teks dan butiran dalam imej\n\nPengeluar menekankan arahan panjang sehingga 4,5 ribu token, tulisan dalam 12 bahasa dan penggunaan beberapa fon. Ini ialah keupayaan pemprosesan arahan yang diterangkan, bukannya saiz tetingkap konteks formal yang diterbitkan. Antara ciri yang dinyatakan ialah penghasilan tulisan kecil bersaiz 10 piksel, tekstur kulit dan rambut serta perubahan kecil pada ekspresi wajah. Butiran sebegini berguna untuk menyediakan bahan yang akan dilihat dari dekat.\n\nQwen-Image-3.0-Pro juga direka untuk konsep visual halaman web, permainan dan skrin siaran langsung. Hasil sebegini boleh menggabungkan ilustrasi, struktur skrin dan tulisan yang digayakan. Model menghasilkan imej reka letak; aplikasi yang berfungsi memerlukan pelaksanaan berasingan.\n\n### Penyuntingan dalam spesifikasi Alibaba\n\nBagi mod penyuntingan, Alibaba menyatakan satu hingga tiga imej. Dalam kaedah ini, pengeluar membolehkan objek dikaitkan dengan nombor rujukan dan gabungan bahan diterangkan. Penambahan, pembuangan dan pemindahan objek serta perubahan tindakan, gaya, butiran dan teks disediakan. Penerangan negatif membantu menyatakan unsur yang tidak dikehendaki.\n\nBahan input untuk mod penyuntingan pengeluar diterima dalam JPG, JPEG, PNG, BMP, TIFF, WEBP dan GIF. Bingkai pertama digunakan bagi GIF beranimasi. Saiz setiap fail ialah sehingga 10 MB; pengeluar mengesyorkan imej dengan sisi dari 384 hingga 3072 piksel. Ini ialah cadangan untuk input, bukannya dimensi hasil yang dihasilkan.\n\nSpesifikasi pengeluar menyediakan satu hingga enam imej output dalam PNG bagi setiap permintaan. Julat keluasan hasil ialah dari 262 144 hingga 4 194 304 piksel, bersamaan dengan imej segi empat sama dari 512 × 512 hingga 2048 × 2048. Nisbah aspek dari 1:8 hingga 8:1 dibenarkan, jadi panjang sisi bagi komposisi memanjang turut bergantung pada bentuk bingkai yang dipilih. Pemprosesan semula arahan tambahan sebelum penjanaan disediakan.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "fe72d649e67423394280b46786a38803746622e4a673258b4007f9595db794dd", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ms", "methods": [ { "html": "qwen-image-3.0-proModel penjanaan imej daripada teks dengan penekanan pada reka letak rumit, tulisan dan butiran realistik. Sesuai untuk poster, papan cerita, menu dan bahan dengan komposisi yang padat.
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Qwen-Image-3.0-Pro ialah model Alibaba untuk menghasilkan dan menyunting imej yang mengutamakan komposisi, tulisan dan butiran kecil. Antara kegunaannya ialah reka letak padat, imej di dalam imej, susun atur akhbar, papan cerita, menu dan lembaran pembelajaran. Kad Ailoot semasa menyediakan mod penjanaan imej daripada arahan teks. Alibaba turut menyediakan penyuntingan dan penggunaan imej rujukan; operasi ini memerlukan sokongan input imej yang berasingan dan tidak disediakan oleh kaedah semasa pada kad ini.
Pengeluar menekankan arahan panjang sehingga 4,5 ribu token, tulisan dalam 12 bahasa dan penggunaan beberapa fon. Ini ialah keupayaan pemprosesan arahan yang diterangkan, bukannya saiz tetingkap konteks formal yang diterbitkan. Antara ciri yang dinyatakan ialah penghasilan tulisan kecil bersaiz 10 piksel, tekstur kulit dan rambut serta perubahan kecil pada ekspresi wajah. Butiran sebegini berguna untuk menyediakan bahan yang akan dilihat dari dekat.
Qwen-Image-3.0-Pro juga direka untuk konsep visual halaman web, permainan dan skrin siaran langsung. Hasil sebegini boleh menggabungkan ilustrasi, struktur skrin dan tulisan yang digayakan. Model menghasilkan imej reka letak; aplikasi yang berfungsi memerlukan pelaksanaan berasingan.
Bagi mod penyuntingan, Alibaba menyatakan satu hingga tiga imej. Dalam kaedah ini, pengeluar membolehkan objek dikaitkan dengan nombor rujukan dan gabungan bahan diterangkan. Penambahan, pembuangan dan pemindahan objek serta perubahan tindakan, gaya, butiran dan teks disediakan. Penerangan negatif membantu menyatakan unsur yang tidak dikehendaki.
Bahan input untuk mod penyuntingan pengeluar diterima dalam JPG, JPEG, PNG, BMP, TIFF, WEBP dan GIF. Bingkai pertama digunakan bagi GIF beranimasi. Saiz setiap fail ialah sehingga 10 MB; pengeluar mengesyorkan imej dengan sisi dari 384 hingga 3072 piksel. Ini ialah cadangan untuk input, bukannya dimensi hasil yang dihasilkan.
Spesifikasi pengeluar menyediakan satu hingga enam imej output dalam PNG bagi setiap permintaan. Julat keluasan hasil ialah dari 262 144 hingga 4 194 304 piksel, bersamaan dengan imej segi empat sama dari 512 × 512 hingga 2048 × 2048. Nisbah aspek dari 1:8 hingga 8:1 dibenarkan, jadi panjang sisi bagi komposisi memanjang turut bergantung pada bentuk bingkai yang dipilih. Pemprosesan semula arahan tambahan sebelum penjanaan disediakan.
POST /v1/images/generationstextimage| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had qwen-image-3.0-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: 10,485,760 Jenis MIME: image/png, image/jpeg Imej maksimum setiap tatasusunan: 3 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: 10,485,760 Jenis MIME: image/png, image/jpeg Terpakai apabila: penjanaan multipart/form-data | Lalai— |
Medanimage[] | Jenisfile[] | KeperluanPilihan | Nilai & had Item maksimum: 3 Bait ternyahkod maksimum: 10,485,760 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 →
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": "qwen-image-3.0-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': 'qwen-image-3.0-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": "qwen-image-3.0-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 qwen-image-3.0-pro, qwen-image, qwen-image-latest
Gunakan laluan kaedah yang dipaparkan di atas.
qwen-imageModel penjanaan imej daripada teks dengan penekanan pada reka letak rumit, tulisan dan butiran realistik. Sesuai untuk poster, papan cerita, menu dan bahan dengan komposisi yang padat.
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Qwen-Image-3.0-Pro ialah model Alibaba untuk menghasilkan dan menyunting imej yang mengutamakan komposisi, tulisan dan butiran kecil. Antara kegunaannya ialah reka letak padat, imej di dalam imej, susun atur akhbar, papan cerita, menu dan lembaran pembelajaran. Kad Ailoot semasa menyediakan mod penjanaan imej daripada arahan teks. Alibaba turut menyediakan penyuntingan dan penggunaan imej rujukan; operasi ini memerlukan sokongan input imej yang berasingan dan tidak disediakan oleh kaedah semasa pada kad ini.
Pengeluar menekankan arahan panjang sehingga 4,5 ribu token, tulisan dalam 12 bahasa dan penggunaan beberapa fon. Ini ialah keupayaan pemprosesan arahan yang diterangkan, bukannya saiz tetingkap konteks formal yang diterbitkan. Antara ciri yang dinyatakan ialah penghasilan tulisan kecil bersaiz 10 piksel, tekstur kulit dan rambut serta perubahan kecil pada ekspresi wajah. Butiran sebegini berguna untuk menyediakan bahan yang akan dilihat dari dekat.
Qwen-Image-3.0-Pro juga direka untuk konsep visual halaman web, permainan dan skrin siaran langsung. Hasil sebegini boleh menggabungkan ilustrasi, struktur skrin dan tulisan yang digayakan. Model menghasilkan imej reka letak; aplikasi yang berfungsi memerlukan pelaksanaan berasingan.
Bagi mod penyuntingan, Alibaba menyatakan satu hingga tiga imej. Dalam kaedah ini, pengeluar membolehkan objek dikaitkan dengan nombor rujukan dan gabungan bahan diterangkan. Penambahan, pembuangan dan pemindahan objek serta perubahan tindakan, gaya, butiran dan teks disediakan. Penerangan negatif membantu menyatakan unsur yang tidak dikehendaki.
Bahan input untuk mod penyuntingan pengeluar diterima dalam JPG, JPEG, PNG, BMP, TIFF, WEBP dan GIF. Bingkai pertama digunakan bagi GIF beranimasi. Saiz setiap fail ialah sehingga 10 MB; pengeluar mengesyorkan imej dengan sisi dari 384 hingga 3072 piksel. Ini ialah cadangan untuk input, bukannya dimensi hasil yang dihasilkan.
Spesifikasi pengeluar menyediakan satu hingga enam imej output dalam PNG bagi setiap permintaan. Julat keluasan hasil ialah dari 262 144 hingga 4 194 304 piksel, bersamaan dengan imej segi empat sama dari 512 × 512 hingga 2048 × 2048. Nisbah aspek dari 1:8 hingga 8:1 dibenarkan, jadi panjang sisi bagi komposisi memanjang turut bergantung pada bentuk bingkai yang dipilih. Pemprosesan semula arahan tambahan sebelum penjanaan disediakan.
POST /v1/images/generationstextimage| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had qwen-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: 10,485,760 Jenis MIME: image/png, image/jpeg Imej maksimum setiap tatasusunan: 3 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: 10,485,760 Jenis MIME: image/png, image/jpeg Terpakai apabila: penjanaan multipart/form-data | Lalai— |
Medanimage[] | Jenisfile[] | KeperluanPilihan | Nilai & had Item maksimum: 3 Bait ternyahkod maksimum: 10,485,760 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 →
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": "qwen-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': 'qwen-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": "qwen-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 qwen-image-3.0-pro, qwen-image, qwen-image-latest
Gunakan laluan kaedah yang dipaparkan di atas.
qwen-image-latestModel penjanaan imej daripada teks dengan penekanan pada reka letak rumit, tulisan dan butiran realistik. Sesuai untuk poster, papan cerita, menu dan bahan dengan komposisi yang padat.
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Qwen-Image-3.0-Pro ialah model Alibaba untuk menghasilkan dan menyunting imej yang mengutamakan komposisi, tulisan dan butiran kecil. Antara kegunaannya ialah reka letak padat, imej di dalam imej, susun atur akhbar, papan cerita, menu dan lembaran pembelajaran. Kad Ailoot semasa menyediakan mod penjanaan imej daripada arahan teks. Alibaba turut menyediakan penyuntingan dan penggunaan imej rujukan; operasi ini memerlukan sokongan input imej yang berasingan dan tidak disediakan oleh kaedah semasa pada kad ini.
Pengeluar menekankan arahan panjang sehingga 4,5 ribu token, tulisan dalam 12 bahasa dan penggunaan beberapa fon. Ini ialah keupayaan pemprosesan arahan yang diterangkan, bukannya saiz tetingkap konteks formal yang diterbitkan. Antara ciri yang dinyatakan ialah penghasilan tulisan kecil bersaiz 10 piksel, tekstur kulit dan rambut serta perubahan kecil pada ekspresi wajah. Butiran sebegini berguna untuk menyediakan bahan yang akan dilihat dari dekat.
Qwen-Image-3.0-Pro juga direka untuk konsep visual halaman web, permainan dan skrin siaran langsung. Hasil sebegini boleh menggabungkan ilustrasi, struktur skrin dan tulisan yang digayakan. Model menghasilkan imej reka letak; aplikasi yang berfungsi memerlukan pelaksanaan berasingan.
Bagi mod penyuntingan, Alibaba menyatakan satu hingga tiga imej. Dalam kaedah ini, pengeluar membolehkan objek dikaitkan dengan nombor rujukan dan gabungan bahan diterangkan. Penambahan, pembuangan dan pemindahan objek serta perubahan tindakan, gaya, butiran dan teks disediakan. Penerangan negatif membantu menyatakan unsur yang tidak dikehendaki.
Bahan input untuk mod penyuntingan pengeluar diterima dalam JPG, JPEG, PNG, BMP, TIFF, WEBP dan GIF. Bingkai pertama digunakan bagi GIF beranimasi. Saiz setiap fail ialah sehingga 10 MB; pengeluar mengesyorkan imej dengan sisi dari 384 hingga 3072 piksel. Ini ialah cadangan untuk input, bukannya dimensi hasil yang dihasilkan.
Spesifikasi pengeluar menyediakan satu hingga enam imej output dalam PNG bagi setiap permintaan. Julat keluasan hasil ialah dari 262 144 hingga 4 194 304 piksel, bersamaan dengan imej segi empat sama dari 512 × 512 hingga 2048 × 2048. Nisbah aspek dari 1:8 hingga 8:1 dibenarkan, jadi panjang sisi bagi komposisi memanjang turut bergantung pada bentuk bingkai yang dipilih. Pemprosesan semula arahan tambahan sebelum penjanaan disediakan.
POST /v1/images/generationstextimage| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had qwen-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: 10,485,760 Jenis MIME: image/png, image/jpeg Imej maksimum setiap tatasusunan: 3 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: 10,485,760 Jenis MIME: image/png, image/jpeg Terpakai apabila: penjanaan multipart/form-data | Lalai— |
Medanimage[] | Jenisfile[] | KeperluanPilihan | Nilai & had Item maksimum: 3 Bait ternyahkod maksimum: 10,485,760 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 →
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": "qwen-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': 'qwen-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": "qwen-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 qwen-image-3.0-pro, qwen-image, qwen-image-latest
Gunakan laluan kaedah yang dipaparkan di atas.