Nano Banana 2 adalah model Gemini 3.1 Flash Image Google untuk pembuatan gambar dan penyuntingan melalui percakapan. Entri ini mempertahankan identitas Preview yang tepat. Deskripsi tertulis dapat mendefinisikan visual baru, sedangkan gambar masukan dapat menetapkan subjek, penampilan, atau komposisi yang akan dimodifikasi. Hasil dapat berisi gambar dan teks pendamping. Materi peluncuran Google menekankan pengetahuan dunia, rendering teks, dan konsistensi subjek, bersama kemampuan menyempurnakan adegan melalui giliran yang saling berkaitan.
Untuk kreasi visual yang berlandaskan sumber, model yang didokumentasikan dapat menggunakan informasi pencarian web dan gambar sebagai landasan pembuatan. Hal ini mendukung tugas seperti ilustrasi terinspirasi lokasi atau diagram berdasarkan informasi yang diberikan. Definisikan fakta sumber yang harus direpresentasikan dan bedakan fakta tersebut dari pilihan artistik. Pembuatan yang diinformasikan pencarian tidak menjadikan setiap detail gambar akhir sebagai pernyataan terverifikasi. Jika produk, tengara, atau diagram harus akurat, berikan referensi otoritatifnya dan periksa keluaran terhadap referensi tersebut.
Peluncuran menjelaskan peningkatan rendering teks dalam gambar dan lokalisasi. Untuk poster, infografis, atau mockup pemasaran, berikan kata-kata persis, bahasa, dan peran setiap elemen teks. Tetapkan terlebih dahulu naskah teksnya, lalu minta visual yang memuatnya, sesuai saran panduan gambar. Jelaskan urutan baca dan penekanan relatif agar judul utama, keterangan, dan label diagram tidak tertukar. Tinjau ejaan, tanda baca, dan hubungan antara label dan elemen yang diilustrasikan sebelum menggunakan gambar dalam publikasi.
Kontrol kreatif mencakup rasio aspek dan resolusi. Peluncuran menambahkan keluaran 512 piksel bersama pilihan 1K, 2K, dan 4K, serta menambahkan rasio aspek 4:1, 1:4, 8:1, dan 1:8. Panduan pengembang mengidentifikasi thinking minimal sebagai bawaan dan thinking high sebagai opsi untuk komposisi yang lebih rumit. Pilih penggunaan yang dimaksud sebelum menyusun komposisi: story vertikal, banner lebar, dan diagram ringkas memerlukan ruang berbeda untuk subjek serta tulisan. Pengaturan tersebut menjelaskan alur pembuatan dari pembuat untuk lini ini, bukan perubahan ukuran otomatis atas aset selesai yang sudah ada.
Untuk konsistensi subjek, beri label peran setiap referensi: penampilan produk, identitas karakter, latar belakang, atau gaya visual. Nyatakan detail yang harus dipertahankan, lalu sebutkan elemen yang harus diubah. Contoh tugas dapat menempatkan foto produk yang diberikan dalam adegan baru sambil mempertahankan bentuk, material, dan merek yang terlihat. Untuk rangkaian ilustrasi, pertahankan referensi yang sama dan definisikan detail spesifik adegan mana yang berubah. Referensi yang lebih banyak tidak menggantikan instruksi jelas tentang kontribusi setiap gambar.
Penyuntingan melalui percakapan berguna untuk revisi tertentu. Minta penyesuaian satu objek, latar belakang, atau pencahayaan sambil mempertahankan komposisi yang diterima. Panduan pembuat menjelaskan semantic masking, ketika area yang disunting diidentifikasi dengan kata-kata. Untuk pekerjaan multigiliran, pertahankan percakapan dan metadata konteks penalaran yang diwajibkan dalam antarmuka terpilih; panduan Gemini 3 menjelaskan bahwa thought signatures membantu membawa konteks tersebut. Deskripsi wilayah yang tidak diubah adalah instruksi untuk ditinjau terhadap gambar asli, bukan jaminan bahwa setiap piksel tetap identik.
Tabel pengembang Gemini 3 secara eksplisit menyebut gemini-3.1-flash-image-preview dengan alokasi masukan 128K dan keluaran 32K. Pertahankan nama model Preview yang tepat ketika mencatat suatu pembuatan. Pengaturan referensi, keluaran, dan resolusi yang tersedia harus disimpan bersama gambar sumber dan permintaan agar revisi dapat direproduksi secara konsisten. Untuk revisi, gunakan referensi sumber yang sama dan tentukan perubahan visual yang tepat, sambil mempertahankan peran setiap masukan yang telah diterima.
Panduan gambar memperingatkan bahwa jumlah gambar yang diminta mungkin tidak selalu diikuti dan mengidentifikasi penandaan SynthID untuk gambar yang dihasilkan. Periksa semua gambar yang dikembalikan dan teks pendamping apa pun, alih-alih menganggap hasilnya satu gambar tetap. Periksa identitas subjek, jumlah objek, kata-kata dalam gambar, komposisi, dan kesetiaan referensi pada ukuran tampilan yang dimaksud. Untuk adegan kompleks, tentukan komponen dalam urutan logis dan jelaskan penampilan yang diinginkan secara positif. Hasil yang berguna adalah aset visual yang telah ditinjau, dengan referensi sumber dan identitas model yang tepat disimpan untuk penyuntingan berikutnya.
", "aboutText": "Nano Banana 2 adalah model Gemini 3.1 Flash Image Google untuk pembuatan gambar dan penyuntingan melalui percakapan. Entri ini mempertahankan identitas Preview yang tepat. Deskripsi tertulis dapat mendefinisikan visual baru, sedangkan gambar masukan dapat menetapkan subjek, penampilan, atau komposisi yang akan dimodifikasi. Hasil dapat berisi gambar dan teks pendamping. Materi peluncuran Google menekankan pengetahuan dunia, rendering teks, dan konsistensi subjek, bersama kemampuan menyempurnakan adegan melalui giliran yang saling berkaitan.\n\nUntuk kreasi visual yang berlandaskan sumber, model yang didokumentasikan dapat menggunakan informasi pencarian web dan gambar sebagai landasan pembuatan. Hal ini mendukung tugas seperti ilustrasi terinspirasi lokasi atau diagram berdasarkan informasi yang diberikan. Definisikan fakta sumber yang harus direpresentasikan dan bedakan fakta tersebut dari pilihan artistik. Pembuatan yang diinformasikan pencarian tidak menjadikan setiap detail gambar akhir sebagai pernyataan terverifikasi. Jika produk, tengara, atau diagram harus akurat, berikan referensi otoritatifnya dan periksa keluaran terhadap referensi tersebut.\n\nPeluncuran menjelaskan peningkatan rendering teks dalam gambar dan lokalisasi. Untuk poster, infografis, atau mockup pemasaran, berikan kata-kata persis, bahasa, dan peran setiap elemen teks. Tetapkan terlebih dahulu naskah teksnya, lalu minta visual yang memuatnya, sesuai saran panduan gambar. Jelaskan urutan baca dan penekanan relatif agar judul utama, keterangan, dan label diagram tidak tertukar. Tinjau ejaan, tanda baca, dan hubungan antara label dan elemen yang diilustrasikan sebelum menggunakan gambar dalam publikasi.\n\nKontrol kreatif mencakup rasio aspek dan resolusi. Peluncuran menambahkan keluaran 512 piksel bersama pilihan 1K, 2K, dan 4K, serta menambahkan rasio aspek 4:1, 1:4, 8:1, dan 1:8. Panduan pengembang mengidentifikasi thinking minimal sebagai bawaan dan thinking high sebagai opsi untuk komposisi yang lebih rumit. Pilih penggunaan yang dimaksud sebelum menyusun komposisi: story vertikal, banner lebar, dan diagram ringkas memerlukan ruang berbeda untuk subjek serta tulisan. Pengaturan tersebut menjelaskan alur pembuatan dari pembuat untuk lini ini, bukan perubahan ukuran otomatis atas aset selesai yang sudah ada.\n\nUntuk konsistensi subjek, beri label peran setiap referensi: penampilan produk, identitas karakter, latar belakang, atau gaya visual. Nyatakan detail yang harus dipertahankan, lalu sebutkan elemen yang harus diubah. Contoh tugas dapat menempatkan foto produk yang diberikan dalam adegan baru sambil mempertahankan bentuk, material, dan merek yang terlihat. Untuk rangkaian ilustrasi, pertahankan referensi yang sama dan definisikan detail spesifik adegan mana yang berubah. Referensi yang lebih banyak tidak menggantikan instruksi jelas tentang kontribusi setiap gambar.\n\nPenyuntingan melalui percakapan berguna untuk revisi tertentu. Minta penyesuaian satu objek, latar belakang, atau pencahayaan sambil mempertahankan komposisi yang diterima. Panduan pembuat menjelaskan semantic masking, ketika area yang disunting diidentifikasi dengan kata-kata. Untuk pekerjaan multigiliran, pertahankan percakapan dan metadata konteks penalaran yang diwajibkan dalam antarmuka terpilih; panduan Gemini 3 menjelaskan bahwa thought signatures membantu membawa konteks tersebut. Deskripsi wilayah yang tidak diubah adalah instruksi untuk ditinjau terhadap gambar asli, bukan jaminan bahwa setiap piksel tetap identik.\n\nTabel pengembang Gemini 3 secara eksplisit menyebut gemini-3.1-flash-image-preview dengan alokasi masukan 128K dan keluaran 32K. Pertahankan nama model Preview yang tepat ketika mencatat suatu pembuatan. Pengaturan referensi, keluaran, dan resolusi yang tersedia harus disimpan bersama gambar sumber dan permintaan agar revisi dapat direproduksi secara konsisten. Untuk revisi, gunakan referensi sumber yang sama dan tentukan perubahan visual yang tepat, sambil mempertahankan peran setiap masukan yang telah diterima.\n\nPanduan gambar memperingatkan bahwa jumlah gambar yang diminta mungkin tidak selalu diikuti dan mengidentifikasi penandaan SynthID untuk gambar yang dihasilkan. Periksa semua gambar yang dikembalikan dan teks pendamping apa pun, alih-alih menganggap hasilnya satu gambar tetap. Periksa identitas subjek, jumlah objek, kata-kata dalam gambar, komposisi, dan kesetiaan referensi pada ukuran tampilan yang dimaksud. Untuk adegan kompleks, tentukan komponen dalam urutan logis dan jelaskan penampilan yang diinginkan secara positif. Hasil yang berguna adalah aset visual yang telah ditinjau, dengan referensi sumber dan identitas model yang tepat disimpan untuk penyuntingan berikutnya.", "editorialOverlay": { "copy_fields": { "practical_html": "Contoh teknis dalam bahasa Inggris
Create a four-stage growing guide\n\nCreate a friendly flat illustration for a gardening guide showing four tomato-growing stages from left to right: seed in soil, small seedling, leafy plant, mature plant with red tomatoes. Use a warm cream background, consistent pots and simple green shapes. Keep each stage clearly separated. Include no text, numbers, labels or decorative extra plants.An image with four distinct growing stages in the specified order and a consistent illustration style.Inspect the actual image for exactly four stages, the left-to-right progression and absence of text or extra plants.google/gemini-3.1-flash-image-previewNano Banana 2 (Gemini 3.1 Flash Image Preview) membuat dan menyunting gambar dari teks serta referensi visual. Keunggulan yang didokumentasikan mencakup konsistensi subjek, teks dalam gambar dan lokalisasi, perubahan melalui percakapan, serta kontrol kreatif atas komposisi, rasio aspek, dan resolusi.
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Nano Banana 2 adalah model Gemini 3.1 Flash Image Google untuk pembuatan gambar dan penyuntingan melalui percakapan. Entri ini mempertahankan identitas Preview yang tepat. Deskripsi tertulis dapat mendefinisikan visual baru, sedangkan gambar masukan dapat menetapkan subjek, penampilan, atau komposisi yang akan dimodifikasi. Hasil dapat berisi gambar dan teks pendamping. Materi peluncuran Google menekankan pengetahuan dunia, rendering teks, dan konsistensi subjek, bersama kemampuan menyempurnakan adegan melalui giliran yang saling berkaitan.
Untuk kreasi visual yang berlandaskan sumber, model yang didokumentasikan dapat menggunakan informasi pencarian web dan gambar sebagai landasan pembuatan. Hal ini mendukung tugas seperti ilustrasi terinspirasi lokasi atau diagram berdasarkan informasi yang diberikan. Definisikan fakta sumber yang harus direpresentasikan dan bedakan fakta tersebut dari pilihan artistik. Pembuatan yang diinformasikan pencarian tidak menjadikan setiap detail gambar akhir sebagai pernyataan terverifikasi. Jika produk, tengara, atau diagram harus akurat, berikan referensi otoritatifnya dan periksa keluaran terhadap referensi tersebut.
Peluncuran menjelaskan peningkatan rendering teks dalam gambar dan lokalisasi. Untuk poster, infografis, atau mockup pemasaran, berikan kata-kata persis, bahasa, dan peran setiap elemen teks. Tetapkan terlebih dahulu naskah teksnya, lalu minta visual yang memuatnya, sesuai saran panduan gambar. Jelaskan urutan baca dan penekanan relatif agar judul utama, keterangan, dan label diagram tidak tertukar. Tinjau ejaan, tanda baca, dan hubungan antara label dan elemen yang diilustrasikan sebelum menggunakan gambar dalam publikasi.
Kontrol kreatif mencakup rasio aspek dan resolusi. Peluncuran menambahkan keluaran 512 piksel bersama pilihan 1K, 2K, dan 4K, serta menambahkan rasio aspek 4:1, 1:4, 8:1, dan 1:8. Panduan pengembang mengidentifikasi thinking minimal sebagai bawaan dan thinking high sebagai opsi untuk komposisi yang lebih rumit. Pilih penggunaan yang dimaksud sebelum menyusun komposisi: story vertikal, banner lebar, dan diagram ringkas memerlukan ruang berbeda untuk subjek serta tulisan. Pengaturan tersebut menjelaskan alur pembuatan dari pembuat untuk lini ini, bukan perubahan ukuran otomatis atas aset selesai yang sudah ada.
Untuk konsistensi subjek, beri label peran setiap referensi: penampilan produk, identitas karakter, latar belakang, atau gaya visual. Nyatakan detail yang harus dipertahankan, lalu sebutkan elemen yang harus diubah. Contoh tugas dapat menempatkan foto produk yang diberikan dalam adegan baru sambil mempertahankan bentuk, material, dan merek yang terlihat. Untuk rangkaian ilustrasi, pertahankan referensi yang sama dan definisikan detail spesifik adegan mana yang berubah. Referensi yang lebih banyak tidak menggantikan instruksi jelas tentang kontribusi setiap gambar.
Penyuntingan melalui percakapan berguna untuk revisi tertentu. Minta penyesuaian satu objek, latar belakang, atau pencahayaan sambil mempertahankan komposisi yang diterima. Panduan pembuat menjelaskan semantic masking, ketika area yang disunting diidentifikasi dengan kata-kata. Untuk pekerjaan multigiliran, pertahankan percakapan dan metadata konteks penalaran yang diwajibkan dalam antarmuka terpilih; panduan Gemini 3 menjelaskan bahwa thought signatures membantu membawa konteks tersebut. Deskripsi wilayah yang tidak diubah adalah instruksi untuk ditinjau terhadap gambar asli, bukan jaminan bahwa setiap piksel tetap identik.
Tabel pengembang Gemini 3 secara eksplisit menyebut gemini-3.1-flash-image-preview dengan alokasi masukan 128K dan keluaran 32K. Pertahankan nama model Preview yang tepat ketika mencatat suatu pembuatan. Pengaturan referensi, keluaran, dan resolusi yang tersedia harus disimpan bersama gambar sumber dan permintaan agar revisi dapat direproduksi secara konsisten. Untuk revisi, gunakan referensi sumber yang sama dan tentukan perubahan visual yang tepat, sambil mempertahankan peran setiap masukan yang telah diterima.
Panduan gambar memperingatkan bahwa jumlah gambar yang diminta mungkin tidak selalu diikuti dan mengidentifikasi penandaan SynthID untuk gambar yang dihasilkan. Periksa semua gambar yang dikembalikan dan teks pendamping apa pun, alih-alih menganggap hasilnya satu gambar tetap. Periksa identitas subjek, jumlah objek, kata-kata dalam gambar, komposisi, dan kesetiaan referensi pada ukuran tampilan yang dimaksud. Untuk adegan kompleks, tentukan komponen dalam urutan logis dan jelaskan penampilan yang diinginkan secara positif. Hasil yang berguna adalah aset visual yang telah ditinjau, dengan referensi sumber dan identitas model yang tepat disimpan untuk penyuntingan berikutnya.
POST /v1/chat/completionstexttext| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan google/gemini-3.1-flash-image-preview | 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.001 / 1K token Keluaran · Token keluaran $0.006 / 1K token Masukan · Pembacaan cache — / 1K token Masukan · Penulisan cache — / 1K token Masukan · Penulisan cache, 1 jam — / 1K token Keluaran · Token gambar keluaran $0.12 / 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.001 / 1K token Keluaran · Token keluaran $0.006 / 1K token Masukan · Pembacaan cache — / 1K token Masukan · Penulisan cache — / 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/gemini-3.1-flash-image-preview · Konfigurasi bawaan | Kondisi penagihanKonfigurasi bawaan | Biaya Masukan · Masukan US$0,001 / 1K token Keluaran · Keluaran US$0,12 / 1K token |
| Konfigurasi | Kondisi penagihan | Biaya |
|---|---|---|
| Konfigurasigoogle/gemini-3.1-flash-image-preview · Konfigurasi bawaan | Kondisi penagihanKonfigurasi bawaan | Biaya Masukan · Masukan US$0,001 / 1K token Keluaran · Keluaran US$0,12 / 1K token |
| Konfigurasi | Kondisi penagihan | Biaya |
|---|---|---|
| Konfigurasigoogle/gemini-3.1-flash-image-preview · Konfigurasi bawaan | Kondisi penagihanKonfigurasi bawaan | Biaya Masukan · Masukan US$0,00 per pemanggilan Keluaran · Keluaran US$0,16 per pemanggilan |
| Konfigurasi | Kondisi penagihan | Biaya |
|---|---|---|
| Konfigurasigoogle/gemini-3.1-flash-image-preview · Konfigurasi bawaan | Kondisi penagihanKonfigurasi bawaan | Biaya Masukan · Masukan US$0,00 per pemanggilan Keluaran · Keluaran US$0,32 per pemanggilan |
| Konfigurasi | Kondisi penagihan | Biaya |
|---|---|---|
| Konfigurasigoogle/gemini-3.1-flash-image-preview · Konfigurasi bawaan | Kondisi penagihanKonfigurasi bawaan | Biaya Masukan · Masukan US$0,00 per pemanggilan Keluaran · Keluaran US$0,00 per pemanggilan |
| Konfigurasi | Kondisi penagihan | Biaya |
|---|---|---|
| KonfigurasiGoogle: Nano Banana 2 (Gemini 3.1 Flash Image Preview) · Konfigurasi bawaan | Kondisi penagihanKonfigurasi bawaan | Biaya Masukan · Token masukan US$0,001 / 1K token Keluaran · Token keluaran US$0,006 / 1K token Keluaran · Gambar keluaran US$0,12 / 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 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "google/gemini-3.1-flash-image-preview", "messages": [{"role": "user", "content": "Explain the difference between an observation and a hypothesis in three sentences."}]}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nfor x in r.get("choices",[]):\n if x.get("message",{}).get("content"): print(x["message"]["content"])\nPY_RESULT\nfrom openai import OpenAI\nimport os\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.chat.completions.create(model='google/gemini-3.1-flash-image-preview',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}])\nimport base64, json\nfrom pathlib import Path\n\ndef save_result(data, stem="result"):\n # Keep every field, including usage, IDs, reasoning and tool requests.\n Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")\n print(json.dumps(data, ensure_ascii=False, indent=2))\n def save_blob(encoded, suffix, label):\n raw = base64.b64decode(encoded, altchars=b"-_", validate=True)\n ext = "png" if raw.startswith(b"\\x89PNG\\r\\n\\x1a\\n") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix\n file = Path(stem + "-" + label + "." + ext)\n file.write_bytes(raw)\n print("Saved", file)\n for index, block in enumerate(data.get("content") or []):\n print("Content", index, json.dumps(block, ensure_ascii=False))\n for choice in data.get("choices") or []:\n print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))\n for index, item in enumerate(data.get("output") or []):\n print("Output", index, json.dumps(item, ensure_ascii=False))\n if item.get("type") == "image_generation_call" and item.get("result"):\n save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))\n for ci, candidate in enumerate(data.get("candidates") or []):\n for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):\n print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))\n blob = part.get("inlineData") or part.get("inline_data")\n if blob and blob.get("data"):\n mime = blob.get("mimeType") or blob.get("mime_type")\n suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")\n save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))\n\nsave_result(result.to_dict(mode="json"))\nfrom openai import OpenAI\nimport os\nfrom pathlib import Path\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nimport base64, json\nfrom pathlib import Path\n\ndef save_result(data, stem="result"):\n # Keep every field, including usage, IDs, reasoning and tool requests.\n Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")\n print(json.dumps(data, ensure_ascii=False, indent=2))\n def save_blob(encoded, suffix, label):\n raw = base64.b64decode(encoded, altchars=b"-_", validate=True)\n ext = "png" if raw.startswith(b"\\x89PNG\\r\\n\\x1a\\n") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix\n file = Path(stem + "-" + label + "." + ext)\n file.write_bytes(raw)\n print("Saved", file)\n for index, block in enumerate(data.get("content") or []):\n print("Content", index, json.dumps(block, ensure_ascii=False))\n for choice in data.get("choices") or []:\n print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))\n for index, item in enumerate(data.get("output") or []):\n print("Output", index, json.dumps(item, ensure_ascii=False))\n if item.get("type") == "image_generation_call" and item.get("result"):\n save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))\n for ci, candidate in enumerate(data.get("candidates") or []):\n for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):\n print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))\n blob = part.get("inlineData") or part.get("inline_data")\n if blob and blob.get("data"):\n mime = blob.get("mimeType") or blob.get("mime_type")\n suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")\n save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))\n\nwith client.chat.completions.stream(model='google/gemini-3.1-flash-image-preview',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 Ultra google/gemini-3.1-flash-image-preview
/v1/images
google/gemini-3.1-flash-image-previewNano Banana 2 (Gemini 3.1 Flash Image Preview) membuat dan menyunting gambar dari teks serta referensi visual. Keunggulan yang didokumentasikan mencakup konsistensi subjek, teks dalam gambar dan lokalisasi, perubahan melalui percakapan, serta kontrol kreatif atas komposisi, rasio aspek, dan resolusi.
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Nano Banana 2 adalah model Gemini 3.1 Flash Image Google untuk pembuatan gambar dan penyuntingan melalui percakapan. Entri ini mempertahankan identitas Preview yang tepat. Deskripsi tertulis dapat mendefinisikan visual baru, sedangkan gambar masukan dapat menetapkan subjek, penampilan, atau komposisi yang akan dimodifikasi. Hasil dapat berisi gambar dan teks pendamping. Materi peluncuran Google menekankan pengetahuan dunia, rendering teks, dan konsistensi subjek, bersama kemampuan menyempurnakan adegan melalui giliran yang saling berkaitan.
Untuk kreasi visual yang berlandaskan sumber, model yang didokumentasikan dapat menggunakan informasi pencarian web dan gambar sebagai landasan pembuatan. Hal ini mendukung tugas seperti ilustrasi terinspirasi lokasi atau diagram berdasarkan informasi yang diberikan. Definisikan fakta sumber yang harus direpresentasikan dan bedakan fakta tersebut dari pilihan artistik. Pembuatan yang diinformasikan pencarian tidak menjadikan setiap detail gambar akhir sebagai pernyataan terverifikasi. Jika produk, tengara, atau diagram harus akurat, berikan referensi otoritatifnya dan periksa keluaran terhadap referensi tersebut.
Peluncuran menjelaskan peningkatan rendering teks dalam gambar dan lokalisasi. Untuk poster, infografis, atau mockup pemasaran, berikan kata-kata persis, bahasa, dan peran setiap elemen teks. Tetapkan terlebih dahulu naskah teksnya, lalu minta visual yang memuatnya, sesuai saran panduan gambar. Jelaskan urutan baca dan penekanan relatif agar judul utama, keterangan, dan label diagram tidak tertukar. Tinjau ejaan, tanda baca, dan hubungan antara label dan elemen yang diilustrasikan sebelum menggunakan gambar dalam publikasi.
Kontrol kreatif mencakup rasio aspek dan resolusi. Peluncuran menambahkan keluaran 512 piksel bersama pilihan 1K, 2K, dan 4K, serta menambahkan rasio aspek 4:1, 1:4, 8:1, dan 1:8. Panduan pengembang mengidentifikasi thinking minimal sebagai bawaan dan thinking high sebagai opsi untuk komposisi yang lebih rumit. Pilih penggunaan yang dimaksud sebelum menyusun komposisi: story vertikal, banner lebar, dan diagram ringkas memerlukan ruang berbeda untuk subjek serta tulisan. Pengaturan tersebut menjelaskan alur pembuatan dari pembuat untuk lini ini, bukan perubahan ukuran otomatis atas aset selesai yang sudah ada.
Untuk konsistensi subjek, beri label peran setiap referensi: penampilan produk, identitas karakter, latar belakang, atau gaya visual. Nyatakan detail yang harus dipertahankan, lalu sebutkan elemen yang harus diubah. Contoh tugas dapat menempatkan foto produk yang diberikan dalam adegan baru sambil mempertahankan bentuk, material, dan merek yang terlihat. Untuk rangkaian ilustrasi, pertahankan referensi yang sama dan definisikan detail spesifik adegan mana yang berubah. Referensi yang lebih banyak tidak menggantikan instruksi jelas tentang kontribusi setiap gambar.
Penyuntingan melalui percakapan berguna untuk revisi tertentu. Minta penyesuaian satu objek, latar belakang, atau pencahayaan sambil mempertahankan komposisi yang diterima. Panduan pembuat menjelaskan semantic masking, ketika area yang disunting diidentifikasi dengan kata-kata. Untuk pekerjaan multigiliran, pertahankan percakapan dan metadata konteks penalaran yang diwajibkan dalam antarmuka terpilih; panduan Gemini 3 menjelaskan bahwa thought signatures membantu membawa konteks tersebut. Deskripsi wilayah yang tidak diubah adalah instruksi untuk ditinjau terhadap gambar asli, bukan jaminan bahwa setiap piksel tetap identik.
Tabel pengembang Gemini 3 secara eksplisit menyebut gemini-3.1-flash-image-preview dengan alokasi masukan 128K dan keluaran 32K. Pertahankan nama model Preview yang tepat ketika mencatat suatu pembuatan. Pengaturan referensi, keluaran, dan resolusi yang tersedia harus disimpan bersama gambar sumber dan permintaan agar revisi dapat direproduksi secara konsisten. Untuk revisi, gunakan referensi sumber yang sama dan tentukan perubahan visual yang tepat, sambil mempertahankan peran setiap masukan yang telah diterima.
Panduan gambar memperingatkan bahwa jumlah gambar yang diminta mungkin tidak selalu diikuti dan mengidentifikasi penandaan SynthID untuk gambar yang dihasilkan. Periksa semua gambar yang dikembalikan dan teks pendamping apa pun, alih-alih menganggap hasilnya satu gambar tetap. Periksa identitas subjek, jumlah objek, kata-kata dalam gambar, komposisi, dan kesetiaan referensi pada ukuran tampilan yang dimaksud. Untuk adegan kompleks, tentukan komponen dalam urutan logis dan jelaskan penampilan yang diinginkan secara positif. Hasil yang berguna adalah aset visual yang telah ditinjau, dengan referensi sumber dan identitas model yang tepat disimpan untuk penyuntingan berikutnya.
POST /v1/images/generationstext, imageimage| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan google/gemini-3.1-flash-image-preview | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanWajib | Nilai & batasan Panjang minimum: 1 | Bawaan— |
Kolomresolution | Jenisstring | PersyaratanOpsional | Nilai & batasan 512, 1K, 2K, 4K | Bawaan— |
Kolomaspect_ratio | Jenisstring | 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— |
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.49152 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.1-flash-image-preview', '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 Ultra google/gemini-3.1-flash-image-preview
/v1/images
google/gemini-3.1-flash-image-previewNano Banana 2 (Gemini 3.1 Flash Image Preview) membuat dan menyunting gambar dari teks serta referensi visual. Keunggulan yang didokumentasikan mencakup konsistensi subjek, teks dalam gambar dan lokalisasi, perubahan melalui percakapan, serta kontrol kreatif atas komposisi, rasio aspek, dan resolusi.
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Nano Banana 2 adalah model Gemini 3.1 Flash Image Google untuk pembuatan gambar dan penyuntingan melalui percakapan. Entri ini mempertahankan identitas Preview yang tepat. Deskripsi tertulis dapat mendefinisikan visual baru, sedangkan gambar masukan dapat menetapkan subjek, penampilan, atau komposisi yang akan dimodifikasi. Hasil dapat berisi gambar dan teks pendamping. Materi peluncuran Google menekankan pengetahuan dunia, rendering teks, dan konsistensi subjek, bersama kemampuan menyempurnakan adegan melalui giliran yang saling berkaitan.
Untuk kreasi visual yang berlandaskan sumber, model yang didokumentasikan dapat menggunakan informasi pencarian web dan gambar sebagai landasan pembuatan. Hal ini mendukung tugas seperti ilustrasi terinspirasi lokasi atau diagram berdasarkan informasi yang diberikan. Definisikan fakta sumber yang harus direpresentasikan dan bedakan fakta tersebut dari pilihan artistik. Pembuatan yang diinformasikan pencarian tidak menjadikan setiap detail gambar akhir sebagai pernyataan terverifikasi. Jika produk, tengara, atau diagram harus akurat, berikan referensi otoritatifnya dan periksa keluaran terhadap referensi tersebut.
Peluncuran menjelaskan peningkatan rendering teks dalam gambar dan lokalisasi. Untuk poster, infografis, atau mockup pemasaran, berikan kata-kata persis, bahasa, dan peran setiap elemen teks. Tetapkan terlebih dahulu naskah teksnya, lalu minta visual yang memuatnya, sesuai saran panduan gambar. Jelaskan urutan baca dan penekanan relatif agar judul utama, keterangan, dan label diagram tidak tertukar. Tinjau ejaan, tanda baca, dan hubungan antara label dan elemen yang diilustrasikan sebelum menggunakan gambar dalam publikasi.
Kontrol kreatif mencakup rasio aspek dan resolusi. Peluncuran menambahkan keluaran 512 piksel bersama pilihan 1K, 2K, dan 4K, serta menambahkan rasio aspek 4:1, 1:4, 8:1, dan 1:8. Panduan pengembang mengidentifikasi thinking minimal sebagai bawaan dan thinking high sebagai opsi untuk komposisi yang lebih rumit. Pilih penggunaan yang dimaksud sebelum menyusun komposisi: story vertikal, banner lebar, dan diagram ringkas memerlukan ruang berbeda untuk subjek serta tulisan. Pengaturan tersebut menjelaskan alur pembuatan dari pembuat untuk lini ini, bukan perubahan ukuran otomatis atas aset selesai yang sudah ada.
Untuk konsistensi subjek, beri label peran setiap referensi: penampilan produk, identitas karakter, latar belakang, atau gaya visual. Nyatakan detail yang harus dipertahankan, lalu sebutkan elemen yang harus diubah. Contoh tugas dapat menempatkan foto produk yang diberikan dalam adegan baru sambil mempertahankan bentuk, material, dan merek yang terlihat. Untuk rangkaian ilustrasi, pertahankan referensi yang sama dan definisikan detail spesifik adegan mana yang berubah. Referensi yang lebih banyak tidak menggantikan instruksi jelas tentang kontribusi setiap gambar.
Penyuntingan melalui percakapan berguna untuk revisi tertentu. Minta penyesuaian satu objek, latar belakang, atau pencahayaan sambil mempertahankan komposisi yang diterima. Panduan pembuat menjelaskan semantic masking, ketika area yang disunting diidentifikasi dengan kata-kata. Untuk pekerjaan multigiliran, pertahankan percakapan dan metadata konteks penalaran yang diwajibkan dalam antarmuka terpilih; panduan Gemini 3 menjelaskan bahwa thought signatures membantu membawa konteks tersebut. Deskripsi wilayah yang tidak diubah adalah instruksi untuk ditinjau terhadap gambar asli, bukan jaminan bahwa setiap piksel tetap identik.
Tabel pengembang Gemini 3 secara eksplisit menyebut gemini-3.1-flash-image-preview dengan alokasi masukan 128K dan keluaran 32K. Pertahankan nama model Preview yang tepat ketika mencatat suatu pembuatan. Pengaturan referensi, keluaran, dan resolusi yang tersedia harus disimpan bersama gambar sumber dan permintaan agar revisi dapat direproduksi secara konsisten. Untuk revisi, gunakan referensi sumber yang sama dan tentukan perubahan visual yang tepat, sambil mempertahankan peran setiap masukan yang telah diterima.
Panduan gambar memperingatkan bahwa jumlah gambar yang diminta mungkin tidak selalu diikuti dan mengidentifikasi penandaan SynthID untuk gambar yang dihasilkan. Periksa semua gambar yang dikembalikan dan teks pendamping apa pun, alih-alih menganggap hasilnya satu gambar tetap. Periksa identitas subjek, jumlah objek, kata-kata dalam gambar, komposisi, dan kesetiaan referensi pada ukuran tampilan yang dimaksud. Untuk adegan kompleks, tentukan komponen dalam urutan logis dan jelaskan penampilan yang diinginkan secara positif. Hasil yang berguna adalah aset visual yang telah ditinjau, dengan referensi sumber dan identitas model yang tepat disimpan untuk penyuntingan berikutnya.
POST /v1/messagestextjson, sse| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan google/gemini-3.1-flash-image-preview | 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.001 / 1K token Keluaran · Token keluaran $0.006 / 1K token Masukan · Pembacaan cache — / 1K token Masukan · Penulisan cache — / 1K token Masukan · Penulisan cache, 1 jam — / 1K token Keluaran · Token gambar keluaran $0.12 / 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.001 / 1K token Keluaran · Token keluaran $0.006 / 1K token Masukan · Pembacaan cache — / 1K token Masukan · Penulisan cache — / 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.1-flash-image-preview",\n "max_tokens": 128,\n "messages": [\n {\n "role": "user",\n "content": "Summarize the incident report."\n }\n ],\n "stream": false\n}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 document}"\nexport AILOOT_TEXT_FILE\npython3 - <<'PY_REQUEST'\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'google/gemini-3.1-flash-image-preview', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nPath('request.json').write_text(json.dumps(payload, ensure_ascii=False), encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/messages \\\n -H "x-api-key: $AILOOT_API_KEY" -H 'anthropic-version: 2023-06-01' -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nPY_RESULT\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'google/gemini-3.1-flash-image-preview', '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 Ultra google/gemini-3.1-flash-image-preview
/v1/images
Contoh teknis dalam bahasa Inggris
Create a four-stage growing guide\n\nCreate a friendly flat illustration for a gardening guide showing four tomato-growing stages from left to right: seed in soil, small seedling, leafy plant, mature plant with red tomatoes. Use a warm cream background, consistent pots and simple green shapes. Keep each stage clearly separated. Include no text, numbers, labels or decorative extra plants.An image with four distinct growing stages in the specified order and a consistent illustration style.Inspect the actual image for exactly four stages, the left-to-right progression and absence of text or extra plants.