Qwen-Image-3.0-Pro adalah model Alibaba untuk membuat dan menyunting gambar yang mengutamakan komposisi, tulisan, dan detail kecil. Penggunaannya mencakup tata letak padat, gambar di dalam gambar, tata letak surat kabar, storyboard, menu, dan lembar belajar. Kartu Ailoot saat ini menampilkan mode pembuatan gambar dari instruksi teks. Alibaba juga menyediakan penyuntingan dan penggunaan gambar referensi; operasi tersebut memerlukan dukungan tersendiri untuk gambar masukan dan tidak tersedia melalui metode yang tercantum pada kartu saat ini.
Produsen menekankan dukungan instruksi panjang hingga 4,5 ribu token, tulisan dalam 12 bahasa, dan penggunaan beberapa jenis huruf. Ini adalah kemampuan pemrosesan instruksi yang dijelaskan, bukan ukuran jendela konteks formal yang dipublikasikan. Kemampuan yang dinyatakan mencakup penggambaran tulisan kecil berukuran 10 piksel, tekstur kulit dan rambut, serta perubahan kecil pada ekspresi wajah. Detail seperti ini berguna untuk menyiapkan materi yang gambarnya dilihat dari dekat.
Qwen-Image-3.0-Pro juga ditujukan untuk konsep visual halaman web, gim, dan tampilan siaran langsung. Hasilnya dapat memadukan ilustrasi, struktur tampilan, dan tulisan yang ditata. Model membuat gambar tata letak; aplikasi yang berfungsi memerlukan implementasi tersendiri.
Untuk mode penyuntingan, Alibaba menyebutkan satu hingga tiga gambar. Dalam metode ini, produsen memungkinkan pengaitan objek dengan nomor referensi dan penjelasan kombinasi materi. Tersedia penambahan, penghapusan, dan pemindahan objek, serta perubahan tindakan, gaya, detail, dan teks. Deskripsi negatif membantu menyebutkan unsur yang tidak diinginkan.
Materi masukan untuk mode penyuntingan pada layanan produsen diterima dalam JPG, JPEG, PNG, BMP, TIFF, WEBP, dan GIF. GIF animasi menggunakan bingkai pertama. Ukuran setiap berkas dibatasi hingga 10 MB; produsen menyarankan gambar dengan panjang sisi dari 384 hingga 3072 piksel. Ini merupakan rekomendasi untuk masukan, bukan ukuran hasil akhir.
Spesifikasi produsen menyediakan satu hingga enam gambar keluaran dalam PNG per permintaan. Luas hasil berkisar dari 262 144 hingga 4 194 304 piksel, setara dengan gambar persegi dari 512 × 512 hingga 2048 × 2048. Rasio aspek dari 1:8 hingga 8:1 diperbolehkan, sehingga pada komposisi memanjang, panjang sisi juga ditentukan oleh bentuk bingkai yang dipilih. Tersedia pemrosesan ulang instruksi tambahan sebelum pembuatan gambar.
", "aboutText": "Qwen-Image-3.0-Pro adalah model Alibaba untuk membuat dan menyunting gambar yang mengutamakan komposisi, tulisan, dan detail kecil. Penggunaannya mencakup tata letak padat, gambar di dalam gambar, tata letak surat kabar, storyboard, menu, dan lembar belajar. Kartu Ailoot saat ini menampilkan mode pembuatan gambar dari instruksi teks. Alibaba juga menyediakan penyuntingan dan penggunaan gambar referensi; operasi tersebut memerlukan dukungan tersendiri untuk gambar masukan dan tidak tersedia melalui metode yang tercantum pada kartu saat ini.\n\n### Teks dan detail dalam gambar\n\nProdusen menekankan dukungan instruksi panjang hingga 4,5 ribu token, tulisan dalam 12 bahasa, dan penggunaan beberapa jenis huruf. Ini adalah kemampuan pemrosesan instruksi yang dijelaskan, bukan ukuran jendela konteks formal yang dipublikasikan. Kemampuan yang dinyatakan mencakup penggambaran tulisan kecil berukuran 10 piksel, tekstur kulit dan rambut, serta perubahan kecil pada ekspresi wajah. Detail seperti ini berguna untuk menyiapkan materi yang gambarnya dilihat dari dekat.\n\nQwen-Image-3.0-Pro juga ditujukan untuk konsep visual halaman web, gim, dan tampilan siaran langsung. Hasilnya dapat memadukan ilustrasi, struktur tampilan, dan tulisan yang ditata. Model membuat gambar tata letak; aplikasi yang berfungsi memerlukan implementasi tersendiri.\n\n### Penyuntingan dalam spesifikasi Alibaba\n\nUntuk mode penyuntingan, Alibaba menyebutkan satu hingga tiga gambar. Dalam metode ini, produsen memungkinkan pengaitan objek dengan nomor referensi dan penjelasan kombinasi materi. Tersedia penambahan, penghapusan, dan pemindahan objek, serta perubahan tindakan, gaya, detail, dan teks. Deskripsi negatif membantu menyebutkan unsur yang tidak diinginkan.\n\nMateri masukan untuk mode penyuntingan pada layanan produsen diterima dalam JPG, JPEG, PNG, BMP, TIFF, WEBP, dan GIF. GIF animasi menggunakan bingkai pertama. Ukuran setiap berkas dibatasi hingga 10 MB; produsen menyarankan gambar dengan panjang sisi dari 384 hingga 3072 piksel. Ini merupakan rekomendasi untuk masukan, bukan ukuran hasil akhir.\n\nSpesifikasi produsen menyediakan satu hingga enam gambar keluaran dalam PNG per permintaan. Luas hasil berkisar dari 262 144 hingga 4 194 304 piksel, setara dengan gambar persegi dari 512 × 512 hingga 2048 × 2048. Rasio aspek dari 1:8 hingga 8:1 diperbolehkan, sehingga pada komposisi memanjang, panjang sisi juga ditentukan oleh bentuk bingkai yang dipilih. Tersedia pemrosesan ulang instruksi tambahan sebelum pembuatan gambar.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "d55a35c7c8ba19cb3458e5f910a69bc1104484a2f51a06bc5bb7b499edb166e4", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "id", "methods": [ { "html": "qwen-image-3.0-proModel pembuat gambar dari teks dengan fokus pada tata letak kompleks, tulisan, dan detail realistis. Cocok untuk poster, storyboard, menu, dan materi dengan komposisi padat.
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Qwen-Image-3.0-Pro adalah model Alibaba untuk membuat dan menyunting gambar yang mengutamakan komposisi, tulisan, dan detail kecil. Penggunaannya mencakup tata letak padat, gambar di dalam gambar, tata letak surat kabar, storyboard, menu, dan lembar belajar. Kartu Ailoot saat ini menampilkan mode pembuatan gambar dari instruksi teks. Alibaba juga menyediakan penyuntingan dan penggunaan gambar referensi; operasi tersebut memerlukan dukungan tersendiri untuk gambar masukan dan tidak tersedia melalui metode yang tercantum pada kartu saat ini.
Produsen menekankan dukungan instruksi panjang hingga 4,5 ribu token, tulisan dalam 12 bahasa, dan penggunaan beberapa jenis huruf. Ini adalah kemampuan pemrosesan instruksi yang dijelaskan, bukan ukuran jendela konteks formal yang dipublikasikan. Kemampuan yang dinyatakan mencakup penggambaran tulisan kecil berukuran 10 piksel, tekstur kulit dan rambut, serta perubahan kecil pada ekspresi wajah. Detail seperti ini berguna untuk menyiapkan materi yang gambarnya dilihat dari dekat.
Qwen-Image-3.0-Pro juga ditujukan untuk konsep visual halaman web, gim, dan tampilan siaran langsung. Hasilnya dapat memadukan ilustrasi, struktur tampilan, dan tulisan yang ditata. Model membuat gambar tata letak; aplikasi yang berfungsi memerlukan implementasi tersendiri.
Untuk mode penyuntingan, Alibaba menyebutkan satu hingga tiga gambar. Dalam metode ini, produsen memungkinkan pengaitan objek dengan nomor referensi dan penjelasan kombinasi materi. Tersedia penambahan, penghapusan, dan pemindahan objek, serta perubahan tindakan, gaya, detail, dan teks. Deskripsi negatif membantu menyebutkan unsur yang tidak diinginkan.
Materi masukan untuk mode penyuntingan pada layanan produsen diterima dalam JPG, JPEG, PNG, BMP, TIFF, WEBP, dan GIF. GIF animasi menggunakan bingkai pertama. Ukuran setiap berkas dibatasi hingga 10 MB; produsen menyarankan gambar dengan panjang sisi dari 384 hingga 3072 piksel. Ini merupakan rekomendasi untuk masukan, bukan ukuran hasil akhir.
Spesifikasi produsen menyediakan satu hingga enam gambar keluaran dalam PNG per permintaan. Luas hasil berkisar dari 262 144 hingga 4 194 304 piksel, setara dengan gambar persegi dari 512 × 512 hingga 2048 × 2048. Rasio aspek dari 1:8 hingga 8:1 diperbolehkan, sehingga pada komposisi memanjang, panjang sisi juga ditentukan oleh bentuk bingkai yang dipilih. Tersedia pemrosesan ulang instruksi tambahan sebelum pembuatan gambar.
POST /v1/images/generationstextimage| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan qwen-image-3.0-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: 10.485.760 Jenis MIME: image/png, image/jpeg Gambar maksimum per larik: 3 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: 10.485.760 Jenis MIME: image/png, image/jpeg Berlaku jika: pembuatan dengan multipart/form-data | Bawaan— |
Kolomimage[] | Jenisfile[] | PersyaratanOpsional | Nilai & batasan Item maksimum: 3 Byte terdekode maksimum: 10.485.760 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 →
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");\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 qwen-image-3.0-pro, qwen-image, qwen-image-latest
Gunakan jalur metode yang ditampilkan di atas.
qwen-imageModel pembuat gambar dari teks dengan fokus pada tata letak kompleks, tulisan, dan detail realistis. Cocok untuk poster, storyboard, menu, dan materi dengan komposisi padat.
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Qwen-Image-3.0-Pro adalah model Alibaba untuk membuat dan menyunting gambar yang mengutamakan komposisi, tulisan, dan detail kecil. Penggunaannya mencakup tata letak padat, gambar di dalam gambar, tata letak surat kabar, storyboard, menu, dan lembar belajar. Kartu Ailoot saat ini menampilkan mode pembuatan gambar dari instruksi teks. Alibaba juga menyediakan penyuntingan dan penggunaan gambar referensi; operasi tersebut memerlukan dukungan tersendiri untuk gambar masukan dan tidak tersedia melalui metode yang tercantum pada kartu saat ini.
Produsen menekankan dukungan instruksi panjang hingga 4,5 ribu token, tulisan dalam 12 bahasa, dan penggunaan beberapa jenis huruf. Ini adalah kemampuan pemrosesan instruksi yang dijelaskan, bukan ukuran jendela konteks formal yang dipublikasikan. Kemampuan yang dinyatakan mencakup penggambaran tulisan kecil berukuran 10 piksel, tekstur kulit dan rambut, serta perubahan kecil pada ekspresi wajah. Detail seperti ini berguna untuk menyiapkan materi yang gambarnya dilihat dari dekat.
Qwen-Image-3.0-Pro juga ditujukan untuk konsep visual halaman web, gim, dan tampilan siaran langsung. Hasilnya dapat memadukan ilustrasi, struktur tampilan, dan tulisan yang ditata. Model membuat gambar tata letak; aplikasi yang berfungsi memerlukan implementasi tersendiri.
Untuk mode penyuntingan, Alibaba menyebutkan satu hingga tiga gambar. Dalam metode ini, produsen memungkinkan pengaitan objek dengan nomor referensi dan penjelasan kombinasi materi. Tersedia penambahan, penghapusan, dan pemindahan objek, serta perubahan tindakan, gaya, detail, dan teks. Deskripsi negatif membantu menyebutkan unsur yang tidak diinginkan.
Materi masukan untuk mode penyuntingan pada layanan produsen diterima dalam JPG, JPEG, PNG, BMP, TIFF, WEBP, dan GIF. GIF animasi menggunakan bingkai pertama. Ukuran setiap berkas dibatasi hingga 10 MB; produsen menyarankan gambar dengan panjang sisi dari 384 hingga 3072 piksel. Ini merupakan rekomendasi untuk masukan, bukan ukuran hasil akhir.
Spesifikasi produsen menyediakan satu hingga enam gambar keluaran dalam PNG per permintaan. Luas hasil berkisar dari 262 144 hingga 4 194 304 piksel, setara dengan gambar persegi dari 512 × 512 hingga 2048 × 2048. Rasio aspek dari 1:8 hingga 8:1 diperbolehkan, sehingga pada komposisi memanjang, panjang sisi juga ditentukan oleh bentuk bingkai yang dipilih. Tersedia pemrosesan ulang instruksi tambahan sebelum pembuatan gambar.
POST /v1/images/generationstextimage| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan qwen-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: 10.485.760 Jenis MIME: image/png, image/jpeg Gambar maksimum per larik: 3 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: 10.485.760 Jenis MIME: image/png, image/jpeg Berlaku jika: pembuatan dengan multipart/form-data | Bawaan— |
Kolomimage[] | Jenisfile[] | PersyaratanOpsional | Nilai & batasan Item maksimum: 3 Byte terdekode maksimum: 10.485.760 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 →
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");\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 qwen-image-3.0-pro, qwen-image, qwen-image-latest
Gunakan jalur metode yang ditampilkan di atas.
qwen-image-latestModel pembuat gambar dari teks dengan fokus pada tata letak kompleks, tulisan, dan detail realistis. Cocok untuk poster, storyboard, menu, dan materi dengan komposisi padat.
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Qwen-Image-3.0-Pro adalah model Alibaba untuk membuat dan menyunting gambar yang mengutamakan komposisi, tulisan, dan detail kecil. Penggunaannya mencakup tata letak padat, gambar di dalam gambar, tata letak surat kabar, storyboard, menu, dan lembar belajar. Kartu Ailoot saat ini menampilkan mode pembuatan gambar dari instruksi teks. Alibaba juga menyediakan penyuntingan dan penggunaan gambar referensi; operasi tersebut memerlukan dukungan tersendiri untuk gambar masukan dan tidak tersedia melalui metode yang tercantum pada kartu saat ini.
Produsen menekankan dukungan instruksi panjang hingga 4,5 ribu token, tulisan dalam 12 bahasa, dan penggunaan beberapa jenis huruf. Ini adalah kemampuan pemrosesan instruksi yang dijelaskan, bukan ukuran jendela konteks formal yang dipublikasikan. Kemampuan yang dinyatakan mencakup penggambaran tulisan kecil berukuran 10 piksel, tekstur kulit dan rambut, serta perubahan kecil pada ekspresi wajah. Detail seperti ini berguna untuk menyiapkan materi yang gambarnya dilihat dari dekat.
Qwen-Image-3.0-Pro juga ditujukan untuk konsep visual halaman web, gim, dan tampilan siaran langsung. Hasilnya dapat memadukan ilustrasi, struktur tampilan, dan tulisan yang ditata. Model membuat gambar tata letak; aplikasi yang berfungsi memerlukan implementasi tersendiri.
Untuk mode penyuntingan, Alibaba menyebutkan satu hingga tiga gambar. Dalam metode ini, produsen memungkinkan pengaitan objek dengan nomor referensi dan penjelasan kombinasi materi. Tersedia penambahan, penghapusan, dan pemindahan objek, serta perubahan tindakan, gaya, detail, dan teks. Deskripsi negatif membantu menyebutkan unsur yang tidak diinginkan.
Materi masukan untuk mode penyuntingan pada layanan produsen diterima dalam JPG, JPEG, PNG, BMP, TIFF, WEBP, dan GIF. GIF animasi menggunakan bingkai pertama. Ukuran setiap berkas dibatasi hingga 10 MB; produsen menyarankan gambar dengan panjang sisi dari 384 hingga 3072 piksel. Ini merupakan rekomendasi untuk masukan, bukan ukuran hasil akhir.
Spesifikasi produsen menyediakan satu hingga enam gambar keluaran dalam PNG per permintaan. Luas hasil berkisar dari 262 144 hingga 4 194 304 piksel, setara dengan gambar persegi dari 512 × 512 hingga 2048 × 2048. Rasio aspek dari 1:8 hingga 8:1 diperbolehkan, sehingga pada komposisi memanjang, panjang sisi juga ditentukan oleh bentuk bingkai yang dipilih. Tersedia pemrosesan ulang instruksi tambahan sebelum pembuatan gambar.
POST /v1/images/generationstextimage| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan qwen-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: 10.485.760 Jenis MIME: image/png, image/jpeg Gambar maksimum per larik: 3 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: 10.485.760 Jenis MIME: image/png, image/jpeg Berlaku jika: pembuatan dengan multipart/form-data | Bawaan— |
Kolomimage[] | Jenisfile[] | PersyaratanOpsional | Nilai & batasan Item maksimum: 3 Byte terdekode maksimum: 10.485.760 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 →
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");\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 qwen-image-3.0-pro, qwen-image, qwen-image-latest
Gunakan jalur metode yang ditampilkan di atas.