Source: https://ailoot.ai/models/id/google-gemini-nano-banana-2-1/ Canonical: https://ailoot.ai/models/id/google-gemini-nano-banana-2-1/ Language: id # Google: Nano Banana 2.1 [Markdown](https://ailoot.ai/models/id/google-gemini-nano-banana-2-1/index.md) · [JSON](https://ailoot.ai/models/id/google-gemini-nano-banana-2-1/facts.json) ## [Google: Nano Banana 2.1](https://ailoot.ai/models/id/google-gemini-nano-banana-2-1/) Gemini Nano Banana 2.1 menghasilkan dan menyunting gambar secara percakapan dari teks serta materi visual. Model ini meningkatkan rendering teks, tata letak infografik, dan konsistensi antargiliran, dengan keluaran 1K–4K dan hingga 14 gambar referensi untuk deskripsi visual yang ditentukan. - [**Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `google/gemini-nano-banana-2.1`](https://ailoot.ai/models/id/google-gemini-nano-banana-2-1/#method-0) - [**Ailoot Ultra · Gambar** `POST /v1/images/generations` `google/gemini-nano-banana-2.1`](https://ailoot.ai/models/id/google-gemini-nano-banana-2-1/#method-1) - [**Ailoot Ultra · Anthropic Messages** `POST /v1/messages` `google/gemini-nano-banana-2.1`](https://ailoot.ai/models/id/google-gemini-nano-banana-2-1/#method-2) Tentang model Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih. Gemini Nano Banana 2.1 adalah model pembuatan gambar dan penyuntingan berbasis percakapan dari Google. Model ini merupakan pembaruan Nano Banana 2, dengan peningkatan realisme visual, kepatuhan pada instruksi, rendering teks, dan konsistensi karakter dalam penyuntingan berturut-turut. Tabel masukannya mencakup teks, gambar, video, dan PDF, sedangkan keluarannya adalah gambar dan teks. Ini menjadikannya berguna untuk adegan produk, infografik, atau seri visual yang berkembang melalui beberapa revisi spesifik. Model ini menawarkan keluaran 1K, 2K, dan 4K, dengan 1K sebagai default. Model ini tidak mewarisi pilihan 0.5K dari Nano Banana 2. Rasio aspek yang didokumentasikan mencakup 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, dan 21:9, ditambah format tinggi atau panorama 1:4, 4:1, 1:8, dan 8:1. Google menyebut perbaikan artefak pengubinan pada format lebar dan tinggi terakhir tersebut pada 2K dan 4K. Label resolusi merupakan tingkat ukuran, bukan satu persegi panjang tetap: gambar persegi 4K berukuran 4096 × 4096, sedangkan keluaran 16:9 4K yang didokumentasikan berukuran 5504 × 3072. Teks merupakan bagian penting alur kerja visual. Model ini dirancang untuk merender teks bergaya yang terbaca dan menata unsur infografik dengan lebih akurat. Siapkan judul, label, dan urutan baca yang persis, lalu minta gambar dengan teks yang sudah disetujui tersebut. Untuk menu, diagram, atau grafis instruksional, sebutkan hubungan antara keterangan dan unsur visualnya. Google menyarankan membuat redaksi terlebih dahulu lalu meminta gambar, sehingga komposisi visual dimulai dari deskripsi teks yang sudah ditetapkan. Penggabungan gambar referensi mendukung hingga 14 gambar. Profil yang didokumentasikan mencakup konsistensi hingga empat karakter dan kesetiaan visual hingga sepuluh objek. Beri setiap referensi peran: produk yang harus tetap dapat dikenali, penampilan karakter, latar belakang yang dituju, atau gaya visual. Contoh deskripsi produk: “Gunakan gambar A untuk bentuk botol dan label. Gunakan gambar B untuk permukaan dan pencahayaan. Pertahankan produk tanpa perubahan, letakkan di samping handuk terlipat, dan sisakan ruang kosong di atasnya untuk judul yang diberikan.” Grounding Google Web Search dan Image Search dapat menyediakan informasi terkini serta konteks visual untuk pembuatan. Image Search menyediakan gambar web hasil pencarian sebagai referensi; grounding web standar menyediakan informasi tentang subjek. Ini berguna untuk grafis faktual atau adegan yang tampilannya bergantung pada objek nyata. Alur kerja pencarian gambar tidak mendukung pengambilan gambar orang di dunia nyata untuk tujuan ini. Respons yang menggunakan grounding membawa metadata sumber dan atribusi dalam alur kerja Google yang didokumentasikan, sehingga aplikasi perlu menyimpannya bersama hasil yang dihasilkan. Berpikir dapat dikonfigurasi pada tingkat minimal, medium, dan high, dengan medium sebagai default untuk model yang persis ini. Ini membantu model mengolah komposisi dan instruksi yang lebih kompleks sebelum keluaran akhir. Panduan gambar menjelaskan gambar komposisi sementara dalam proses tersebut; gambar itu berbeda dari hasil akhir yang dituju. Pilih tata letak akhir, rasio aspek, dan resolusi yang diperlukan secara eksplisit, alih-alih mengharapkan deskripsi prompt saja menentukan setiap pengaturan keluaran. Penyuntingan berbasis percakapan memungkinkan tindak lanjut mengubah satu bagian dari hasil yang sudah ada: menyesuaikan cahaya, memindahkan objek, atau menerjemahkan label sambil mempertahankan komposisi lainnya. Bawa gambar atau interaksi sebelumnya ke giliran berikutnya dan nyatakan perubahan yang diminta serta ciri yang harus dipertahankan. Untuk seri karakter, pertahankan referensi penampilan yang konsisten dan gunakan referensi pose jika sudut baru atau pose rumit penting. Deskripsi revisi praktis dapat berbunyi: “Pertahankan produk, label, dan tata letak; ubah hanya latar belakang menjadi abu-abu yang lebih hangat.” Tabel model memberikan batas masukan 131072 token dan batas keluaran 32768 token. Pembuatan gambar dan grounding pencarian didukung, sedangkan pembuatan audio, eksekusi kode, pemanggilan fungsi, keluaran terstruktur, caching, pencarian berkas, konteks URL, dan Live API tidak tercantum sebagai didukung untuk edisi ini. Video dapat memberi informasi bagi gambar diam yang dihasilkan; ini tidak menjadikan model tersebut pembuat video. Google juga menyatakan bahwa permintaan jumlah gambar yang persis mungkin tidak menghasilkan jumlah tersebut. Semua gambar yang dihasilkan menyertakan watermark SynthID. Untuk deskripsi awal yang berguna, berikan tujuan gambar, subjek, komposisi, pencahayaan, sudut kamera, teks yang diperlukan, dan bentuk keluaran. Misalnya, minta infografik potret dengan tiga langkah berlabel, judul yang terbaca, dan hierarki warna tertentu, lalu tinjau redaksi serta penempatan relatif sebelum penyuntingan berikutnya. Hasil dapat menjadi ilustrasi produk, grafis editorial, atau referensi desain, dengan gambar yang dipilih dan teks penjelasnya disimpan bersama. Tugas praktis ### Tugas praktis Contoh teknis dalam bahasa Inggris ``` Refine an approved poster background Edit the supplied event poster. Preserve every word, the headline hierarchy, illustration placement and portrait composition. Change only the background from cool white to warm ivory, keeping dark text readable and retaining the original accent color. Do not add shapes, badges, textures or extra captions. Return the revised poster image. ``` #### Hasil yang diharapkan ``` One edited poster with the original wording and layout preserved over a warm ivory background. ``` #### Periksa hasil ``` Compare every word and element position against the supplied poster, then inspect text contrast. ``` **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `google/gemini-nano-banana-2.1` [`google/gemini-nano-banana-2.1`](https://ailoot.ai/models/id/#m=google%2Fgemini-nano-banana-2.1&route=Ultra&caller=google%2Fgemini-nano-banana-2.1&fmt=chat) Google /`google/gemini-nano-banana-2.1` ### Mulai Gemini Nano Banana 2.1 menghasilkan dan menyunting gambar secara percakapan dari teks serta materi visual. Model ini meningkatkan rendering teks, tata letak infografik, dan konsistensi antargiliran, dengan keluaran 1K–4K dan hingga 14 gambar referensi untuk deskripsi visual yang ditentukan. Masukan yang diterima Teks Hasil Teks ### Tersedia di Ailoot · masukan & metode **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` Masukan `text` Keluaran `text` Format keluaran json atau SSE | Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan | | --- | --- | --- | --- | --- | | Kolom`model` | Jenis`string` | PersyaratanWajib | Nilai & batasan google/gemini-nano-banana-2.1 | Bawaan— | | Kolom`messages` | Jenis`message[]` | PersyaratanWajib | Nilai & batasan Item minimum: 1 | Bawaan— | | Kolom`messages[].role` | Jenis`string` | 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— | | Kolom`messages[].content` | Jenis`string\|content_part[]\|null` | PersyaratanOpsional | Nilai & batasan | Bawaan— | | Kolom`messages[].tool_calls` | Jenis`tool_call[]` | PersyaratanOpsional | Nilai & batasan | Bawaan— | | Kolom`messages[].tool_call_id` | Jenis`string` | PersyaratanOpsional | Nilai & batasan Berlaku jika: role=tool; gunakan ID yang benar-benar dikembalikan | Bawaan— | | Kolom`messages[].name` | Jenis`string` | PersyaratanOpsional | Nilai & batasan | Bawaan— | | Kolom`messages[].reasoning_content` | Jenis`string` | PersyaratanOpsional | Nilai & batasan Berlaku jika: Kirim kembali penalaran yang benar-benar dikembalikan jika model ini menggunakannya | Bawaan— | | Kolom`messages[].reasoning_details` | Jenis`object\|array` | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— | | Kolom`max_tokens` | Jenis`integer` | PersyaratanOpsional | Nilai & batasan Minimum: 1 Bergantung pada model | Bawaan— | | Kolom`max_completion_tokens` | Jenis`integer` | PersyaratanOpsional | Nilai & batasan Minimum: 1 Bergantung pada model | Bawaan— | | Kolom`stream` | Jenis`boolean` | PersyaratanOpsional | Nilai & batasan | Bawaanfalse | | Kolom`stream_options.include_usage` | Jenis`boolean` | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— | | Kolom`temperature` | Jenis`number` | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— | | Kolom`top_p` | Jenis`number` | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— | | Kolom`stop` | Jenis`string\|string[]` | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— | | Kolom`tools` | Jenis`function_tool[]` | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— | | Kolom`tools[].type` | Jenis`string` | PersyaratanOpsional | Nilai & batasan function Bergantung pada model | Bawaan— | | Kolom`tools[].function.name` | Jenis`string` | PersyaratanWajib | Nilai & batasan Berlaku jika: alat fungsi disediakan | Bawaan— | | Kolom`tools[].function.description` | Jenis`string` | PersyaratanOpsional | Nilai & batasan | Bawaan— | | Kolom`tools[].function.parameters` | Jenis`JSON_schema` | PersyaratanOpsional | Nilai & batasan | Bawaan— | | Kolom`tool_choice` | Jenis`string\|object` | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— | | Kolom`parallel_tool_calls` | Jenis`boolean` | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— | | Kolom`response_format` | Jenis`object` | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— | | Kolom`reasoning_effort` | Jenis`string` | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— | | Kolom`reasoning` | Jenis`object` | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— | | Kolom`service_tier` | Jenis`string` | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— | | Kolom`instructions` | Jenis`string` | PersyaratanOpsional | Nilai & batasan Kolom kompatibilitas | Bawaan— | | Kolom`functions` | Jenis`function[]` | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— | | Kolom`function_call` | Jenis`string\|object` | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— | | Kolom`prompt_cache_options` | Jenis`object` | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— | | Kolom`modalities` | Jenis`string[]` | PersyaratanOpsional | Nilai & batasan text | Bawaan— | | Kolom`provider` | Jenis`object` | PersyaratanOpsional | Nilai & batasan Kondisi: provider.options ditolak pada rute teks Ultra ini | Bawaan— | | Kolom`cache_control.ttl` | Jenis`string` | PersyaratanOpsional | Nilai & batasan Kondisi: 1h ditolak pada lokasi cache prompt yang digunakan | Bawaan— | Kombinasi bahan masukan **Teks** · Teks UTF8 `messages[].content` Parameter metode dan siklus hidup | Parameter | Kontrak | | --- | --- | | Parameter`content_type` | Kontrakapplication/json | | Parameter`required` | Kontrakmodel, messages | | Parameter`material_types` | Kontraktext | | Parameter`messages` | Kontrakarray pesan dengan struktur role/content | | Parameter`file_material` | Kontrakdokumen UTF-8 yang sebenarnya dimasukkan sebagai teks apa adanya; ID file tidak disimpulkan | | Parameter`optional_controls` | Kontrakstream, temperature, top\_p, stop, max\_tokens, max\_completion\_tokens, reasoning, response\_format, tools, tool\_choice | | Parameter`control_scope` | Kontrakkhusus model; alat fungsi pengguna berbeda dari alat yang dihosting | | Parameter`output_modalities` | Kontraktext | | Parameter`hosted_operations` | Kontrakfalse | | Parameter`multimodal_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. ### Paket Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih. Mode Fast Tarif standar Saat mode fast dipilih Mode Flex Tarif standar Saat mode flex dipilih Upaya penalaran maksimum Tarif standar Saat upaya penalaran maksimum menggunakan penyesuaian default Upaya penalaran · high Tarif standar Saat upaya penalaran bernilai high Upaya penalaran · minimal Tarif standar Saat upaya penalaran bernilai minimal Harga cache eksplisit Tidak diaktifkan Saat cache eksplisit diminta #### Tarif Ailoot #### Harga menurut konfigurasi 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.003** / 1K token Keluaran · Token keluaran **$0.015** / 1K token Masukan · Pembacaan cache **—** / 1K token Masukan · Penulisan cache **—** / 1K token Masukan · Penulisan cache, 1 jam **—** / 1K token Keluaran · Token gambar keluaran **$0.06** / 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.003** / 1K token Keluaran · Token keluaran **$0.015** / 1K token Masukan · Pembacaan cache **—** / 1K token Masukan · Penulisan cache **—** / 1K token Masukan · Penulisan cache, 1 jam **—** / 1K token | #### Detail tarif referensi Jadwal referensi tingkat model tidak mengubah pemilihan metode, estimasi harga, atau biaya. Biaya aktif menggunakan tarif metode Ailoot yang dipilih. Google: Nano Banana 2.1 #### Harga menurut konfigurasi | Konfigurasi | Kondisi penagihan | Biaya | | --- | --- | --- | | KonfigurasiGoogle: Nano Banana 2.1 · Konfigurasi bawaan | Kondisi penagihanKonfigurasi bawaan | Biaya Masukan · Token masukan **US$0,003** / 1K token Keluaran · Token keluaran **US$0,015** / 1K token Keluaran · Gambar keluaran **US$0,06** / 1K token Keluaran · Pencarian web **US$0,028** per pencarian | 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 →](https://ailoot.ai/docs/id/billing/reserve/) ### Contoh permintaan #### Ailoot Ultra · OpenAI Chat curlPython SDKAliran Python ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" python3 - <<'PY_REQUEST' import json,os from pathlib import Path p=json.loads('{"model": "google/gemini-nano-banana-2.1", "messages": [{"role": "user", "content": "Explain the difference between an observation and a hypothesis in three sentences."}]}') Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import json from pathlib import Path r=json.loads(Path("result.json").read_text()) for x in r.get("choices",[]): if x.get("message",{}).get("content"): print(x["message"]["content"]) PY_RESULT ``` ```python from openai import OpenAI import os if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request") client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0) result=client.chat.completions.create(model='google/gemini-nano-banana-2.1',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) import base64, json from pathlib import Path def save_result(data, stem="result"): # Keep every field, including usage, IDs, reasoning and tool requests. Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8") print(json.dumps(data, ensure_ascii=False, indent=2)) def save_blob(encoded, suffix, label): raw = base64.b64decode(encoded, altchars=b"-_", validate=True) 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 file = Path(stem + "-" + label + "." + ext) file.write_bytes(raw) print("Saved", file) for index, block in enumerate(data.get("content") or []): print("Content", index, json.dumps(block, ensure_ascii=False)) for choice in data.get("choices") or []: print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False)) for index, item in enumerate(data.get("output") or []): print("Output", index, json.dumps(item, ensure_ascii=False)) if item.get("type") == "image_generation_call" and item.get("result"): save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index)) for ci, candidate in enumerate(data.get("candidates") or []): for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []): print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False)) blob = part.get("inlineData") or part.get("inline_data") if blob and blob.get("data"): mime = blob.get("mimeType") or blob.get("mime_type") suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin") save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi)) save_result(result.to_dict(mode="json")) ``` ```python from openai import OpenAI import os from pathlib import Path if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request") client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0) import base64, json from pathlib import Path def save_result(data, stem="result"): # Keep every field, including usage, IDs, reasoning and tool requests. Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8") print(json.dumps(data, ensure_ascii=False, indent=2)) def save_blob(encoded, suffix, label): raw = base64.b64decode(encoded, altchars=b"-_", validate=True) 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 file = Path(stem + "-" + label + "." + ext) file.write_bytes(raw) print("Saved", file) for index, block in enumerate(data.get("content") or []): print("Content", index, json.dumps(block, ensure_ascii=False)) for choice in data.get("choices") or []: print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False)) for index, item in enumerate(data.get("output") or []): print("Output", index, json.dumps(item, ensure_ascii=False)) if item.get("type") == "image_generation_call" and item.get("result"): save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index)) for ci, candidate in enumerate(data.get("candidates") or []): for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []): print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False)) blob = part.get("inlineData") or part.get("inline_data") if blob and blob.get("data"): mime = blob.get("mimeType") or blob.get("mime_type") suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin") save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi)) with client.chat.completions.stream(model='google/gemini-nano-banana-2.1',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) as stream: with Path("stream-events.jsonl").open("w",encoding="utf-8") as log: for event in stream: payload=event.to_dict(mode="json") log.write(json.dumps(payload,ensure_ascii=False)+"\n"); log.flush() print(json.dumps(payload,ensure_ascii=False)) final=stream.get_final_completion() save_result(final.to_dict(mode="json"),"stream-result") ``` ### Terima dan simpan hasil #### Ailoot Ultra · OpenAI Chat json atau SSE ##### Simpan semua hasil yang selesai 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. ##### Jika respons asli perlu diperiksa Simpan ID permintaan/respons dan header. URL umum untuk pengambilan tugas teks tidak disediakan. Kolom respons | Kolom | Jenis | | --- | --- | | Kolom`choices[].index` | Jenisinteger | | Kolom`choices[].message.content` | Jenisstring\|null | | Kolom`choices[].message.tool_calls` | Jenistool\_call\[\] | | Kolom`choices[].message.reasoning_content` | Jenisstring | | Kolom`choices[].message.reasoning_details` | Jenisobject\|array | | Kolom`choices[].finish_reason` | Jenisstring\|null | | Kolom`usage` | Jenisobject | Kesalahan dan langkah berikutnya | 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. | ### Alias #### Alias model **Ailoot Ultra** [`google/gemini-nano-banana-2.1`](https://ailoot.ai/models/id/#m=google%2Fgemini-nano-banana-2.1&route=Ultra&caller=google%2Fgemini-nano-banana-2.1&fmt=chat) #### Alias jalur metode `/v1/images` #### ID pemanggil terkait [`google/gemini-nano-banana-2.1`](https://ailoot.ai/models/id/#m=google%2Fgemini-nano-banana-2.1&route=Ultra&caller=google%2Fgemini-nano-banana-2.1&fmt=chat) **Ailoot Ultra · Gambar** `POST /v1/images/generations` `google/gemini-nano-banana-2.1` [`google/gemini-nano-banana-2.1`](https://ailoot.ai/models/id/#m=google%2Fgemini-nano-banana-2.1&route=Ultra&caller=google%2Fgemini-nano-banana-2.1&fmt=images) Google /`google/gemini-nano-banana-2.1` ### Mulai Gemini Nano Banana 2.1 menghasilkan dan menyunting gambar secara percakapan dari teks serta materi visual. Model ini meningkatkan rendering teks, tata letak infografik, dan konsistensi antargiliran, dengan keluaran 1K–4K dan hingga 14 gambar referensi untuk deskripsi visual yang ditentukan. Masukan yang diterima Teks · Gambar Hasil Gambar ### Tersedia di Ailoot · masukan & metode **Ailoot Ultra · Gambar** `POST /v1/images/generations` Masukan `text`, `image` Keluaran `image` | Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan | | --- | --- | --- | --- | --- | | Kolom`model` | Jenis`string` | PersyaratanWajib | Nilai & batasan google/gemini-nano-banana-2.1 | Bawaan— | | Kolom`prompt` | Jenis`string` | PersyaratanWajib | Nilai & batasan Panjang minimum: 1 | Bawaan— | | Kolom`resolution` | Jenis`string` | PersyaratanOpsional | Nilai & batasan 1K, 2K, 4K | Bawaan— | | Kolom`aspect_ratio` | Jenis`string` | PersyaratanOpsional | Nilai & batasan 1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9 | Bawaan— | | Kolom`n` | Jenis`integer` | PersyaratanOpsional | Nilai & batasan Minimum: 1 Maksimum: 1 | Bawaan— | | Kolom`input_references` | Jenis`array` | PersyaratanOpsional | Nilai & batasan Item minimum: 0 Item maksimum: 14 | Bawaan— | | Kolom`provider` | Jenis`object` | PersyaratanOpsional | Nilai & batasan | Bawaan— | Parameter metode dan siklus hidup | Parameter | Kontrak | | --- | --- | | Parameter`content_type` | Kontrakapplication/json | | Parameter`required` | Kontrakmodel, prompt | | Parameter`material_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}` ### Paket ##### Cara menghitung biaya akhir 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. Mode Fast Tidak ditentukan Saat mode fast dipilih Mode Flex Tidak ditentukan Saat mode flex dipilih Upaya penalaran maksimum Tidak ditentukan Saat upaya penalaran maksimum menggunakan penyesuaian default #### Perkiraan tarif untuk perbandingan #### Harga menurut konfigurasi 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.24576** 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 →](https://ailoot.ai/docs/id/billing/reserve/) ### Contoh permintaan #### Ailoot Ultra · Gambar curl ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" export AILOOT_API_KEY python3 - <<'PY_REQUEST' import json,os from pathlib import Path p={'model': 'google/gemini-nano-banana-2.1', 'prompt': 'a red panda astronaut floating in space, studio lighting'} Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import base64, json, os, subprocess from pathlib import Path from urllib.parse import urlsplit, urljoin def save_images(items): if not items: raise SystemExit("No completed images; retain the full response") for index, item in enumerate(items): encoded=item.get("b64_json") uri=item.get("url", "") if not encoded and uri.startswith("data:image/"): header, separator, encoded=uri.partition(",") if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI") if encoded: raw=base64.b64decode(encoded,validate=True) elif uri: uri=urljoin("https://api.ailoot.ai",uri) parsed=urlsplit(uri) if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password: raise SystemExit("Invalid returned image URL") owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content") args=["curl","--fail-with-body","--silent","--show-error",uri] if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]] temporary=Path(f"image-{index}.bin") subprocess.run(args+["-o",str(temporary)],check=True) raw=temporary.read_bytes() temporary.unlink() else: raise SystemExit("Image has neither bytes nor URL") if not raw: raise SystemExit("Empty image result") 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"