Nano Banana Pro adalah model Gemini 3 Pro Image Google untuk pembuatan dan penyuntingan gambar yang digerakkan oleh penalaran. Produsen menempatkan desain grafis kompleks, mockup produk dengan kesetiaan tinggi, dan visualisasi data faktual sebagai inti penggunaan yang dimaksud. Model ini menerima teks dan gambar serta menghasilkan gambar dan teks. Edisi gambar bernama Pro ini berbasis Gemini 3 Pro, sambil mempertahankan profil masukan dan kemampuannya sendiri untuk tugas gambar.
Model ini mendukung gambar 1K, 2K, dan 4K. Bentuk yang didokumentasikan mencakup 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, dan 21:9. Gambar persegi 4K berukuran 4096 × 4096; gambar 16:9 4K berukuran 5504 × 3072. Pilih resolusi dan rasio aspek untuk artefak yang diperlukan, baik poster potret, adegan produk, maupun grafis penjelas lebar. Opsi 0.5K dan rasio ekstrem tambahan Gemini 3.1 Flash Image bukan bagian dari tabel Pro ini.
Rendering teks mendukung tulisan yang jelas pada poster, diagram, dan aset desain lainnya. Untuk infografis kompleks, berikan fakta dasar, kata-kata persis, urutan baca, dan hubungan antara label serta elemen visual. Pisahkan informasi yang ingin disampaikan dari gaya artistik yang diinginkan. Google menyarankan menyiapkan teks terlebih dahulu, kemudian menghasilkan gambar yang memuatnya. Hal ini sangat berguna ketika komposisi menggabungkan judul utama, diagram, dan beberapa keterangan singkat.
Masukan multigambar mendukung hingga 14 referensi. Tabel fitur Google menjelaskan hingga enam referensi objek untuk kesetiaan, hingga lima referensi karakter untuk konsistensi, dan hingga tiga referensi gaya. Peran ini membantu menyiapkan visual komposit: foto produk mendefinisikan penampilan, gambar terpisah menetapkan latar, dan gambar gaya memberi arahan perlakuan visual. Beri tahu model detail mana yang otoritatif dan referensi mana yang memberikan inspirasi, alih-alih memintanya menggabungkan setiap ciri yang terlihat tanpa membedakan.
Grounding Google Search dapat memasok informasi dunia nyata untuk visualisasi faktual atau adegan yang diinformasikan kondisi terkini. Alur gambar Pro mendokumentasikan grounding web; ekstensi Image Search didokumentasikan secara khusus untuk Nano Banana 2.1 dan Gemini 3.1 Flash Image. Untuk grafis data, berikan nilai yang ingin ditampilkan atau minta informasi yang di-grounding dalam alur produsen, lalu nyatakan hubungan, label, dan tata letak secara eksplisit. Pembuatan yang diinformasikan pencarian tetap menghasilkan gambar untuk ditinjau, bukan pengganti pemeriksaan fakta yang digambarkan.
Penalaran mendukung penyusunan prompt kompleks sebelum rendering akhir. Panduan gambar menjelaskan gambar sementara yang digunakan untuk menguji komposisi dan logika, yang berbeda dari artefak akhir. Jangan memindahkan tabel kontrol minimal/high Nano Banana 2 atau tabel dengan bawaan medium Nano Banana 2.1 ke edisi Pro ini. Untuk desain yang menantang, berikan arahan lengkap dengan hierarki visual, hubungan objek yang diwajibkan, dan elemen yang harus bertahan setelah penyuntingan berikutnya.
Kartu model menjelaskan keterbatasan berarti yang masih ada: teks sangat kecil dan bagian panjang mungkin dirender buruk, penampilan karakter dapat berubah antara referensi dan hasil, serta penyuntingan dengan mask atau coretan mungkin hanya mengikuti sebagian instruksi atau meninggalkan bekas. Model juga dapat tertukar antara kiri dan kanan atau menyalin elemen sumber ke komposisi baru. Untuk revisi produk, nyatakan secara eksplisit geometri dan label yang dipertahankan, lalu periksa area suntingan; untuk diagram, bandingkan arah panah dan posisi relatif objek.
Tabel API terkini memberikan batas masukan 65,536 token dan batas keluaran 32,768 token. Pembuatan gambar, thinking, grounding pencarian, dan pemrosesan batch didukung; pembuatan audio, function calling, eksekusi kode, caching, keluaran terstruktur, pencarian berkas, konteks URL, dan Live API tidak didukung. Tugas gambar tidak menerima masukan audio maupun video dalam profil ini. Gambar yang dihasilkan menyertakan SynthID, dan jumlah gambar keluaran yang diminta tidak selalu diikuti persis.
Arahan produk praktis dapat menggabungkan gambar produk, referensi pencahayaan, dan judul utama persis: “Pertahankan proporsi dan tulisan produk, tampilkan di atas permukaan batu pucat dengan cahaya samping lembut, dan kosongkan sepertiga bagian atas untuk judul yang diberikan.” Untuk diagram faktual, identifikasi setiap entitas dan koneksi serta berikan label yang disetujui. Sempurnakan hasil dalam percakapan dengan menyebutkan satu perubahan dan ciri yang harus dipertahankan, sambil menyimpan gambar terpilih serta teks penjelasnya bersama sebagai artefak desain.
", "aboutText": "Nano Banana Pro adalah model Gemini 3 Pro Image Google untuk pembuatan dan penyuntingan gambar yang digerakkan oleh penalaran. Produsen menempatkan desain grafis kompleks, mockup produk dengan kesetiaan tinggi, dan visualisasi data faktual sebagai inti penggunaan yang dimaksud. Model ini menerima teks dan gambar serta menghasilkan gambar dan teks. Edisi gambar bernama Pro ini berbasis Gemini 3 Pro, sambil mempertahankan profil masukan dan kemampuannya sendiri untuk tugas gambar.\n\nModel ini mendukung gambar 1K, 2K, dan 4K. Bentuk yang didokumentasikan mencakup 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, dan 21:9. Gambar persegi 4K berukuran 4096 × 4096; gambar 16:9 4K berukuran 5504 × 3072. Pilih resolusi dan rasio aspek untuk artefak yang diperlukan, baik poster potret, adegan produk, maupun grafis penjelas lebar. Opsi 0.5K dan rasio ekstrem tambahan Gemini 3.1 Flash Image bukan bagian dari tabel Pro ini.\n\nRendering teks mendukung tulisan yang jelas pada poster, diagram, dan aset desain lainnya. Untuk infografis kompleks, berikan fakta dasar, kata-kata persis, urutan baca, dan hubungan antara label serta elemen visual. Pisahkan informasi yang ingin disampaikan dari gaya artistik yang diinginkan. Google menyarankan menyiapkan teks terlebih dahulu, kemudian menghasilkan gambar yang memuatnya. Hal ini sangat berguna ketika komposisi menggabungkan judul utama, diagram, dan beberapa keterangan singkat.\n\nMasukan multigambar mendukung hingga 14 referensi. Tabel fitur Google menjelaskan hingga enam referensi objek untuk kesetiaan, hingga lima referensi karakter untuk konsistensi, dan hingga tiga referensi gaya. Peran ini membantu menyiapkan visual komposit: foto produk mendefinisikan penampilan, gambar terpisah menetapkan latar, dan gambar gaya memberi arahan perlakuan visual. Beri tahu model detail mana yang otoritatif dan referensi mana yang memberikan inspirasi, alih-alih memintanya menggabungkan setiap ciri yang terlihat tanpa membedakan.\n\nGrounding Google Search dapat memasok informasi dunia nyata untuk visualisasi faktual atau adegan yang diinformasikan kondisi terkini. Alur gambar Pro mendokumentasikan grounding web; ekstensi Image Search didokumentasikan secara khusus untuk Nano Banana 2.1 dan Gemini 3.1 Flash Image. Untuk grafis data, berikan nilai yang ingin ditampilkan atau minta informasi yang di-grounding dalam alur produsen, lalu nyatakan hubungan, label, dan tata letak secara eksplisit. Pembuatan yang diinformasikan pencarian tetap menghasilkan gambar untuk ditinjau, bukan pengganti pemeriksaan fakta yang digambarkan.\n\nPenalaran mendukung penyusunan prompt kompleks sebelum rendering akhir. Panduan gambar menjelaskan gambar sementara yang digunakan untuk menguji komposisi dan logika, yang berbeda dari artefak akhir. Jangan memindahkan tabel kontrol minimal/high Nano Banana 2 atau tabel dengan bawaan medium Nano Banana 2.1 ke edisi Pro ini. Untuk desain yang menantang, berikan arahan lengkap dengan hierarki visual, hubungan objek yang diwajibkan, dan elemen yang harus bertahan setelah penyuntingan berikutnya.\n\nKartu model menjelaskan keterbatasan berarti yang masih ada: teks sangat kecil dan bagian panjang mungkin dirender buruk, penampilan karakter dapat berubah antara referensi dan hasil, serta penyuntingan dengan mask atau coretan mungkin hanya mengikuti sebagian instruksi atau meninggalkan bekas. Model juga dapat tertukar antara kiri dan kanan atau menyalin elemen sumber ke komposisi baru. Untuk revisi produk, nyatakan secara eksplisit geometri dan label yang dipertahankan, lalu periksa area suntingan; untuk diagram, bandingkan arah panah dan posisi relatif objek.\n\nTabel API terkini memberikan batas masukan 65,536 token dan batas keluaran 32,768 token. Pembuatan gambar, thinking, grounding pencarian, dan pemrosesan batch didukung; pembuatan audio, function calling, eksekusi kode, caching, keluaran terstruktur, pencarian berkas, konteks URL, dan Live API tidak didukung. Tugas gambar tidak menerima masukan audio maupun video dalam profil ini. Gambar yang dihasilkan menyertakan SynthID, dan jumlah gambar keluaran yang diminta tidak selalu diikuti persis.\n\nArahan produk praktis dapat menggabungkan gambar produk, referensi pencahayaan, dan judul utama persis: “Pertahankan proporsi dan tulisan produk, tampilkan di atas permukaan batu pucat dengan cahaya samping lembut, dan kosongkan sepertiga bagian atas untuk judul yang diberikan.” Untuk diagram faktual, identifikasi setiap entitas dan koneksi serta berikan label yang disetujui. Sempurnakan hasil dalam percakapan dengan menyebutkan satu perubahan dan ciri yang harus dipertahankan, sambil menyimpan gambar terpilih serta teks penjelasnya bersama sebagai artefak desain.", "editorialOverlay": { "copy_fields": { "practical_html": "Contoh teknis dalam bahasa Inggris
Visualize a supplied packaging cycle\n\nCreate one landscape explanatory graphic showing this packaging return cycle: customer returns an empty jar, store inspects it, accepted jars are washed, clean jars are refilled. Use four large illustrated stages connected clockwise. Add only these exact labels: 'RETURN', 'INSPECT', 'WASH', 'REFILL'. Make the arrow direction and stage order unmistakable.One landscape image with four labeled stages and arrows matching the supplied cycle.Inspect that arrows connect RETURN to INSPECT to WASH to REFILL in that order, with exact labels.gemini-3-pro-imageNano Banana Pro (Gemini 3 Pro Image) adalah model gambar Google berbasis penalaran untuk desain kompleks, mockup produk, dan visualisasi faktual. Model ini menerima teks serta referensi gambar dan menghasilkan gambar dengan teks, dengan keluaran 1K–4K serta kontrol kreatif yang terperinci.
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Nano Banana Pro adalah model Gemini 3 Pro Image Google untuk pembuatan dan penyuntingan gambar yang digerakkan oleh penalaran. Produsen menempatkan desain grafis kompleks, mockup produk dengan kesetiaan tinggi, dan visualisasi data faktual sebagai inti penggunaan yang dimaksud. Model ini menerima teks dan gambar serta menghasilkan gambar dan teks. Edisi gambar bernama Pro ini berbasis Gemini 3 Pro, sambil mempertahankan profil masukan dan kemampuannya sendiri untuk tugas gambar.
Model ini mendukung gambar 1K, 2K, dan 4K. Bentuk yang didokumentasikan mencakup 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, dan 21:9. Gambar persegi 4K berukuran 4096 × 4096; gambar 16:9 4K berukuran 5504 × 3072. Pilih resolusi dan rasio aspek untuk artefak yang diperlukan, baik poster potret, adegan produk, maupun grafis penjelas lebar. Opsi 0.5K dan rasio ekstrem tambahan Gemini 3.1 Flash Image bukan bagian dari tabel Pro ini.
Rendering teks mendukung tulisan yang jelas pada poster, diagram, dan aset desain lainnya. Untuk infografis kompleks, berikan fakta dasar, kata-kata persis, urutan baca, dan hubungan antara label serta elemen visual. Pisahkan informasi yang ingin disampaikan dari gaya artistik yang diinginkan. Google menyarankan menyiapkan teks terlebih dahulu, kemudian menghasilkan gambar yang memuatnya. Hal ini sangat berguna ketika komposisi menggabungkan judul utama, diagram, dan beberapa keterangan singkat.
Masukan multigambar mendukung hingga 14 referensi. Tabel fitur Google menjelaskan hingga enam referensi objek untuk kesetiaan, hingga lima referensi karakter untuk konsistensi, dan hingga tiga referensi gaya. Peran ini membantu menyiapkan visual komposit: foto produk mendefinisikan penampilan, gambar terpisah menetapkan latar, dan gambar gaya memberi arahan perlakuan visual. Beri tahu model detail mana yang otoritatif dan referensi mana yang memberikan inspirasi, alih-alih memintanya menggabungkan setiap ciri yang terlihat tanpa membedakan.
Grounding Google Search dapat memasok informasi dunia nyata untuk visualisasi faktual atau adegan yang diinformasikan kondisi terkini. Alur gambar Pro mendokumentasikan grounding web; ekstensi Image Search didokumentasikan secara khusus untuk Nano Banana 2.1 dan Gemini 3.1 Flash Image. Untuk grafis data, berikan nilai yang ingin ditampilkan atau minta informasi yang di-grounding dalam alur produsen, lalu nyatakan hubungan, label, dan tata letak secara eksplisit. Pembuatan yang diinformasikan pencarian tetap menghasilkan gambar untuk ditinjau, bukan pengganti pemeriksaan fakta yang digambarkan.
Penalaran mendukung penyusunan prompt kompleks sebelum rendering akhir. Panduan gambar menjelaskan gambar sementara yang digunakan untuk menguji komposisi dan logika, yang berbeda dari artefak akhir. Jangan memindahkan tabel kontrol minimal/high Nano Banana 2 atau tabel dengan bawaan medium Nano Banana 2.1 ke edisi Pro ini. Untuk desain yang menantang, berikan arahan lengkap dengan hierarki visual, hubungan objek yang diwajibkan, dan elemen yang harus bertahan setelah penyuntingan berikutnya.
Kartu model menjelaskan keterbatasan berarti yang masih ada: teks sangat kecil dan bagian panjang mungkin dirender buruk, penampilan karakter dapat berubah antara referensi dan hasil, serta penyuntingan dengan mask atau coretan mungkin hanya mengikuti sebagian instruksi atau meninggalkan bekas. Model juga dapat tertukar antara kiri dan kanan atau menyalin elemen sumber ke komposisi baru. Untuk revisi produk, nyatakan secara eksplisit geometri dan label yang dipertahankan, lalu periksa area suntingan; untuk diagram, bandingkan arah panah dan posisi relatif objek.
Tabel API terkini memberikan batas masukan 65,536 token dan batas keluaran 32,768 token. Pembuatan gambar, thinking, grounding pencarian, dan pemrosesan batch didukung; pembuatan audio, function calling, eksekusi kode, caching, keluaran terstruktur, pencarian berkas, konteks URL, dan Live API tidak didukung. Tugas gambar tidak menerima masukan audio maupun video dalam profil ini. Gambar yang dihasilkan menyertakan SynthID, dan jumlah gambar keluaran yang diminta tidak selalu diikuti persis.
Arahan produk praktis dapat menggabungkan gambar produk, referensi pencahayaan, dan judul utama persis: “Pertahankan proporsi dan tulisan produk, tampilkan di atas permukaan batu pucat dengan cahaya samping lembut, dan kosongkan sepertiga bagian atas untuk judul yang diberikan.” Untuk diagram faktual, identifikasi setiap entitas dan koneksi serta berikan label yang disetujui. Sempurnakan hasil dalam percakapan dengan menyebutkan satu perubahan dan ciri yang harus dipertahankan, sambil menyimpan gambar terpilih serta teks penjelasnya bersama sebagai artefak desain.
POST /v1/images/generationstextimage| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan gemini-3-pro-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— |
Kolomquality | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolombackground | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomoutput_format | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomoutput_compression | Jenisinteger | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolommoderation | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolominput_fidelity | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomstyle | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolompartial_images | Jenisinteger | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Teks ke gambar · Wajib: prompt
| Parameter | Kontrak |
|---|---|
Parametermaterial_types | Kontraktext |
Parameterrequired | Kontrakmodel, prompt |
Parameteroptional_controls | Kontraknull |
Parametercontent_type | Kontrakapplication/json |
Siklus hidup: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id aktual yang dikembalikan atau catatan pustaka media
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Struktur metode dan ID bersifat eksak; kemampuan pemasok terpisah dari penerimaan permintaan.
POST /v1/images/generationsAiloot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
Jadwal referensi tingkat model tidak mengubah pemilihan metode, estimasi harga, atau biaya. Biaya aktif menggunakan tarif metode Ailoot yang dipilih.
| Konfigurasi | Jadwal tarif | Biaya |
|---|---|---|
| KonfigurasiUltra | Jadwal tarifTarif dasar | Biaya Masukan · Token masukan $0.004000 / 1K token Keluaran · Token keluaran $0.024000 / 1K token Masukan · gambar $0.004000 / 1K token Keluaran · keluaran gambar $0.24000 / 1K token Masukan · audio $0.004000 / 1K token Masukan · cache audio masukan $0.0004000 / 1K token Keluaran · pencarian web $0.028 per pencarian web Keluaran · penalaran internal $0.024000 / 1K token Masukan · Pembacaan cache $0.0004000 / 1K token Masukan · Penulisan cache $0.000750000 / 1K token |
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-pro-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-pro-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-pro-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 gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro
Ailoot Ultra google/gemini-3-pro-image
/v1/images
google/gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro, gemini-3-pro-image
gemini-3-pro-image-previewNano Banana Pro (Gemini 3 Pro Image) adalah model gambar Google berbasis penalaran untuk desain kompleks, mockup produk, dan visualisasi faktual. Model ini menerima teks serta referensi gambar dan menghasilkan gambar dengan teks, dengan keluaran 1K–4K serta kontrol kreatif yang terperinci.
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Nano Banana Pro adalah model Gemini 3 Pro Image Google untuk pembuatan dan penyuntingan gambar yang digerakkan oleh penalaran. Produsen menempatkan desain grafis kompleks, mockup produk dengan kesetiaan tinggi, dan visualisasi data faktual sebagai inti penggunaan yang dimaksud. Model ini menerima teks dan gambar serta menghasilkan gambar dan teks. Edisi gambar bernama Pro ini berbasis Gemini 3 Pro, sambil mempertahankan profil masukan dan kemampuannya sendiri untuk tugas gambar.
Model ini mendukung gambar 1K, 2K, dan 4K. Bentuk yang didokumentasikan mencakup 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, dan 21:9. Gambar persegi 4K berukuran 4096 × 4096; gambar 16:9 4K berukuran 5504 × 3072. Pilih resolusi dan rasio aspek untuk artefak yang diperlukan, baik poster potret, adegan produk, maupun grafis penjelas lebar. Opsi 0.5K dan rasio ekstrem tambahan Gemini 3.1 Flash Image bukan bagian dari tabel Pro ini.
Rendering teks mendukung tulisan yang jelas pada poster, diagram, dan aset desain lainnya. Untuk infografis kompleks, berikan fakta dasar, kata-kata persis, urutan baca, dan hubungan antara label serta elemen visual. Pisahkan informasi yang ingin disampaikan dari gaya artistik yang diinginkan. Google menyarankan menyiapkan teks terlebih dahulu, kemudian menghasilkan gambar yang memuatnya. Hal ini sangat berguna ketika komposisi menggabungkan judul utama, diagram, dan beberapa keterangan singkat.
Masukan multigambar mendukung hingga 14 referensi. Tabel fitur Google menjelaskan hingga enam referensi objek untuk kesetiaan, hingga lima referensi karakter untuk konsistensi, dan hingga tiga referensi gaya. Peran ini membantu menyiapkan visual komposit: foto produk mendefinisikan penampilan, gambar terpisah menetapkan latar, dan gambar gaya memberi arahan perlakuan visual. Beri tahu model detail mana yang otoritatif dan referensi mana yang memberikan inspirasi, alih-alih memintanya menggabungkan setiap ciri yang terlihat tanpa membedakan.
Grounding Google Search dapat memasok informasi dunia nyata untuk visualisasi faktual atau adegan yang diinformasikan kondisi terkini. Alur gambar Pro mendokumentasikan grounding web; ekstensi Image Search didokumentasikan secara khusus untuk Nano Banana 2.1 dan Gemini 3.1 Flash Image. Untuk grafis data, berikan nilai yang ingin ditampilkan atau minta informasi yang di-grounding dalam alur produsen, lalu nyatakan hubungan, label, dan tata letak secara eksplisit. Pembuatan yang diinformasikan pencarian tetap menghasilkan gambar untuk ditinjau, bukan pengganti pemeriksaan fakta yang digambarkan.
Penalaran mendukung penyusunan prompt kompleks sebelum rendering akhir. Panduan gambar menjelaskan gambar sementara yang digunakan untuk menguji komposisi dan logika, yang berbeda dari artefak akhir. Jangan memindahkan tabel kontrol minimal/high Nano Banana 2 atau tabel dengan bawaan medium Nano Banana 2.1 ke edisi Pro ini. Untuk desain yang menantang, berikan arahan lengkap dengan hierarki visual, hubungan objek yang diwajibkan, dan elemen yang harus bertahan setelah penyuntingan berikutnya.
Kartu model menjelaskan keterbatasan berarti yang masih ada: teks sangat kecil dan bagian panjang mungkin dirender buruk, penampilan karakter dapat berubah antara referensi dan hasil, serta penyuntingan dengan mask atau coretan mungkin hanya mengikuti sebagian instruksi atau meninggalkan bekas. Model juga dapat tertukar antara kiri dan kanan atau menyalin elemen sumber ke komposisi baru. Untuk revisi produk, nyatakan secara eksplisit geometri dan label yang dipertahankan, lalu periksa area suntingan; untuk diagram, bandingkan arah panah dan posisi relatif objek.
Tabel API terkini memberikan batas masukan 65,536 token dan batas keluaran 32,768 token. Pembuatan gambar, thinking, grounding pencarian, dan pemrosesan batch didukung; pembuatan audio, function calling, eksekusi kode, caching, keluaran terstruktur, pencarian berkas, konteks URL, dan Live API tidak didukung. Tugas gambar tidak menerima masukan audio maupun video dalam profil ini. Gambar yang dihasilkan menyertakan SynthID, dan jumlah gambar keluaran yang diminta tidak selalu diikuti persis.
Arahan produk praktis dapat menggabungkan gambar produk, referensi pencahayaan, dan judul utama persis: “Pertahankan proporsi dan tulisan produk, tampilkan di atas permukaan batu pucat dengan cahaya samping lembut, dan kosongkan sepertiga bagian atas untuk judul yang diberikan.” Untuk diagram faktual, identifikasi setiap entitas dan koneksi serta berikan label yang disetujui. Sempurnakan hasil dalam percakapan dengan menyebutkan satu perubahan dan ciri yang harus dipertahankan, sambil menyimpan gambar terpilih serta teks penjelasnya bersama sebagai artefak desain.
POST /v1/images/generationstextimage| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan gemini-3-pro-image-preview | 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— |
Kolomquality | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolombackground | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomoutput_format | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomoutput_compression | Jenisinteger | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolommoderation | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolominput_fidelity | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomstyle | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolompartial_images | Jenisinteger | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Teks ke gambar · Wajib: prompt
| Parameter | Kontrak |
|---|---|
Parametermaterial_types | Kontraktext |
Parameterrequired | Kontrakmodel, prompt |
Parameteroptional_controls | Kontraknull |
Parametercontent_type | Kontrakapplication/json |
Siklus hidup: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id aktual yang dikembalikan atau catatan pustaka media
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Struktur metode dan ID bersifat eksak; kemampuan pemasok terpisah dari penerimaan permintaan.
POST /v1/images/generationsAiloot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
Jadwal referensi tingkat model tidak mengubah pemilihan metode, estimasi harga, atau biaya. Biaya aktif menggunakan tarif metode Ailoot yang dipilih.
| Konfigurasi | Jadwal tarif | Biaya |
|---|---|---|
| KonfigurasiUltra | Jadwal tarifTarif dasar | Biaya Masukan · Token masukan $0.004000 / 1K token Keluaran · Token keluaran $0.024000 / 1K token Masukan · gambar $0.004000 / 1K token Keluaran · keluaran gambar $0.24000 / 1K token Masukan · audio $0.004000 / 1K token Masukan · cache audio masukan $0.0004000 / 1K token Keluaran · pencarian web $0.028 per pencarian web Keluaran · penalaran internal $0.024000 / 1K token Masukan · Pembacaan cache $0.0004000 / 1K token Masukan · Penulisan cache $0.000750000 / 1K token |
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-pro-image-preview", "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-pro-image-preview', '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-pro-image-preview", "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 gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro
Ailoot Ultra google/gemini-3-pro-image
/v1/images
google/gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro, gemini-3-pro-image
nano-banana-proNano Banana Pro (Gemini 3 Pro Image) adalah model gambar Google berbasis penalaran untuk desain kompleks, mockup produk, dan visualisasi faktual. Model ini menerima teks serta referensi gambar dan menghasilkan gambar dengan teks, dengan keluaran 1K–4K serta kontrol kreatif yang terperinci.
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Nano Banana Pro adalah model Gemini 3 Pro Image Google untuk pembuatan dan penyuntingan gambar yang digerakkan oleh penalaran. Produsen menempatkan desain grafis kompleks, mockup produk dengan kesetiaan tinggi, dan visualisasi data faktual sebagai inti penggunaan yang dimaksud. Model ini menerima teks dan gambar serta menghasilkan gambar dan teks. Edisi gambar bernama Pro ini berbasis Gemini 3 Pro, sambil mempertahankan profil masukan dan kemampuannya sendiri untuk tugas gambar.
Model ini mendukung gambar 1K, 2K, dan 4K. Bentuk yang didokumentasikan mencakup 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, dan 21:9. Gambar persegi 4K berukuran 4096 × 4096; gambar 16:9 4K berukuran 5504 × 3072. Pilih resolusi dan rasio aspek untuk artefak yang diperlukan, baik poster potret, adegan produk, maupun grafis penjelas lebar. Opsi 0.5K dan rasio ekstrem tambahan Gemini 3.1 Flash Image bukan bagian dari tabel Pro ini.
Rendering teks mendukung tulisan yang jelas pada poster, diagram, dan aset desain lainnya. Untuk infografis kompleks, berikan fakta dasar, kata-kata persis, urutan baca, dan hubungan antara label serta elemen visual. Pisahkan informasi yang ingin disampaikan dari gaya artistik yang diinginkan. Google menyarankan menyiapkan teks terlebih dahulu, kemudian menghasilkan gambar yang memuatnya. Hal ini sangat berguna ketika komposisi menggabungkan judul utama, diagram, dan beberapa keterangan singkat.
Masukan multigambar mendukung hingga 14 referensi. Tabel fitur Google menjelaskan hingga enam referensi objek untuk kesetiaan, hingga lima referensi karakter untuk konsistensi, dan hingga tiga referensi gaya. Peran ini membantu menyiapkan visual komposit: foto produk mendefinisikan penampilan, gambar terpisah menetapkan latar, dan gambar gaya memberi arahan perlakuan visual. Beri tahu model detail mana yang otoritatif dan referensi mana yang memberikan inspirasi, alih-alih memintanya menggabungkan setiap ciri yang terlihat tanpa membedakan.
Grounding Google Search dapat memasok informasi dunia nyata untuk visualisasi faktual atau adegan yang diinformasikan kondisi terkini. Alur gambar Pro mendokumentasikan grounding web; ekstensi Image Search didokumentasikan secara khusus untuk Nano Banana 2.1 dan Gemini 3.1 Flash Image. Untuk grafis data, berikan nilai yang ingin ditampilkan atau minta informasi yang di-grounding dalam alur produsen, lalu nyatakan hubungan, label, dan tata letak secara eksplisit. Pembuatan yang diinformasikan pencarian tetap menghasilkan gambar untuk ditinjau, bukan pengganti pemeriksaan fakta yang digambarkan.
Penalaran mendukung penyusunan prompt kompleks sebelum rendering akhir. Panduan gambar menjelaskan gambar sementara yang digunakan untuk menguji komposisi dan logika, yang berbeda dari artefak akhir. Jangan memindahkan tabel kontrol minimal/high Nano Banana 2 atau tabel dengan bawaan medium Nano Banana 2.1 ke edisi Pro ini. Untuk desain yang menantang, berikan arahan lengkap dengan hierarki visual, hubungan objek yang diwajibkan, dan elemen yang harus bertahan setelah penyuntingan berikutnya.
Kartu model menjelaskan keterbatasan berarti yang masih ada: teks sangat kecil dan bagian panjang mungkin dirender buruk, penampilan karakter dapat berubah antara referensi dan hasil, serta penyuntingan dengan mask atau coretan mungkin hanya mengikuti sebagian instruksi atau meninggalkan bekas. Model juga dapat tertukar antara kiri dan kanan atau menyalin elemen sumber ke komposisi baru. Untuk revisi produk, nyatakan secara eksplisit geometri dan label yang dipertahankan, lalu periksa area suntingan; untuk diagram, bandingkan arah panah dan posisi relatif objek.
Tabel API terkini memberikan batas masukan 65,536 token dan batas keluaran 32,768 token. Pembuatan gambar, thinking, grounding pencarian, dan pemrosesan batch didukung; pembuatan audio, function calling, eksekusi kode, caching, keluaran terstruktur, pencarian berkas, konteks URL, dan Live API tidak didukung. Tugas gambar tidak menerima masukan audio maupun video dalam profil ini. Gambar yang dihasilkan menyertakan SynthID, dan jumlah gambar keluaran yang diminta tidak selalu diikuti persis.
Arahan produk praktis dapat menggabungkan gambar produk, referensi pencahayaan, dan judul utama persis: “Pertahankan proporsi dan tulisan produk, tampilkan di atas permukaan batu pucat dengan cahaya samping lembut, dan kosongkan sepertiga bagian atas untuk judul yang diberikan.” Untuk diagram faktual, identifikasi setiap entitas dan koneksi serta berikan label yang disetujui. Sempurnakan hasil dalam percakapan dengan menyebutkan satu perubahan dan ciri yang harus dipertahankan, sambil menyimpan gambar terpilih serta teks penjelasnya bersama sebagai artefak desain.
POST /v1/images/generationstextimage| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan nano-banana-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— |
Kolomquality | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolombackground | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomoutput_format | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomoutput_compression | Jenisinteger | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolommoderation | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolominput_fidelity | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomstyle | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolompartial_images | Jenisinteger | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Teks ke gambar · Wajib: prompt
| Parameter | Kontrak |
|---|---|
Parametermaterial_types | Kontraktext |
Parameterrequired | Kontrakmodel, prompt |
Parameteroptional_controls | Kontraknull |
Parametercontent_type | Kontrakapplication/json |
Siklus hidup: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id aktual yang dikembalikan atau catatan pustaka media
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Struktur metode dan ID bersifat eksak; kemampuan pemasok terpisah dari penerimaan permintaan.
POST /v1/images/generationsAiloot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
Jadwal referensi tingkat model tidak mengubah pemilihan metode, estimasi harga, atau biaya. Biaya aktif menggunakan tarif metode Ailoot yang dipilih.
| Konfigurasi | Jadwal tarif | Biaya |
|---|---|---|
| KonfigurasiUltra | Jadwal tarifTarif dasar | Biaya Masukan · Token masukan $0.004000 / 1K token Keluaran · Token keluaran $0.024000 / 1K token Masukan · gambar $0.004000 / 1K token Keluaran · keluaran gambar $0.24000 / 1K token Masukan · audio $0.004000 / 1K token Masukan · cache audio masukan $0.0004000 / 1K token Keluaran · pencarian web $0.028 per pencarian web Keluaran · penalaran internal $0.024000 / 1K token Masukan · Pembacaan cache $0.0004000 / 1K token Masukan · Penulisan cache $0.000750000 / 1K token |
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": "nano-banana-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': 'nano-banana-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": "nano-banana-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 gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro
Ailoot Ultra google/gemini-3-pro-image
/v1/images
google/gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro, gemini-3-pro-image
google/gemini-3-pro-imageNano Banana Pro (Gemini 3 Pro Image) adalah model gambar Google berbasis penalaran untuk desain kompleks, mockup produk, dan visualisasi faktual. Model ini menerima teks serta referensi gambar dan menghasilkan gambar dengan teks, dengan keluaran 1K–4K serta kontrol kreatif yang terperinci.
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Nano Banana Pro adalah model Gemini 3 Pro Image Google untuk pembuatan dan penyuntingan gambar yang digerakkan oleh penalaran. Produsen menempatkan desain grafis kompleks, mockup produk dengan kesetiaan tinggi, dan visualisasi data faktual sebagai inti penggunaan yang dimaksud. Model ini menerima teks dan gambar serta menghasilkan gambar dan teks. Edisi gambar bernama Pro ini berbasis Gemini 3 Pro, sambil mempertahankan profil masukan dan kemampuannya sendiri untuk tugas gambar.
Model ini mendukung gambar 1K, 2K, dan 4K. Bentuk yang didokumentasikan mencakup 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, dan 21:9. Gambar persegi 4K berukuran 4096 × 4096; gambar 16:9 4K berukuran 5504 × 3072. Pilih resolusi dan rasio aspek untuk artefak yang diperlukan, baik poster potret, adegan produk, maupun grafis penjelas lebar. Opsi 0.5K dan rasio ekstrem tambahan Gemini 3.1 Flash Image bukan bagian dari tabel Pro ini.
Rendering teks mendukung tulisan yang jelas pada poster, diagram, dan aset desain lainnya. Untuk infografis kompleks, berikan fakta dasar, kata-kata persis, urutan baca, dan hubungan antara label serta elemen visual. Pisahkan informasi yang ingin disampaikan dari gaya artistik yang diinginkan. Google menyarankan menyiapkan teks terlebih dahulu, kemudian menghasilkan gambar yang memuatnya. Hal ini sangat berguna ketika komposisi menggabungkan judul utama, diagram, dan beberapa keterangan singkat.
Masukan multigambar mendukung hingga 14 referensi. Tabel fitur Google menjelaskan hingga enam referensi objek untuk kesetiaan, hingga lima referensi karakter untuk konsistensi, dan hingga tiga referensi gaya. Peran ini membantu menyiapkan visual komposit: foto produk mendefinisikan penampilan, gambar terpisah menetapkan latar, dan gambar gaya memberi arahan perlakuan visual. Beri tahu model detail mana yang otoritatif dan referensi mana yang memberikan inspirasi, alih-alih memintanya menggabungkan setiap ciri yang terlihat tanpa membedakan.
Grounding Google Search dapat memasok informasi dunia nyata untuk visualisasi faktual atau adegan yang diinformasikan kondisi terkini. Alur gambar Pro mendokumentasikan grounding web; ekstensi Image Search didokumentasikan secara khusus untuk Nano Banana 2.1 dan Gemini 3.1 Flash Image. Untuk grafis data, berikan nilai yang ingin ditampilkan atau minta informasi yang di-grounding dalam alur produsen, lalu nyatakan hubungan, label, dan tata letak secara eksplisit. Pembuatan yang diinformasikan pencarian tetap menghasilkan gambar untuk ditinjau, bukan pengganti pemeriksaan fakta yang digambarkan.
Penalaran mendukung penyusunan prompt kompleks sebelum rendering akhir. Panduan gambar menjelaskan gambar sementara yang digunakan untuk menguji komposisi dan logika, yang berbeda dari artefak akhir. Jangan memindahkan tabel kontrol minimal/high Nano Banana 2 atau tabel dengan bawaan medium Nano Banana 2.1 ke edisi Pro ini. Untuk desain yang menantang, berikan arahan lengkap dengan hierarki visual, hubungan objek yang diwajibkan, dan elemen yang harus bertahan setelah penyuntingan berikutnya.
Kartu model menjelaskan keterbatasan berarti yang masih ada: teks sangat kecil dan bagian panjang mungkin dirender buruk, penampilan karakter dapat berubah antara referensi dan hasil, serta penyuntingan dengan mask atau coretan mungkin hanya mengikuti sebagian instruksi atau meninggalkan bekas. Model juga dapat tertukar antara kiri dan kanan atau menyalin elemen sumber ke komposisi baru. Untuk revisi produk, nyatakan secara eksplisit geometri dan label yang dipertahankan, lalu periksa area suntingan; untuk diagram, bandingkan arah panah dan posisi relatif objek.
Tabel API terkini memberikan batas masukan 65,536 token dan batas keluaran 32,768 token. Pembuatan gambar, thinking, grounding pencarian, dan pemrosesan batch didukung; pembuatan audio, function calling, eksekusi kode, caching, keluaran terstruktur, pencarian berkas, konteks URL, dan Live API tidak didukung. Tugas gambar tidak menerima masukan audio maupun video dalam profil ini. Gambar yang dihasilkan menyertakan SynthID, dan jumlah gambar keluaran yang diminta tidak selalu diikuti persis.
Arahan produk praktis dapat menggabungkan gambar produk, referensi pencahayaan, dan judul utama persis: “Pertahankan proporsi dan tulisan produk, tampilkan di atas permukaan batu pucat dengan cahaya samping lembut, dan kosongkan sepertiga bagian atas untuk judul yang diberikan.” Untuk diagram faktual, identifikasi setiap entitas dan koneksi serta berikan label yang disetujui. Sempurnakan hasil dalam percakapan dengan menyebutkan satu perubahan dan ciri yang harus dipertahankan, sambil menyimpan gambar terpilih serta teks penjelasnya bersama sebagai artefak desain.
POST /v1/chat/completionstexttext| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan google/gemini-3-pro-image | Bawaan— |
Kolommessages | Jenismessage[] | PersyaratanWajib | Nilai & batasan Item minimum: 1 | Bawaan— |
Kolommessages[].role | Jenisstring | PersyaratanWajib | Nilai & batasan Contoh: system, user, assistant, tool, function Kondisi: Peran ini direpresentasikan secara eksplisit oleh tipe kompatibilitas dalam kode sumber; kumpulan peran model yang tepat tetap khusus untuk tiap model. Bergantung pada model | Bawaan— |
Kolommessages[].content | Jenisstring|content_part[]|null | PersyaratanOpsional | Nilai & batasan | Bawaan— |
Kolommessages[].tool_calls | Jenistool_call[] | PersyaratanOpsional | Nilai & batasan | Bawaan— |
Kolommessages[].tool_call_id | Jenisstring | PersyaratanOpsional | Nilai & batasan Berlaku jika: role=tool; gunakan ID yang benar-benar dikembalikan | Bawaan— |
Kolommessages[].name | Jenisstring | PersyaratanOpsional | Nilai & batasan | Bawaan— |
Kolommessages[].reasoning_content | Jenisstring | PersyaratanOpsional | Nilai & batasan Berlaku jika: Kirim kembali penalaran yang benar-benar dikembalikan jika model ini menggunakannya | Bawaan— |
Kolommessages[].reasoning_details | Jenisobject|array | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolommax_tokens | Jenisinteger | PersyaratanOpsional | Nilai & batasan Minimum: 1 Bergantung pada model | Bawaan— |
Kolommax_completion_tokens | Jenisinteger | PersyaratanOpsional | Nilai & batasan Minimum: 1 Bergantung pada model | Bawaan— |
Kolomstream | Jenisboolean | PersyaratanOpsional | Nilai & batasan | Bawaanfalse |
Kolomstream_options.include_usage | Jenisboolean | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomtemperature | Jenisnumber | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomtop_p | Jenisnumber | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomstop | Jenisstring|string[] | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomtools | Jenisfunction_tool[] | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomtools[].type | Jenisstring | PersyaratanOpsional | Nilai & batasan function Bergantung pada model | Bawaan— |
Kolomtools[].function.name | Jenisstring | PersyaratanWajib | Nilai & batasan Berlaku jika: alat fungsi disediakan | Bawaan— |
Kolomtools[].function.description | Jenisstring | PersyaratanOpsional | Nilai & batasan | Bawaan— |
Kolomtools[].function.parameters | JenisJSON_schema | PersyaratanOpsional | Nilai & batasan | Bawaan— |
Kolomtool_choice | Jenisstring|object | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomparallel_tool_calls | Jenisboolean | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomresponse_format | Jenisobject | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomreasoning_effort | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomreasoning | Jenisobject | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomservice_tier | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolominstructions | Jenisstring | PersyaratanOpsional | Nilai & batasan Kolom kompatibilitas | Bawaan— |
Kolomfunctions | Jenisfunction[] | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomfunction_call | Jenisstring|object | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomprompt_cache_options | Jenisobject | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolommodalities | Jenisstring[] | PersyaratanOpsional | Nilai & batasan text | Bawaan— |
Kolomprovider | Jenisobject | PersyaratanOpsional | Nilai & batasan Kondisi: provider.options ditolak pada rute teks Ultra ini | Bawaan— |
Kolomcache_control.ttl | Jenisstring | PersyaratanOpsional | Nilai & batasan Kondisi: 1h ditolak pada lokasi cache prompt yang digunakan | Bawaan— |
Teks · Teks UTF8
messages[].content
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, messages |
Parametermaterial_types | Kontraktext |
Parametermessages | Kontrakarray pesan dengan struktur role/content |
Parameterfile_material | Kontrakdokumen UTF-8 yang sebenarnya dimasukkan sebagai teks apa adanya; ID file tidak disimpulkan |
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 berbeda dari alat yang dihosting |
Parameteroutput_modalities | Kontraktext |
Parameterhosted_operations | Kontrakfalse |
Parametermultimodal_input_binding | Kontraknull |
Siklus hidup: synchronous_or_streamed
Kirim ID model yang tepat bersama messages.
Panjang konteks bukan batas keluaran.
File teks dapat menyediakan teks apa adanya; masukan gambar/audio/objek file memerlukan pengikatan yang tepat.
Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.
Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.
| Konfigurasi | Jadwal tarif | Token konteks, lebih dari | Token konteks, hingga dan termasuk | Biaya |
|---|---|---|---|---|
| KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Token konteks, lebih dari— | Token konteks, hingga dan termasukTanpa batas atas | Biaya Masukan · Token masukan $0.004 / 1K token Keluaran · Token keluaran $0.024 / 1K token Masukan · Pembacaan cache $0.0004 / 1K token Masukan · Penulisan cache $0.00075 / 1K token Masukan · Penulisan cache, 1 jam — / 1K token Keluaran · Token gambar keluaran $0.24 / 1K token gambar |
| KonfigurasiPanjang permintaan · tingkat 1 | Jadwal tarif— | Token konteks, lebih dari0 | Token konteks, hingga dan termasukTanpa batas atas | Biaya Masukan · Token masukan $0.004 / 1K token Keluaran · Token keluaran $0.024 / 1K token Masukan · Pembacaan cache $0.0004 / 1K token Masukan · Penulisan cache $0.00075 / 1K token Masukan · Penulisan cache, 1 jam — / 1K token |
Jadwal referensi tingkat model tidak mengubah pemilihan metode, estimasi harga, atau biaya. Biaya aktif menggunakan tarif metode Ailoot yang dipilih.
| Konfigurasi | Kondisi penagihan | Biaya |
|---|---|---|
| KonfigurasiGoogle: Nano Banana Pro (Gemini 3 Pro Image) · Konfigurasi bawaan | Kondisi penagihanKonfigurasi bawaan | Biaya Masukan · Token masukan US$0,004 / 1K token Keluaran · Token keluaran US$0,024 / 1K token Masukan · Gambar masukan US$0,004 / 1K token Keluaran · Gambar keluaran US$0,24 / 1K token Masukan · Masukan audio US$0,004 / 1K token Masukan · Pembacaan cache audio US$0,0004 / 1K token Keluaran · Pencarian web US$0,028 per pencarian Keluaran · Token penalaran US$0,024 / 1K token Masukan · Pembacaan cache US$0,0004 / 1K token Masukan · Penulisan cache · 5 menit US$0,00075 / 1K token |
Ailoot 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}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "google/gemini-3-pro-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-pro-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-pro-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, berkas, dan bagian konten yang dikembalikan.
Simpan setiap alternatif jawaban beserta konten, panggilan alat, dan penalarannya. Dalam SSE, gabungkan delta menurut indeks alternatif jawaban/alat, lalu pertahankan alasan penghentian akhir dan data penggunaan.
Simpan ID permintaan/respons dan header. URL umum untuk pengambilan tugas teks tidak disediakan.
| Kolom | Jenis |
|---|---|
Kolomchoices[].index | Jenisinteger |
Kolomchoices[].message.content | Jenisstring|null |
Kolomchoices[].message.tool_calls | Jenistool_call[] |
Kolomchoices[].message.reasoning_content | Jenisstring |
Kolomchoices[].message.reasoning_details | Jenisobject|array |
Kolomchoices[].finish_reason | Jenisstring|null |
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. |
Ailoot gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro
Ailoot Ultra google/gemini-3-pro-image
/v1/images
google/gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro, gemini-3-pro-image
google/gemini-3-pro-imageNano Banana Pro (Gemini 3 Pro Image) adalah model gambar Google berbasis penalaran untuk desain kompleks, mockup produk, dan visualisasi faktual. Model ini menerima teks serta referensi gambar dan menghasilkan gambar dengan teks, dengan keluaran 1K–4K serta kontrol kreatif yang terperinci.
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Nano Banana Pro adalah model Gemini 3 Pro Image Google untuk pembuatan dan penyuntingan gambar yang digerakkan oleh penalaran. Produsen menempatkan desain grafis kompleks, mockup produk dengan kesetiaan tinggi, dan visualisasi data faktual sebagai inti penggunaan yang dimaksud. Model ini menerima teks dan gambar serta menghasilkan gambar dan teks. Edisi gambar bernama Pro ini berbasis Gemini 3 Pro, sambil mempertahankan profil masukan dan kemampuannya sendiri untuk tugas gambar.
Model ini mendukung gambar 1K, 2K, dan 4K. Bentuk yang didokumentasikan mencakup 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, dan 21:9. Gambar persegi 4K berukuran 4096 × 4096; gambar 16:9 4K berukuran 5504 × 3072. Pilih resolusi dan rasio aspek untuk artefak yang diperlukan, baik poster potret, adegan produk, maupun grafis penjelas lebar. Opsi 0.5K dan rasio ekstrem tambahan Gemini 3.1 Flash Image bukan bagian dari tabel Pro ini.
Rendering teks mendukung tulisan yang jelas pada poster, diagram, dan aset desain lainnya. Untuk infografis kompleks, berikan fakta dasar, kata-kata persis, urutan baca, dan hubungan antara label serta elemen visual. Pisahkan informasi yang ingin disampaikan dari gaya artistik yang diinginkan. Google menyarankan menyiapkan teks terlebih dahulu, kemudian menghasilkan gambar yang memuatnya. Hal ini sangat berguna ketika komposisi menggabungkan judul utama, diagram, dan beberapa keterangan singkat.
Masukan multigambar mendukung hingga 14 referensi. Tabel fitur Google menjelaskan hingga enam referensi objek untuk kesetiaan, hingga lima referensi karakter untuk konsistensi, dan hingga tiga referensi gaya. Peran ini membantu menyiapkan visual komposit: foto produk mendefinisikan penampilan, gambar terpisah menetapkan latar, dan gambar gaya memberi arahan perlakuan visual. Beri tahu model detail mana yang otoritatif dan referensi mana yang memberikan inspirasi, alih-alih memintanya menggabungkan setiap ciri yang terlihat tanpa membedakan.
Grounding Google Search dapat memasok informasi dunia nyata untuk visualisasi faktual atau adegan yang diinformasikan kondisi terkini. Alur gambar Pro mendokumentasikan grounding web; ekstensi Image Search didokumentasikan secara khusus untuk Nano Banana 2.1 dan Gemini 3.1 Flash Image. Untuk grafis data, berikan nilai yang ingin ditampilkan atau minta informasi yang di-grounding dalam alur produsen, lalu nyatakan hubungan, label, dan tata letak secara eksplisit. Pembuatan yang diinformasikan pencarian tetap menghasilkan gambar untuk ditinjau, bukan pengganti pemeriksaan fakta yang digambarkan.
Penalaran mendukung penyusunan prompt kompleks sebelum rendering akhir. Panduan gambar menjelaskan gambar sementara yang digunakan untuk menguji komposisi dan logika, yang berbeda dari artefak akhir. Jangan memindahkan tabel kontrol minimal/high Nano Banana 2 atau tabel dengan bawaan medium Nano Banana 2.1 ke edisi Pro ini. Untuk desain yang menantang, berikan arahan lengkap dengan hierarki visual, hubungan objek yang diwajibkan, dan elemen yang harus bertahan setelah penyuntingan berikutnya.
Kartu model menjelaskan keterbatasan berarti yang masih ada: teks sangat kecil dan bagian panjang mungkin dirender buruk, penampilan karakter dapat berubah antara referensi dan hasil, serta penyuntingan dengan mask atau coretan mungkin hanya mengikuti sebagian instruksi atau meninggalkan bekas. Model juga dapat tertukar antara kiri dan kanan atau menyalin elemen sumber ke komposisi baru. Untuk revisi produk, nyatakan secara eksplisit geometri dan label yang dipertahankan, lalu periksa area suntingan; untuk diagram, bandingkan arah panah dan posisi relatif objek.
Tabel API terkini memberikan batas masukan 65,536 token dan batas keluaran 32,768 token. Pembuatan gambar, thinking, grounding pencarian, dan pemrosesan batch didukung; pembuatan audio, function calling, eksekusi kode, caching, keluaran terstruktur, pencarian berkas, konteks URL, dan Live API tidak didukung. Tugas gambar tidak menerima masukan audio maupun video dalam profil ini. Gambar yang dihasilkan menyertakan SynthID, dan jumlah gambar keluaran yang diminta tidak selalu diikuti persis.
Arahan produk praktis dapat menggabungkan gambar produk, referensi pencahayaan, dan judul utama persis: “Pertahankan proporsi dan tulisan produk, tampilkan di atas permukaan batu pucat dengan cahaya samping lembut, dan kosongkan sepertiga bagian atas untuk judul yang diberikan.” Untuk diagram faktual, identifikasi setiap entitas dan koneksi serta berikan label yang disetujui. Sempurnakan hasil dalam percakapan dengan menyebutkan satu perubahan dan ciri yang harus dipertahankan, sambil menyimpan gambar terpilih serta teks penjelasnya bersama sebagai artefak desain.
POST /v1/images/generationstext, imageimage| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan google/gemini-3-pro-image | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanWajib | Nilai & batasan Panjang minimum: 1 | Bawaan— |
Kolomresolution | Jenisstring | PersyaratanOpsional | Nilai & batasan 1K, 2K, 4K | Bawaan— |
Kolomaspect_ratio | Jenisstring | PersyaratanOpsional | Nilai & batasan 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 | Bawaan— |
Kolomn | Jenisinteger | PersyaratanOpsional | Nilai & batasan Minimum: 1 Maksimum: 1 | Bawaan— |
Kolominput_references | Jenisarray | PersyaratanOpsional | Nilai & batasan Item minimum: 0 Item maksimum: 14 | Bawaan— |
Kolomprovider | Jenisobject | PersyaratanOpsional | Nilai & batasan | Bawaan— |
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, prompt |
Parametermaterial_types | Kontraktext, image |
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}
Tarif yang ditampilkan memperkirakan biaya sebelum pembuatan. Biaya akhir dihitung dari biaya yang tercatat untuk proses pembuatan awal. Durasi keluaran yang terukur dan kuantitas perkiraan bukanlah kuantitas akhir yang ditagihkan.
Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.
Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.
| Konfigurasi | Jadwal tarif | Jumlah perkiraan | Biaya |
|---|---|---|---|
| KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Jumlah perkiraan— | Biaya Masukan · Token masukan · Perkiraan hanya untuk perbandingan — / 1K token Keluaran · Token keluaran · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Pembacaan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache, 1 jam · Perkiraan hanya untuk perbandingan — / 1K token |
| KonfigurasiPerkiraan biaya pembuatan | Jadwal tarif— | Jumlah perkiraanestimasi satu kali pembuatan | Biaya Keluaran · Perkiraan biaya pembuatan · Perkiraan hanya untuk perbandingan $0.98304 estimasi sebelum pembuatan Perkiraan ini bukan biaya tambahan maupun tarif tetap untuk proses pembuatan yang telah selesai. |
Ailoot 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\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'google/gemini-3-pro-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\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}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 gambar yang selesai; ambil setiap URL yang dikembalikan atau dekode konten Base64-nya.
Simpan respons dan header secara lengkap, setiap keluaran aktual, identifikator asli yang dikembalikan, dan semua kolom usage. Pulihkan operasi asli tanpa mengirim ulang permintaan pembuatan.
Simpan X-Client-Request-ID yang dikembalikan untuk rekonsiliasi. Baca hanya nilai task_id/asset_id yang benar-benar dikembalikan atau pustaka media milik Anda; jangan pernah membuat URL tugas dari ID operasi dan jangan pernah mengirim ulang permintaan pembuatan.
| Kolom | Jenis |
|---|---|
Kolomcreated | Jenis |
Kolomdata[].url | Jenis |
Kolomdata[].b64_json | Jenis |
Kolomusage | Jenis |
Ailoot gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro
Ailoot Ultra google/gemini-3-pro-image
/v1/images
google/gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro, gemini-3-pro-image
google/gemini-3-pro-imageNano Banana Pro (Gemini 3 Pro Image) adalah model gambar Google berbasis penalaran untuk desain kompleks, mockup produk, dan visualisasi faktual. Model ini menerima teks serta referensi gambar dan menghasilkan gambar dengan teks, dengan keluaran 1K–4K serta kontrol kreatif yang terperinci.
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Nano Banana Pro adalah model Gemini 3 Pro Image Google untuk pembuatan dan penyuntingan gambar yang digerakkan oleh penalaran. Produsen menempatkan desain grafis kompleks, mockup produk dengan kesetiaan tinggi, dan visualisasi data faktual sebagai inti penggunaan yang dimaksud. Model ini menerima teks dan gambar serta menghasilkan gambar dan teks. Edisi gambar bernama Pro ini berbasis Gemini 3 Pro, sambil mempertahankan profil masukan dan kemampuannya sendiri untuk tugas gambar.
Model ini mendukung gambar 1K, 2K, dan 4K. Bentuk yang didokumentasikan mencakup 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, dan 21:9. Gambar persegi 4K berukuran 4096 × 4096; gambar 16:9 4K berukuran 5504 × 3072. Pilih resolusi dan rasio aspek untuk artefak yang diperlukan, baik poster potret, adegan produk, maupun grafis penjelas lebar. Opsi 0.5K dan rasio ekstrem tambahan Gemini 3.1 Flash Image bukan bagian dari tabel Pro ini.
Rendering teks mendukung tulisan yang jelas pada poster, diagram, dan aset desain lainnya. Untuk infografis kompleks, berikan fakta dasar, kata-kata persis, urutan baca, dan hubungan antara label serta elemen visual. Pisahkan informasi yang ingin disampaikan dari gaya artistik yang diinginkan. Google menyarankan menyiapkan teks terlebih dahulu, kemudian menghasilkan gambar yang memuatnya. Hal ini sangat berguna ketika komposisi menggabungkan judul utama, diagram, dan beberapa keterangan singkat.
Masukan multigambar mendukung hingga 14 referensi. Tabel fitur Google menjelaskan hingga enam referensi objek untuk kesetiaan, hingga lima referensi karakter untuk konsistensi, dan hingga tiga referensi gaya. Peran ini membantu menyiapkan visual komposit: foto produk mendefinisikan penampilan, gambar terpisah menetapkan latar, dan gambar gaya memberi arahan perlakuan visual. Beri tahu model detail mana yang otoritatif dan referensi mana yang memberikan inspirasi, alih-alih memintanya menggabungkan setiap ciri yang terlihat tanpa membedakan.
Grounding Google Search dapat memasok informasi dunia nyata untuk visualisasi faktual atau adegan yang diinformasikan kondisi terkini. Alur gambar Pro mendokumentasikan grounding web; ekstensi Image Search didokumentasikan secara khusus untuk Nano Banana 2.1 dan Gemini 3.1 Flash Image. Untuk grafis data, berikan nilai yang ingin ditampilkan atau minta informasi yang di-grounding dalam alur produsen, lalu nyatakan hubungan, label, dan tata letak secara eksplisit. Pembuatan yang diinformasikan pencarian tetap menghasilkan gambar untuk ditinjau, bukan pengganti pemeriksaan fakta yang digambarkan.
Penalaran mendukung penyusunan prompt kompleks sebelum rendering akhir. Panduan gambar menjelaskan gambar sementara yang digunakan untuk menguji komposisi dan logika, yang berbeda dari artefak akhir. Jangan memindahkan tabel kontrol minimal/high Nano Banana 2 atau tabel dengan bawaan medium Nano Banana 2.1 ke edisi Pro ini. Untuk desain yang menantang, berikan arahan lengkap dengan hierarki visual, hubungan objek yang diwajibkan, dan elemen yang harus bertahan setelah penyuntingan berikutnya.
Kartu model menjelaskan keterbatasan berarti yang masih ada: teks sangat kecil dan bagian panjang mungkin dirender buruk, penampilan karakter dapat berubah antara referensi dan hasil, serta penyuntingan dengan mask atau coretan mungkin hanya mengikuti sebagian instruksi atau meninggalkan bekas. Model juga dapat tertukar antara kiri dan kanan atau menyalin elemen sumber ke komposisi baru. Untuk revisi produk, nyatakan secara eksplisit geometri dan label yang dipertahankan, lalu periksa area suntingan; untuk diagram, bandingkan arah panah dan posisi relatif objek.
Tabel API terkini memberikan batas masukan 65,536 token dan batas keluaran 32,768 token. Pembuatan gambar, thinking, grounding pencarian, dan pemrosesan batch didukung; pembuatan audio, function calling, eksekusi kode, caching, keluaran terstruktur, pencarian berkas, konteks URL, dan Live API tidak didukung. Tugas gambar tidak menerima masukan audio maupun video dalam profil ini. Gambar yang dihasilkan menyertakan SynthID, dan jumlah gambar keluaran yang diminta tidak selalu diikuti persis.
Arahan produk praktis dapat menggabungkan gambar produk, referensi pencahayaan, dan judul utama persis: “Pertahankan proporsi dan tulisan produk, tampilkan di atas permukaan batu pucat dengan cahaya samping lembut, dan kosongkan sepertiga bagian atas untuk judul yang diberikan.” Untuk diagram faktual, identifikasi setiap entitas dan koneksi serta berikan label yang disetujui. Sempurnakan hasil dalam percakapan dengan menyebutkan satu perubahan dan ciri yang harus dipertahankan, sambil menyimpan gambar terpilih serta teks penjelasnya bersama sebagai artefak desain.
POST /v1/messagestextjson, sse| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan google/gemini-3-pro-image | Bawaan— |
Kolommessages | Jenismessage[] | PersyaratanWajib | Nilai & batasan | Bawaan— |
Kolommessages[].role | Jenisstring | PersyaratanWajib | Nilai & batasan user, assistant | Bawaan— |
Kolommessages[].content | Jenisstring | PersyaratanWajib | Nilai & batasan | Bawaan— |
Kolommax_tokens | Jenisinteger | PersyaratanWajib | Nilai & batasan | Bawaan— |
Kolomstream | Jenisboolean | PersyaratanOpsional | Nilai & batasan | Bawaanfalse |
Teks · Teks UTF-8
string 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 yang sebenarnya dan masukkan teksnya ke string masukan atau konten pesan yang ditunjukkan. |
Siklus hidup: synchronous_or_streamed
Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.
Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.
| Konfigurasi | Jadwal tarif | Token konteks, lebih dari | Token konteks, hingga dan termasuk | Biaya |
|---|---|---|---|---|
| KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Token konteks, lebih dari— | Token konteks, hingga dan termasukTanpa batas atas | Biaya Masukan · Token masukan $0.004 / 1K token Keluaran · Token keluaran $0.024 / 1K token Masukan · Pembacaan cache $0.0004 / 1K token Masukan · Penulisan cache $0.00075 / 1K token Masukan · Penulisan cache, 1 jam — / 1K token Keluaran · Token gambar keluaran $0.24 / 1K token gambar |
| KonfigurasiPanjang permintaan · tingkat 1 | Jadwal tarif— | Token konteks, lebih dari0 | Token konteks, hingga dan termasukTanpa batas atas | Biaya Masukan · Token masukan $0.004 / 1K token Keluaran · Token keluaran $0.024 / 1K token Masukan · Pembacaan cache $0.0004 / 1K token Masukan · Penulisan cache $0.00075 / 1K token Masukan · Penulisan cache, 1 jam — / 1K token |
Ailoot 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 →
{\n "model": "google/gemini-3-pro-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-pro-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-pro-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, berkas, dan bagian konten yang dikembalikan.
Simpan semua blok konten, tanda tangan penalaran, dan ID penggunaan alat yang sebenarnya. Gabungkan semua delta blok SSE; blok teks pertama bukan keseluruhan keluaran.
Simpan ID permintaan/respons dan header. URL umum untuk pengambilan tugas teks tidak disediakan.
| Kolom | Jenis |
|---|---|
Kolomid | Jenisstring |
Kolommodel | Jenisstring |
Kolomcontent[] | Jenistext|thinking|tool_use|other content block |
Kolomstop_reason | Jenisstring|null |
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. |
Ailoot gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro
Ailoot Ultra google/gemini-3-pro-image
/v1/images
google/gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro, gemini-3-pro-image
Contoh teknis dalam bahasa Inggris
Visualize a supplied packaging cycle\n\nCreate one landscape explanatory graphic showing this packaging return cycle: customer returns an empty jar, store inspects it, accepted jars are washed, clean jars are refilled. Use four large illustrated stages connected clockwise. Add only these exact labels: 'RETURN', 'INSPECT', 'WASH', 'REFILL'. Make the arrow direction and stage order unmistakable.One landscape image with four labeled stages and arrows matching the supplied cycle.Inspect that arrows connect RETURN to INSPECT to WASH to REFILL in that order, with exact labels.