Nano Banana 2 ialah model Gemini 3.1 Flash Image Google untuk penjanaan imej asal dan penyuntingan perbualan. Reka bentuknya menekankan penciptaan visual cekap serta pindaan berulang. Profil API yang didokumenkan menerima teks, imej, video dan PDF serta mengembalikan imej dan teks. Ia merupakan edisi bernama yang berbeza daripada Gemini Nano Banana 2.1, bukannya label bagi setiap kemas kini Nano Banana kemudian.
Saiz output merangkumi 0.5K, 1K, 2K dan 4K, dengan 1K sebagai lalai. Pilihan 0.5K lebih kecil adalah khusus profil ini dan boleh sesuai untuk komposisi awal; aras lebih besar membekalkan lebih banyak piksel bagi bentuk output terpilih. Nisbah yang didokumenkan meliputi format segi empat sama, potret dan landskap, termasuk 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 dan 21:9, dengan format tambahan 1:4, 4:1, 1:8 dan 8:1. Contohnya, output segi empat sama berjulat daripada 512 × 512 pada 0.5K kepada 4096 × 4096 pada 4K. Pilih bentuk untuk penempatan dimaksudkan sebelum memperhalus butiran kecil.
Google mengenal pasti pematuhan nisbah bidang, konsistensi visual dan pemaparan teks berbilang bahasa yang ditambah baik antara kemas kini edisi ini. Gunakan ungkapan tepat untuk poster, menu atau infografik dan tetapkan label milik objek mana. Untuk teks kecil atau petikan panjang, kad model melaporkan batasan kebolehbacaan yang berbaki, terutamanya pada 1K. Kekalkan kapsyen padat dan jelaskan saiz relatifnya; untuk teks isi padat, anggap imej sebagai rujukan susun atur visual dan semak tulisan sebenar dengan teliti.
Sehingga 14 imej rujukan boleh digabungkan dalam aliran kerja. Panduan imej menerangkan kesetiaan sehingga sepuluh objek dan kemiripan sehingga empat watak. Labelkan rujukan dan tetapkan perkara yang dibekalkan setiap satu. Untuk adegan produk, satu imej boleh menetapkan objek, satu lagi persekitaran dan satu lagi pencahayaan. Untuk urutan watak, bawa output terdahulu ke prom seterusnya dan nyatakan ciri yang mesti kekal merentas perubahan sudut pandangan atau pose.
Pembumian Web Search dan Image Search boleh memaklumkan penjanaan dengan maklumat semasa serta rujukan visual yang ditemui. Image Search menambah konteks visual, bukan sekadar huraian bertulis hasil carian. Pengeluar menyokong ciri carian merentas tetapan pemikiran yang didokumenkan. Aliran kerja carian imejnya mengecualikan imej manusia dunia sebenar sebagai rujukan daripada carian dan mengembalikan metadata atribusi bersama hasil berasaskan sumber; kekalkan metadata itu apabila menggunakan hasil dalam aplikasi.
Kawalan pemikiran yang didokumenkan untuk Gemini 3.1 Flash Image ialah minimal dan high, dengan minimal sebagai lalai. Ini berbeza daripada profil tiga aras Nano Banana 2.1 dengan medium sebagai lalai. Pemikiran menyokong komposisi dan pengendalian arahan lebih kompleks. Model berasaskan Gemini 3 Flash, tetapi hubungan itu tidak menjadikannya model pelaksanaan kod atau pemanggilan fungsi umum: keupayaan itu ditandakan tidak disokong dalam jadual edisi imej ini.
Penyuntingan perbualan menyokong pengubahan imej dibekalkan atau pemurnian penjanaan terdahulu. Taklimat konkrit boleh menyatakan: “Kekalkan bentuk botol, teks label dan sudut kamera. Gantikan latar belakang dengan permukaan batu cerah dan tambah bayang-bayang lebih lembut.” Terangkan elemen yang dikekalkan seteliti elemen diubah. Kad model menyatakan konsistensi watak, penentuan kiri/kanan dan suntingan berasaskan contengan boleh kekal tidak sempurna, jadi bandingkan butiran khusus itu sebelum meneruskan urutan visual.
Jadual model API memberikan 131,072 token input dan 32,768 token output. Ia menyokong penjanaan imej, pembumian carian, pemikiran dan pemprosesan kelompok, manakala penjanaan audio, cache, output berstruktur, carian fail, Live API dan konteks URL tidak disokong. Aliran kerja imej tidak menerima input audio. Video atau PDF boleh memaklumkan tugas imej pegun dalam profil API ini; output kekal imej dan teks. Imej terjana mengandungi SynthID, dan bilangan imej diminta tidak sentiasa dipatuhi dengan tepat.
Untuk infografik praktikal, bekalkan label diluluskan, khalayak dimaksudkan, turutan bacaan, bahan rujukan dan nisbah sasaran. Minta satu penerangan visual jelas, kemudian gunakan giliran seterusnya untuk membetulkan ungkapan atau jarak sambil mengekalkan komposisi yang telah ditetapkan. Untuk mockup produk, tetapkan geometri, permukaan, cahaya dan butiran visual yang mentakrif produk. Hasil berguna ialah imej bersama teks berkaitannya yang boleh diperiksa, dipilih dan diperhalus dalam urutan terkawal.
", "aboutText": "Nano Banana 2 ialah model Gemini 3.1 Flash Image Google untuk penjanaan imej asal dan penyuntingan perbualan. Reka bentuknya menekankan penciptaan visual cekap serta pindaan berulang. Profil API yang didokumenkan menerima teks, imej, video dan PDF serta mengembalikan imej dan teks. Ia merupakan edisi bernama yang berbeza daripada Gemini Nano Banana 2.1, bukannya label bagi setiap kemas kini Nano Banana kemudian.\n\nSaiz output merangkumi 0.5K, 1K, 2K dan 4K, dengan 1K sebagai lalai. Pilihan 0.5K lebih kecil adalah khusus profil ini dan boleh sesuai untuk komposisi awal; aras lebih besar membekalkan lebih banyak piksel bagi bentuk output terpilih. Nisbah yang didokumenkan meliputi format segi empat sama, potret dan landskap, termasuk 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 dan 21:9, dengan format tambahan 1:4, 4:1, 1:8 dan 8:1. Contohnya, output segi empat sama berjulat daripada 512 × 512 pada 0.5K kepada 4096 × 4096 pada 4K. Pilih bentuk untuk penempatan dimaksudkan sebelum memperhalus butiran kecil.\n\nGoogle mengenal pasti pematuhan nisbah bidang, konsistensi visual dan pemaparan teks berbilang bahasa yang ditambah baik antara kemas kini edisi ini. Gunakan ungkapan tepat untuk poster, menu atau infografik dan tetapkan label milik objek mana. Untuk teks kecil atau petikan panjang, kad model melaporkan batasan kebolehbacaan yang berbaki, terutamanya pada 1K. Kekalkan kapsyen padat dan jelaskan saiz relatifnya; untuk teks isi padat, anggap imej sebagai rujukan susun atur visual dan semak tulisan sebenar dengan teliti.\n\nSehingga 14 imej rujukan boleh digabungkan dalam aliran kerja. Panduan imej menerangkan kesetiaan sehingga sepuluh objek dan kemiripan sehingga empat watak. Labelkan rujukan dan tetapkan perkara yang dibekalkan setiap satu. Untuk adegan produk, satu imej boleh menetapkan objek, satu lagi persekitaran dan satu lagi pencahayaan. Untuk urutan watak, bawa output terdahulu ke prom seterusnya dan nyatakan ciri yang mesti kekal merentas perubahan sudut pandangan atau pose.\n\nPembumian Web Search dan Image Search boleh memaklumkan penjanaan dengan maklumat semasa serta rujukan visual yang ditemui. Image Search menambah konteks visual, bukan sekadar huraian bertulis hasil carian. Pengeluar menyokong ciri carian merentas tetapan pemikiran yang didokumenkan. Aliran kerja carian imejnya mengecualikan imej manusia dunia sebenar sebagai rujukan daripada carian dan mengembalikan metadata atribusi bersama hasil berasaskan sumber; kekalkan metadata itu apabila menggunakan hasil dalam aplikasi.\n\nKawalan pemikiran yang didokumenkan untuk Gemini 3.1 Flash Image ialah minimal dan high, dengan minimal sebagai lalai. Ini berbeza daripada profil tiga aras Nano Banana 2.1 dengan medium sebagai lalai. Pemikiran menyokong komposisi dan pengendalian arahan lebih kompleks. Model berasaskan Gemini 3 Flash, tetapi hubungan itu tidak menjadikannya model pelaksanaan kod atau pemanggilan fungsi umum: keupayaan itu ditandakan tidak disokong dalam jadual edisi imej ini.\n\nPenyuntingan perbualan menyokong pengubahan imej dibekalkan atau pemurnian penjanaan terdahulu. Taklimat konkrit boleh menyatakan: “Kekalkan bentuk botol, teks label dan sudut kamera. Gantikan latar belakang dengan permukaan batu cerah dan tambah bayang-bayang lebih lembut.” Terangkan elemen yang dikekalkan seteliti elemen diubah. Kad model menyatakan konsistensi watak, penentuan kiri/kanan dan suntingan berasaskan contengan boleh kekal tidak sempurna, jadi bandingkan butiran khusus itu sebelum meneruskan urutan visual.\n\nJadual model API memberikan 131,072 token input dan 32,768 token output. Ia menyokong penjanaan imej, pembumian carian, pemikiran dan pemprosesan kelompok, manakala penjanaan audio, cache, output berstruktur, carian fail, Live API dan konteks URL tidak disokong. Aliran kerja imej tidak menerima input audio. Video atau PDF boleh memaklumkan tugas imej pegun dalam profil API ini; output kekal imej dan teks. Imej terjana mengandungi SynthID, dan bilangan imej diminta tidak sentiasa dipatuhi dengan tepat.\n\nUntuk infografik praktikal, bekalkan label diluluskan, khalayak dimaksudkan, turutan bacaan, bahan rujukan dan nisbah sasaran. Minta satu penerangan visual jelas, kemudian gunakan giliran seterusnya untuk membetulkan ungkapan atau jarak sambil mengekalkan komposisi yang telah ditetapkan. Untuk mockup produk, tetapkan geometri, permukaan, cahaya dan butiran visual yang mentakrif produk. Hasil berguna ialah imej bersama teks berkaitannya yang boleh diperiksa, dipilih dan diperhalus dalam urutan terkawal.", "editorialOverlay": { "copy_fields": { "practical_html": "Contoh teknikal dalam bahasa Inggeris
Create a simple bicycle-care infographic\n\nCreate one portrait infographic teaching three bicycle checks before a short ride: tires, brakes and chain. Use three large illustrated steps in that order, a warm ivory background and dark green accents. Include only these headings: 'TIRES', 'BRAKES', 'CHAIN'. Leave generous space around each heading and keep the illustrations clearly separated.One portrait image with three ordered illustrated steps and the three exact, readable headings.Inspect the rendered image for heading spelling, order and clear separation of the three checks.gemini-3.1-flash-imageNano Banana 2 (Gemini 3.1 Flash Image) menjana dan menyunting imej dalam perbualan. Ia menyokong sumber teks serta visual, output 0.5K–4K, komposisi imej rujukan dan pembumian carian untuk adegan produk, infografik serta kerja visual berulang.
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Nano Banana 2 ialah model Gemini 3.1 Flash Image Google untuk penjanaan imej asal dan penyuntingan perbualan. Reka bentuknya menekankan penciptaan visual cekap serta pindaan berulang. Profil API yang didokumenkan menerima teks, imej, video dan PDF serta mengembalikan imej dan teks. Ia merupakan edisi bernama yang berbeza daripada Gemini Nano Banana 2.1, bukannya label bagi setiap kemas kini Nano Banana kemudian.
Saiz output merangkumi 0.5K, 1K, 2K dan 4K, dengan 1K sebagai lalai. Pilihan 0.5K lebih kecil adalah khusus profil ini dan boleh sesuai untuk komposisi awal; aras lebih besar membekalkan lebih banyak piksel bagi bentuk output terpilih. Nisbah yang didokumenkan meliputi format segi empat sama, potret dan landskap, termasuk 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 dan 21:9, dengan format tambahan 1:4, 4:1, 1:8 dan 8:1. Contohnya, output segi empat sama berjulat daripada 512 × 512 pada 0.5K kepada 4096 × 4096 pada 4K. Pilih bentuk untuk penempatan dimaksudkan sebelum memperhalus butiran kecil.
Google mengenal pasti pematuhan nisbah bidang, konsistensi visual dan pemaparan teks berbilang bahasa yang ditambah baik antara kemas kini edisi ini. Gunakan ungkapan tepat untuk poster, menu atau infografik dan tetapkan label milik objek mana. Untuk teks kecil atau petikan panjang, kad model melaporkan batasan kebolehbacaan yang berbaki, terutamanya pada 1K. Kekalkan kapsyen padat dan jelaskan saiz relatifnya; untuk teks isi padat, anggap imej sebagai rujukan susun atur visual dan semak tulisan sebenar dengan teliti.
Sehingga 14 imej rujukan boleh digabungkan dalam aliran kerja. Panduan imej menerangkan kesetiaan sehingga sepuluh objek dan kemiripan sehingga empat watak. Labelkan rujukan dan tetapkan perkara yang dibekalkan setiap satu. Untuk adegan produk, satu imej boleh menetapkan objek, satu lagi persekitaran dan satu lagi pencahayaan. Untuk urutan watak, bawa output terdahulu ke prom seterusnya dan nyatakan ciri yang mesti kekal merentas perubahan sudut pandangan atau pose.
Pembumian Web Search dan Image Search boleh memaklumkan penjanaan dengan maklumat semasa serta rujukan visual yang ditemui. Image Search menambah konteks visual, bukan sekadar huraian bertulis hasil carian. Pengeluar menyokong ciri carian merentas tetapan pemikiran yang didokumenkan. Aliran kerja carian imejnya mengecualikan imej manusia dunia sebenar sebagai rujukan daripada carian dan mengembalikan metadata atribusi bersama hasil berasaskan sumber; kekalkan metadata itu apabila menggunakan hasil dalam aplikasi.
Kawalan pemikiran yang didokumenkan untuk Gemini 3.1 Flash Image ialah minimal dan high, dengan minimal sebagai lalai. Ini berbeza daripada profil tiga aras Nano Banana 2.1 dengan medium sebagai lalai. Pemikiran menyokong komposisi dan pengendalian arahan lebih kompleks. Model berasaskan Gemini 3 Flash, tetapi hubungan itu tidak menjadikannya model pelaksanaan kod atau pemanggilan fungsi umum: keupayaan itu ditandakan tidak disokong dalam jadual edisi imej ini.
Penyuntingan perbualan menyokong pengubahan imej dibekalkan atau pemurnian penjanaan terdahulu. Taklimat konkrit boleh menyatakan: “Kekalkan bentuk botol, teks label dan sudut kamera. Gantikan latar belakang dengan permukaan batu cerah dan tambah bayang-bayang lebih lembut.” Terangkan elemen yang dikekalkan seteliti elemen diubah. Kad model menyatakan konsistensi watak, penentuan kiri/kanan dan suntingan berasaskan contengan boleh kekal tidak sempurna, jadi bandingkan butiran khusus itu sebelum meneruskan urutan visual.
Jadual model API memberikan 131,072 token input dan 32,768 token output. Ia menyokong penjanaan imej, pembumian carian, pemikiran dan pemprosesan kelompok, manakala penjanaan audio, cache, output berstruktur, carian fail, Live API dan konteks URL tidak disokong. Aliran kerja imej tidak menerima input audio. Video atau PDF boleh memaklumkan tugas imej pegun dalam profil API ini; output kekal imej dan teks. Imej terjana mengandungi SynthID, dan bilangan imej diminta tidak sentiasa dipatuhi dengan tepat.
Untuk infografik praktikal, bekalkan label diluluskan, khalayak dimaksudkan, turutan bacaan, bahan rujukan dan nisbah sasaran. Minta satu penerangan visual jelas, kemudian gunakan giliran seterusnya untuk membetulkan ungkapan atau jarak sambil mengekalkan komposisi yang telah ditetapkan. Untuk mockup produk, tetapkan geometri, permukaan, cahaya dan butiran visual yang mentakrif produk. Hasil berguna ialah imej bersama teks berkaitannya yang boleh diperiksa, dipilih dan diperhalus dalam urutan terkawal.
POST /v1/images/generationstextimage, text| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had gemini-3.1-flash-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— |
Medanquality | Jenisstring | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanbackground | Jenisstring | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanoutput_format | Jenisstring | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanoutput_compression | Jenisinteger | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanmoderation | Jenisstring | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medaninput_fidelity | Jenisstring | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanstyle | Jenisstring | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanpartial_images | Jenisinteger | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Teks kepada imej · Diperlukan: prompt
| Parameter | Kontrak |
|---|---|
Parametermaterial_types | Kontraktext |
Parameterrequired | Kontrakmodel, prompt |
Parameteroptional_controls | Kontraknull |
Parametercontent_type | Kontrakapplication/json |
Kitar hayat: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id sebenar yang dikembalikan atau rekod pustaka media
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Struktur kaedah dan ID adalah tepat; keupayaan pembekal berasingan daripada penerimaan permintaan.
POST /v1/images/generationsAiloot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. Cara rizab dan penyelesaian caj berfungsi →
Jadual rujukan peringkat model tidak mengubah pemilihan kaedah, sebut harga atau caj. Caj aktif menggunakan kadar kaedah Ailoot yang dipilih.
| Konfigurasi | Jadual kadar | Caj |
|---|---|---|
| KonfigurasiUltra | Jadual kadarKadar asas | Caj Input · Token input $0.0010000 / 1K token Output · Token output $0.006000 / 1K token Output · keluaran imej $0.12000 / 1K token Output · carian web $0.028 bagi setiap carian web |
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": "gemini-3.1-flash-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': 'gemini-3.1-flash-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": "gemini-3.1-flash-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 gemini-3.1-flash-image
Ailoot Ultra google/gemini-3.1-flash-image
/v1/images
google/gemini-3.1-flash-imageNano Banana 2 (Gemini 3.1 Flash Image) menjana dan menyunting imej dalam perbualan. Ia menyokong sumber teks serta visual, output 0.5K–4K, komposisi imej rujukan dan pembumian carian untuk adegan produk, infografik serta kerja visual berulang.
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Nano Banana 2 ialah model Gemini 3.1 Flash Image Google untuk penjanaan imej asal dan penyuntingan perbualan. Reka bentuknya menekankan penciptaan visual cekap serta pindaan berulang. Profil API yang didokumenkan menerima teks, imej, video dan PDF serta mengembalikan imej dan teks. Ia merupakan edisi bernama yang berbeza daripada Gemini Nano Banana 2.1, bukannya label bagi setiap kemas kini Nano Banana kemudian.
Saiz output merangkumi 0.5K, 1K, 2K dan 4K, dengan 1K sebagai lalai. Pilihan 0.5K lebih kecil adalah khusus profil ini dan boleh sesuai untuk komposisi awal; aras lebih besar membekalkan lebih banyak piksel bagi bentuk output terpilih. Nisbah yang didokumenkan meliputi format segi empat sama, potret dan landskap, termasuk 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 dan 21:9, dengan format tambahan 1:4, 4:1, 1:8 dan 8:1. Contohnya, output segi empat sama berjulat daripada 512 × 512 pada 0.5K kepada 4096 × 4096 pada 4K. Pilih bentuk untuk penempatan dimaksudkan sebelum memperhalus butiran kecil.
Google mengenal pasti pematuhan nisbah bidang, konsistensi visual dan pemaparan teks berbilang bahasa yang ditambah baik antara kemas kini edisi ini. Gunakan ungkapan tepat untuk poster, menu atau infografik dan tetapkan label milik objek mana. Untuk teks kecil atau petikan panjang, kad model melaporkan batasan kebolehbacaan yang berbaki, terutamanya pada 1K. Kekalkan kapsyen padat dan jelaskan saiz relatifnya; untuk teks isi padat, anggap imej sebagai rujukan susun atur visual dan semak tulisan sebenar dengan teliti.
Sehingga 14 imej rujukan boleh digabungkan dalam aliran kerja. Panduan imej menerangkan kesetiaan sehingga sepuluh objek dan kemiripan sehingga empat watak. Labelkan rujukan dan tetapkan perkara yang dibekalkan setiap satu. Untuk adegan produk, satu imej boleh menetapkan objek, satu lagi persekitaran dan satu lagi pencahayaan. Untuk urutan watak, bawa output terdahulu ke prom seterusnya dan nyatakan ciri yang mesti kekal merentas perubahan sudut pandangan atau pose.
Pembumian Web Search dan Image Search boleh memaklumkan penjanaan dengan maklumat semasa serta rujukan visual yang ditemui. Image Search menambah konteks visual, bukan sekadar huraian bertulis hasil carian. Pengeluar menyokong ciri carian merentas tetapan pemikiran yang didokumenkan. Aliran kerja carian imejnya mengecualikan imej manusia dunia sebenar sebagai rujukan daripada carian dan mengembalikan metadata atribusi bersama hasil berasaskan sumber; kekalkan metadata itu apabila menggunakan hasil dalam aplikasi.
Kawalan pemikiran yang didokumenkan untuk Gemini 3.1 Flash Image ialah minimal dan high, dengan minimal sebagai lalai. Ini berbeza daripada profil tiga aras Nano Banana 2.1 dengan medium sebagai lalai. Pemikiran menyokong komposisi dan pengendalian arahan lebih kompleks. Model berasaskan Gemini 3 Flash, tetapi hubungan itu tidak menjadikannya model pelaksanaan kod atau pemanggilan fungsi umum: keupayaan itu ditandakan tidak disokong dalam jadual edisi imej ini.
Penyuntingan perbualan menyokong pengubahan imej dibekalkan atau pemurnian penjanaan terdahulu. Taklimat konkrit boleh menyatakan: “Kekalkan bentuk botol, teks label dan sudut kamera. Gantikan latar belakang dengan permukaan batu cerah dan tambah bayang-bayang lebih lembut.” Terangkan elemen yang dikekalkan seteliti elemen diubah. Kad model menyatakan konsistensi watak, penentuan kiri/kanan dan suntingan berasaskan contengan boleh kekal tidak sempurna, jadi bandingkan butiran khusus itu sebelum meneruskan urutan visual.
Jadual model API memberikan 131,072 token input dan 32,768 token output. Ia menyokong penjanaan imej, pembumian carian, pemikiran dan pemprosesan kelompok, manakala penjanaan audio, cache, output berstruktur, carian fail, Live API dan konteks URL tidak disokong. Aliran kerja imej tidak menerima input audio. Video atau PDF boleh memaklumkan tugas imej pegun dalam profil API ini; output kekal imej dan teks. Imej terjana mengandungi SynthID, dan bilangan imej diminta tidak sentiasa dipatuhi dengan tepat.
Untuk infografik praktikal, bekalkan label diluluskan, khalayak dimaksudkan, turutan bacaan, bahan rujukan dan nisbah sasaran. Minta satu penerangan visual jelas, kemudian gunakan giliran seterusnya untuk membetulkan ungkapan atau jarak sambil mengekalkan komposisi yang telah ditetapkan. Untuk mockup produk, tetapkan geometri, permukaan, cahaya dan butiran visual yang mentakrif produk. Hasil berguna ialah imej bersama teks berkaitannya yang boleh diperiksa, dipilih dan diperhalus dalam urutan terkawal.
POST /v1/chat/completionstexttext| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had google/gemini-3.1-flash-image | Lalai— |
Medanmessages | Jenismessage[] | KeperluanDiperlukan | Nilai & had Item minimum: 1 | Lalai— |
Medanmessages[].role | Jenisstring | KeperluanDiperlukan | Nilai & had Contoh: system, user, assistant, tool, function Syarat: Peranan ini diwakili secara eksplisit oleh jenis keserasian dalam kod sumber; set peranan model yang tepat kekal khusus untuk setiap model. Bergantung pada model | Lalai— |
Medanmessages[].content | Jenisstring|content_part[]|null | KeperluanPilihan | Nilai & had | Lalai— |
Medanmessages[].tool_calls | Jenistool_call[] | KeperluanPilihan | Nilai & had | Lalai— |
Medanmessages[].tool_call_id | Jenisstring | KeperluanPilihan | Nilai & had Terpakai apabila: role=tool; gunakan ID sebenar yang dipulangkan | Lalai— |
Medanmessages[].name | Jenisstring | KeperluanPilihan | Nilai & had | Lalai— |
Medanmessages[].reasoning_content | Jenisstring | KeperluanPilihan | Nilai & had Terpakai apabila: Hantar semula penaakulan sebenar yang dipulangkan apabila model ini menggunakannya | Lalai— |
Medanmessages[].reasoning_details | Jenisobject|array | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanmax_tokens | Jenisinteger | KeperluanPilihan | Nilai & had Minimum: 1 Bergantung pada model | Lalai— |
Medanmax_completion_tokens | Jenisinteger | KeperluanPilihan | Nilai & had Minimum: 1 Bergantung pada model | Lalai— |
Medanstream | Jenisboolean | KeperluanPilihan | Nilai & had | Lalaifalse |
Medanstream_options.include_usage | Jenisboolean | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medantemperature | Jenisnumber | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medantop_p | Jenisnumber | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanstop | Jenisstring|string[] | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medantools | Jenisfunction_tool[] | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medantools[].type | Jenisstring | KeperluanPilihan | Nilai & had function Bergantung pada model | Lalai— |
Medantools[].function.name | Jenisstring | KeperluanDiperlukan | Nilai & had Terpakai apabila: alat fungsi dibekalkan | Lalai— |
Medantools[].function.description | Jenisstring | KeperluanPilihan | Nilai & had | Lalai— |
Medantools[].function.parameters | JenisJSON_schema | KeperluanPilihan | Nilai & had | Lalai— |
Medantool_choice | Jenisstring|object | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanparallel_tool_calls | Jenisboolean | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanresponse_format | Jenisobject | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanreasoning_effort | Jenisstring | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanreasoning | Jenisobject | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanservice_tier | Jenisstring | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medaninstructions | Jenisstring | KeperluanPilihan | Nilai & had Medan keserasian | Lalai— |
Medanfunctions | Jenisfunction[] | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanfunction_call | Jenisstring|object | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanprompt_cache_options | Jenisobject | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanmodalities | Jenisstring[] | KeperluanPilihan | Nilai & had text | Lalai— |
Medanprovider | Jenisobject | KeperluanPilihan | Nilai & had Syarat: provider.options ditolak pada laluan teks Ultra ini | Lalai— |
Medancache_control.ttl | Jenisstring | KeperluanPilihan | Nilai & had Syarat: 1h ditolak pada lokasi cache prompt yang digunakan | Lalai— |
Teks · Teks UTF8
messages[].content
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, messages |
Parametermaterial_types | Kontraktext |
Parametermessages | Kontraktatasusunan mesej dengan struktur role/content |
Parameterfile_material | Kontrakdokumen UTF-8 sebenar dimasukkan sebagai teks literal; ID fail tidak diandaikan |
Parameteroptional_controls | Kontrakstream, temperature, top_p, stop, max_tokens, max_completion_tokens, reasoning, response_format, tools, tool_choice |
Parametercontrol_scope | Kontrakkhusus model; alat fungsi pengguna berbeza daripada alat yang dihoskan |
Parameteroutput_modalities | Kontraktext |
Parameterhosted_operations | Kontrakfalse |
Parametermultimodal_input_binding | Kontraknull |
Kitar hayat: synchronous_or_streamed
Hantar ID model yang tepat bersama messages.
Panjang konteks bukan had output.
Fail teks boleh membekalkan teks literal; input imej/audio/objek fail memerlukan pengikatan tepat.
Rujukan tarif tidak menambah pilihan permintaan. Parameter yang disokong disenaraikan untuk kaedah yang dipilih.
Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif.
| Konfigurasi | Jadual kadar | Token konteks, melebihi | Token konteks, sehingga dan termasuk | Caj |
|---|---|---|---|---|
| KonfigurasiKadar asas token | Jadual kadarKadar asas | Token konteks, melebihi— | Token konteks, sehingga dan termasukTiada had atas | Caj Input · Token input $0.001 / 1K token Output · Token output $0.006 / 1K token Input · Bacaan cache — / 1K token Input · Penulisan cache — / 1K token Input · Penulisan cache, 1 jam — / 1K token Output · Token keluaran imej $0.12 / 1K token imej |
| KonfigurasiTahap panjang permintaan 1 | Jadual kadar— | Token konteks, melebihi0 | Token konteks, sehingga dan termasukTiada had atas | Caj Input · Token input $0.001 / 1K token Output · Token output $0.006 / 1K token Input · Bacaan cache — / 1K token Input · Penulisan cache — / 1K token Input · Penulisan cache, 1 jam — / 1K token |
Jadual rujukan peringkat model tidak mengubah pemilihan kaedah, sebut harga atau caj. Caj aktif menggunakan kadar kaedah Ailoot yang dipilih.
| Konfigurasi | Syarat pengebilan | Caj |
|---|---|---|
| KonfigurasiGoogle: Nano Banana 2 (Gemini 3.1 Flash Image) · Konfigurasi lalai | Syarat pengebilanKonfigurasi lalai | Caj Input · Token input USD 0.001 / 1K token Output · Token output USD 0.006 / 1K token Output · Imej keluaran USD 0.12 / 1K token Output · Carian web USD 0.028 setiap carian |
Ailoot 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}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "google/gemini-3.1-flash-image", "messages": [{"role": "user", "content": "Explain the difference between an observation and a hypothesis in three sentences."}]}')\n\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/chat/completions \\\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 json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nfor x in r.get("choices",[]):\n if x.get("message",{}).get("content"): print(x["message"]["content"])\nPY_RESULT\nfrom openai import OpenAI\nimport os\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.chat.completions.create(model='google/gemini-3.1-flash-image',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}])\nimport base64, json\nfrom pathlib import Path\n\ndef save_result(data, stem="result"):\n # Keep every field, including usage, IDs, reasoning and tool requests.\n Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")\n print(json.dumps(data, ensure_ascii=False, indent=2))\n def save_blob(encoded, suffix, label):\n raw = base64.b64decode(encoded, altchars=b"-_", validate=True)\n ext = "png" if raw.startswith(b"\\x89PNG\\r\\n\\x1a\\n") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix\n file = Path(stem + "-" + label + "." + ext)\n file.write_bytes(raw)\n print("Saved", file)\n for index, block in enumerate(data.get("content") or []):\n print("Content", index, json.dumps(block, ensure_ascii=False))\n for choice in data.get("choices") or []:\n print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))\n for index, item in enumerate(data.get("output") or []):\n print("Output", index, json.dumps(item, ensure_ascii=False))\n if item.get("type") == "image_generation_call" and item.get("result"):\n save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))\n for ci, candidate in enumerate(data.get("candidates") or []):\n for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):\n print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))\n blob = part.get("inlineData") or part.get("inline_data")\n if blob and blob.get("data"):\n mime = blob.get("mimeType") or blob.get("mime_type")\n suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")\n save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))\n\nsave_result(result.to_dict(mode="json"))\nfrom openai import OpenAI\nimport os\nfrom pathlib import Path\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nimport base64, json\nfrom pathlib import Path\n\ndef save_result(data, stem="result"):\n # Keep every field, including usage, IDs, reasoning and tool requests.\n Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")\n print(json.dumps(data, ensure_ascii=False, indent=2))\n def save_blob(encoded, suffix, label):\n raw = base64.b64decode(encoded, altchars=b"-_", validate=True)\n ext = "png" if raw.startswith(b"\\x89PNG\\r\\n\\x1a\\n") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix\n file = Path(stem + "-" + label + "." + ext)\n file.write_bytes(raw)\n print("Saved", file)\n for index, block in enumerate(data.get("content") or []):\n print("Content", index, json.dumps(block, ensure_ascii=False))\n for choice in data.get("choices") or []:\n print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))\n for index, item in enumerate(data.get("output") or []):\n print("Output", index, json.dumps(item, ensure_ascii=False))\n if item.get("type") == "image_generation_call" and item.get("result"):\n save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))\n for ci, candidate in enumerate(data.get("candidates") or []):\n for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):\n print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))\n blob = part.get("inlineData") or part.get("inline_data")\n if blob and blob.get("data"):\n mime = blob.get("mimeType") or blob.get("mime_type")\n suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")\n save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))\n\nwith client.chat.completions.stream(model='google/gemini-3.1-flash-image',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) as stream:\n with Path("stream-events.jsonl").open("w",encoding="utf-8") as log:\n for event in stream:\n payload=event.to_dict(mode="json")\n log.write(json.dumps(payload,ensure_ascii=False)+"\\n"); log.flush()\n print(json.dumps(payload,ensure_ascii=False))\n final=stream.get_final_completion()\n save_result(final.to_dict(mode="json"),"stream-result")\njson atau SSE
Simpan setiap respons lengkap, fail dan bahagian kandungan yang dikembalikan.
Kekalkan setiap pilihan jawapan bersama kandungan, panggilan alat dan penaakulannya. Dalam SSE, gabungkan delta mengikut indeks pilihan jawapan/alat dan kekalkan sebab penamatan akhir serta data penggunaan.
Kekalkan ID permintaan/respons dan pengepala. Tiada URL umum bagi pengambilan tugas teks dibekalkan.
| Medan | Jenis |
|---|---|
Medanchoices[].index | Jenisinteger |
Medanchoices[].message.content | Jenisstring|null |
Medanchoices[].message.tool_calls | Jenistool_call[] |
Medanchoices[].message.reasoning_content | Jenisstring |
Medanchoices[].message.reasoning_details | Jenisobject|array |
Medanchoices[].finish_reason | Jenisstring|null |
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. |
Ailoot gemini-3.1-flash-image
Ailoot Ultra google/gemini-3.1-flash-image
/v1/images
google/gemini-3.1-flash-imageNano Banana 2 (Gemini 3.1 Flash Image) menjana dan menyunting imej dalam perbualan. Ia menyokong sumber teks serta visual, output 0.5K–4K, komposisi imej rujukan dan pembumian carian untuk adegan produk, infografik serta kerja visual berulang.
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Nano Banana 2 ialah model Gemini 3.1 Flash Image Google untuk penjanaan imej asal dan penyuntingan perbualan. Reka bentuknya menekankan penciptaan visual cekap serta pindaan berulang. Profil API yang didokumenkan menerima teks, imej, video dan PDF serta mengembalikan imej dan teks. Ia merupakan edisi bernama yang berbeza daripada Gemini Nano Banana 2.1, bukannya label bagi setiap kemas kini Nano Banana kemudian.
Saiz output merangkumi 0.5K, 1K, 2K dan 4K, dengan 1K sebagai lalai. Pilihan 0.5K lebih kecil adalah khusus profil ini dan boleh sesuai untuk komposisi awal; aras lebih besar membekalkan lebih banyak piksel bagi bentuk output terpilih. Nisbah yang didokumenkan meliputi format segi empat sama, potret dan landskap, termasuk 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 dan 21:9, dengan format tambahan 1:4, 4:1, 1:8 dan 8:1. Contohnya, output segi empat sama berjulat daripada 512 × 512 pada 0.5K kepada 4096 × 4096 pada 4K. Pilih bentuk untuk penempatan dimaksudkan sebelum memperhalus butiran kecil.
Google mengenal pasti pematuhan nisbah bidang, konsistensi visual dan pemaparan teks berbilang bahasa yang ditambah baik antara kemas kini edisi ini. Gunakan ungkapan tepat untuk poster, menu atau infografik dan tetapkan label milik objek mana. Untuk teks kecil atau petikan panjang, kad model melaporkan batasan kebolehbacaan yang berbaki, terutamanya pada 1K. Kekalkan kapsyen padat dan jelaskan saiz relatifnya; untuk teks isi padat, anggap imej sebagai rujukan susun atur visual dan semak tulisan sebenar dengan teliti.
Sehingga 14 imej rujukan boleh digabungkan dalam aliran kerja. Panduan imej menerangkan kesetiaan sehingga sepuluh objek dan kemiripan sehingga empat watak. Labelkan rujukan dan tetapkan perkara yang dibekalkan setiap satu. Untuk adegan produk, satu imej boleh menetapkan objek, satu lagi persekitaran dan satu lagi pencahayaan. Untuk urutan watak, bawa output terdahulu ke prom seterusnya dan nyatakan ciri yang mesti kekal merentas perubahan sudut pandangan atau pose.
Pembumian Web Search dan Image Search boleh memaklumkan penjanaan dengan maklumat semasa serta rujukan visual yang ditemui. Image Search menambah konteks visual, bukan sekadar huraian bertulis hasil carian. Pengeluar menyokong ciri carian merentas tetapan pemikiran yang didokumenkan. Aliran kerja carian imejnya mengecualikan imej manusia dunia sebenar sebagai rujukan daripada carian dan mengembalikan metadata atribusi bersama hasil berasaskan sumber; kekalkan metadata itu apabila menggunakan hasil dalam aplikasi.
Kawalan pemikiran yang didokumenkan untuk Gemini 3.1 Flash Image ialah minimal dan high, dengan minimal sebagai lalai. Ini berbeza daripada profil tiga aras Nano Banana 2.1 dengan medium sebagai lalai. Pemikiran menyokong komposisi dan pengendalian arahan lebih kompleks. Model berasaskan Gemini 3 Flash, tetapi hubungan itu tidak menjadikannya model pelaksanaan kod atau pemanggilan fungsi umum: keupayaan itu ditandakan tidak disokong dalam jadual edisi imej ini.
Penyuntingan perbualan menyokong pengubahan imej dibekalkan atau pemurnian penjanaan terdahulu. Taklimat konkrit boleh menyatakan: “Kekalkan bentuk botol, teks label dan sudut kamera. Gantikan latar belakang dengan permukaan batu cerah dan tambah bayang-bayang lebih lembut.” Terangkan elemen yang dikekalkan seteliti elemen diubah. Kad model menyatakan konsistensi watak, penentuan kiri/kanan dan suntingan berasaskan contengan boleh kekal tidak sempurna, jadi bandingkan butiran khusus itu sebelum meneruskan urutan visual.
Jadual model API memberikan 131,072 token input dan 32,768 token output. Ia menyokong penjanaan imej, pembumian carian, pemikiran dan pemprosesan kelompok, manakala penjanaan audio, cache, output berstruktur, carian fail, Live API dan konteks URL tidak disokong. Aliran kerja imej tidak menerima input audio. Video atau PDF boleh memaklumkan tugas imej pegun dalam profil API ini; output kekal imej dan teks. Imej terjana mengandungi SynthID, dan bilangan imej diminta tidak sentiasa dipatuhi dengan tepat.
Untuk infografik praktikal, bekalkan label diluluskan, khalayak dimaksudkan, turutan bacaan, bahan rujukan dan nisbah sasaran. Minta satu penerangan visual jelas, kemudian gunakan giliran seterusnya untuk membetulkan ungkapan atau jarak sambil mengekalkan komposisi yang telah ditetapkan. Untuk mockup produk, tetapkan geometri, permukaan, cahaya dan butiran visual yang mentakrif produk. Hasil berguna ialah imej bersama teks berkaitannya yang boleh diperiksa, dipilih dan diperhalus dalam urutan terkawal.
POST /v1/images/generationstext, imageimage| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had google/gemini-3.1-flash-image | Lalai— |
Medanprompt | Jenisstring | KeperluanDiperlukan | Nilai & had Panjang minimum: 1 | Lalai— |
Medanresolution | Jenisstring | KeperluanPilihan | Nilai & had 512, 1K, 2K, 4K | Lalai— |
Medanaspect_ratio | Jenisstring | KeperluanPilihan | Nilai & had 1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9 | Lalai— |
Medann | Jenisinteger | KeperluanPilihan | Nilai & had Minimum: 1 Maksimum: 1 | Lalai— |
Medaninput_references | Jenisarray | KeperluanPilihan | Nilai & had Item minimum: 0 Item maksimum: 14 | Lalai— |
Medanprovider | Jenisobject | KeperluanPilihan | Nilai & had | Lalai— |
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, prompt |
Parametermaterial_types | Kontraktext, image |
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}
Kadar yang dipaparkan menganggarkan kos sebelum penjanaan. Caj akhir dikira berdasarkan kos yang direkodkan untuk penjanaan asal. Tempoh output yang diukur dan kuantiti ramalan bukan kuantiti akhir yang boleh dibilkan.
Rujukan tarif tidak menambah pilihan permintaan. Parameter yang disokong disenaraikan untuk kaedah yang dipilih.
Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif.
| Konfigurasi | Jadual kadar | Kuantiti ramalan | Caj |
|---|---|---|---|
| KonfigurasiKadar asas token | Jadual kadarKadar asas | Kuantiti ramalan— | Caj Input · Token input · Anggaran untuk perbandingan sahaja — / 1K token Output · Token output · Anggaran untuk perbandingan sahaja — / 1K token Input · Bacaan cache · Anggaran untuk perbandingan sahaja — / 1K token Input · Penulisan cache · Anggaran untuk perbandingan sahaja — / 1K token Input · Penulisan cache, 1 jam · Anggaran untuk perbandingan sahaja — / 1K token |
| KonfigurasiAnggaran kos penjanaan | Jadual kadar— | Kuantiti ramalananggaran untuk satu penjanaan | Caj Output · Anggaran kos penjanaan · Anggaran untuk perbandingan sahaja $0.49152 anggaran sebelum penjanaan Anggaran ini bukan caj tambahan atau kadar tetap bagi penjanaan yang telah selesai. |
Ailoot 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\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'google/gemini-3.1-flash-image', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\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\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}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nSimpan setiap imej yang selesai; dapatkan setiap URL yang dikembalikan atau nyahkod kandungan Base64-nya.
Simpan respons dan pengepala yang lengkap, setiap output sebenar, pengecam asal yang dikembalikan serta semua medan penggunaan. Pulihkan operasi asal tanpa menghantar permintaan penciptaan sekali lagi.
Simpan X-Client-Request-ID yang dikembalikan untuk penyelarasan rekod. Baca hanya nilai task_id/asset_id sebenar yang dikembalikan atau pustaka media milik anda; jangan sekali-kali bina URL tugas daripada ID operasi atau hantar semula permintaan penciptaan.
| Medan | Jenis |
|---|---|
Medancreated | Jenis |
Medandata[].url | Jenis |
Medandata[].b64_json | Jenis |
Medanusage | Jenis |
Ailoot gemini-3.1-flash-image
Ailoot Ultra google/gemini-3.1-flash-image
/v1/images
google/gemini-3.1-flash-imageNano Banana 2 (Gemini 3.1 Flash Image) menjana dan menyunting imej dalam perbualan. Ia menyokong sumber teks serta visual, output 0.5K–4K, komposisi imej rujukan dan pembumian carian untuk adegan produk, infografik serta kerja visual berulang.
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Nano Banana 2 ialah model Gemini 3.1 Flash Image Google untuk penjanaan imej asal dan penyuntingan perbualan. Reka bentuknya menekankan penciptaan visual cekap serta pindaan berulang. Profil API yang didokumenkan menerima teks, imej, video dan PDF serta mengembalikan imej dan teks. Ia merupakan edisi bernama yang berbeza daripada Gemini Nano Banana 2.1, bukannya label bagi setiap kemas kini Nano Banana kemudian.
Saiz output merangkumi 0.5K, 1K, 2K dan 4K, dengan 1K sebagai lalai. Pilihan 0.5K lebih kecil adalah khusus profil ini dan boleh sesuai untuk komposisi awal; aras lebih besar membekalkan lebih banyak piksel bagi bentuk output terpilih. Nisbah yang didokumenkan meliputi format segi empat sama, potret dan landskap, termasuk 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 dan 21:9, dengan format tambahan 1:4, 4:1, 1:8 dan 8:1. Contohnya, output segi empat sama berjulat daripada 512 × 512 pada 0.5K kepada 4096 × 4096 pada 4K. Pilih bentuk untuk penempatan dimaksudkan sebelum memperhalus butiran kecil.
Google mengenal pasti pematuhan nisbah bidang, konsistensi visual dan pemaparan teks berbilang bahasa yang ditambah baik antara kemas kini edisi ini. Gunakan ungkapan tepat untuk poster, menu atau infografik dan tetapkan label milik objek mana. Untuk teks kecil atau petikan panjang, kad model melaporkan batasan kebolehbacaan yang berbaki, terutamanya pada 1K. Kekalkan kapsyen padat dan jelaskan saiz relatifnya; untuk teks isi padat, anggap imej sebagai rujukan susun atur visual dan semak tulisan sebenar dengan teliti.
Sehingga 14 imej rujukan boleh digabungkan dalam aliran kerja. Panduan imej menerangkan kesetiaan sehingga sepuluh objek dan kemiripan sehingga empat watak. Labelkan rujukan dan tetapkan perkara yang dibekalkan setiap satu. Untuk adegan produk, satu imej boleh menetapkan objek, satu lagi persekitaran dan satu lagi pencahayaan. Untuk urutan watak, bawa output terdahulu ke prom seterusnya dan nyatakan ciri yang mesti kekal merentas perubahan sudut pandangan atau pose.
Pembumian Web Search dan Image Search boleh memaklumkan penjanaan dengan maklumat semasa serta rujukan visual yang ditemui. Image Search menambah konteks visual, bukan sekadar huraian bertulis hasil carian. Pengeluar menyokong ciri carian merentas tetapan pemikiran yang didokumenkan. Aliran kerja carian imejnya mengecualikan imej manusia dunia sebenar sebagai rujukan daripada carian dan mengembalikan metadata atribusi bersama hasil berasaskan sumber; kekalkan metadata itu apabila menggunakan hasil dalam aplikasi.
Kawalan pemikiran yang didokumenkan untuk Gemini 3.1 Flash Image ialah minimal dan high, dengan minimal sebagai lalai. Ini berbeza daripada profil tiga aras Nano Banana 2.1 dengan medium sebagai lalai. Pemikiran menyokong komposisi dan pengendalian arahan lebih kompleks. Model berasaskan Gemini 3 Flash, tetapi hubungan itu tidak menjadikannya model pelaksanaan kod atau pemanggilan fungsi umum: keupayaan itu ditandakan tidak disokong dalam jadual edisi imej ini.
Penyuntingan perbualan menyokong pengubahan imej dibekalkan atau pemurnian penjanaan terdahulu. Taklimat konkrit boleh menyatakan: “Kekalkan bentuk botol, teks label dan sudut kamera. Gantikan latar belakang dengan permukaan batu cerah dan tambah bayang-bayang lebih lembut.” Terangkan elemen yang dikekalkan seteliti elemen diubah. Kad model menyatakan konsistensi watak, penentuan kiri/kanan dan suntingan berasaskan contengan boleh kekal tidak sempurna, jadi bandingkan butiran khusus itu sebelum meneruskan urutan visual.
Jadual model API memberikan 131,072 token input dan 32,768 token output. Ia menyokong penjanaan imej, pembumian carian, pemikiran dan pemprosesan kelompok, manakala penjanaan audio, cache, output berstruktur, carian fail, Live API dan konteks URL tidak disokong. Aliran kerja imej tidak menerima input audio. Video atau PDF boleh memaklumkan tugas imej pegun dalam profil API ini; output kekal imej dan teks. Imej terjana mengandungi SynthID, dan bilangan imej diminta tidak sentiasa dipatuhi dengan tepat.
Untuk infografik praktikal, bekalkan label diluluskan, khalayak dimaksudkan, turutan bacaan, bahan rujukan dan nisbah sasaran. Minta satu penerangan visual jelas, kemudian gunakan giliran seterusnya untuk membetulkan ungkapan atau jarak sambil mengekalkan komposisi yang telah ditetapkan. Untuk mockup produk, tetapkan geometri, permukaan, cahaya dan butiran visual yang mentakrif produk. Hasil berguna ialah imej bersama teks berkaitannya yang boleh diperiksa, dipilih dan diperhalus dalam urutan terkawal.
POST /v1/messagestextjson, sse| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had google/gemini-3.1-flash-image | Lalai— |
Medanmessages | Jenismessage[] | KeperluanDiperlukan | Nilai & had | Lalai— |
Medanmessages[].role | Jenisstring | KeperluanDiperlukan | Nilai & had user, assistant | Lalai— |
Medanmessages[].content | Jenisstring | KeperluanDiperlukan | Nilai & had | Lalai— |
Medanmax_tokens | Jenisinteger | KeperluanDiperlukan | Nilai & had | Lalai— |
Medanstream | Jenisboolean | KeperluanPilihan | Nilai & had | Lalaifalse |
Teks · Teks UTF-8
rentetan messages[].content
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, messages, max_tokens |
Parameteroptional_controls | Kontrakstream |
Parametermaterial_types | Kontraktext |
Parametertext_file_material | KontrakBaca dokumen UTF-8 sebenar dan letakkan teksnya dalam rentetan input atau kandungan mesej yang ditunjukkan. |
Kitar hayat: synchronous_or_streamed
Rujukan tarif tidak menambah pilihan permintaan. Parameter yang disokong disenaraikan untuk kaedah yang dipilih.
Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif.
| Konfigurasi | Jadual kadar | Token konteks, melebihi | Token konteks, sehingga dan termasuk | Caj |
|---|---|---|---|---|
| KonfigurasiKadar asas token | Jadual kadarKadar asas | Token konteks, melebihi— | Token konteks, sehingga dan termasukTiada had atas | Caj Input · Token input $0.001 / 1K token Output · Token output $0.006 / 1K token Input · Bacaan cache — / 1K token Input · Penulisan cache — / 1K token Input · Penulisan cache, 1 jam — / 1K token Output · Token keluaran imej $0.12 / 1K token imej |
| KonfigurasiTahap panjang permintaan 1 | Jadual kadar— | Token konteks, melebihi0 | Token konteks, sehingga dan termasukTiada had atas | Caj Input · Token input $0.001 / 1K token Output · Token output $0.006 / 1K token Input · Bacaan cache — / 1K token Input · Penulisan cache — / 1K token Input · Penulisan cache, 1 jam — / 1K token |
Ailoot 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 →
{\n "model": "google/gemini-3.1-flash-image",\n "max_tokens": 128,\n "messages": [\n {\n "role": "user",\n "content": "Summarize the incident report."\n }\n ],\n "stream": false\n}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 document}"\nexport AILOOT_TEXT_FILE\npython3 - <<'PY_REQUEST'\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'google/gemini-3.1-flash-image', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nPath('request.json').write_text(json.dumps(payload, ensure_ascii=False), encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/messages \\\n -H "x-api-key: $AILOOT_API_KEY" -H 'anthropic-version: 2023-06-01' -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nPY_RESULT\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'google/gemini-3.1-flash-image', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nfrom urllib.request import Request, urlopen\nfrom urllib.error import HTTPError\n\napi_key = os.environ['AILOOT_API_KEY']\nif not api_key.strip():\n raise SystemExit('Set AILOOT_API_KEY before making a request')\nheaders = {'x-api-key': 'PLACEHOLDER_KEY', 'anthropic-version': '2023-06-01', 'Content-Type': 'application/json'}\nheaders['x-api-key'] = api_key\nrequest = Request('https://api.ailoot.ai/v1/messages', data=json.dumps(payload, ensure_ascii=False).encode('utf-8'), headers=headers, method='POST')\ntry:\n with urlopen(request, timeout=120) as response:\n raw = response.read()\n Path('response-headers.txt').write_text(str(response.headers), encoding='utf-8')\nexcept HTTPError as error:\n Path('result.json').write_bytes(error.read())\n Path('response-headers.txt').write_text(str(error.headers), encoding='utf-8')\n raise\nPath('result.json').write_bytes(raw)\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nJSON atau SSE
Simpan setiap respons lengkap, fail dan bahagian kandungan yang dikembalikan.
Kekalkan semua blok kandungan, tandatangan penaakulan dan ID penggunaan alat sebenar. Gabungkan semua delta blok SSE; blok teks pertama bukan keseluruhan output.
Kekalkan ID permintaan/respons dan pengepala. Tiada URL umum bagi pengambilan tugas teks dibekalkan.
| Medan | Jenis |
|---|---|
Medanid | Jenisstring |
Medanmodel | Jenisstring |
Medancontent[] | Jenistext|thinking|tool_use|other content block |
Medanstop_reason | Jenisstring|null |
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. |
Ailoot gemini-3.1-flash-image
Ailoot Ultra google/gemini-3.1-flash-image
/v1/images
Contoh teknikal dalam bahasa Inggeris
Create a simple bicycle-care infographic\n\nCreate one portrait infographic teaching three bicycle checks before a short ride: tires, brakes and chain. Use three large illustrated steps in that order, a warm ivory background and dark green accents. Include only these headings: 'TIRES', 'BRAKES', 'CHAIN'. Leave generous space around each heading and keep the illustrations clearly separated.One portrait image with three ordered illustrated steps and the three exact, readable headings.Inspect the rendered image for heading spelling, order and clear separation of the three checks.