Skip to main content
POST
Petunjuk kompatibilitas nama model: gemini-3.1-flash-lite-image kompatibel dengan alias nano-banana-2-lite, gemini-3.1-flash-lite-image-ext kompatibel dengan alias nano-banana-2-lite-ext. Setiap nama setara dengan aliasnya dan dapat digunakan secara bergantian.

Otorisasi

string
wajib
Semua endpoint API memerlukan autentikasi Bearer TokenDapatkan API Key Anda:Kunjungi Halaman Manajemen API Key untuk mendapatkan API Key AndaTambahkan ke header permintaan:

Body

string
default:"gemini-3.1-flash-lite-image"
wajib
Nama model pembuatan gambarMendukung nama model berikut:
  • gemini-3.1-flash-lite-image (Nano Banana Lite, kompatibel dengan alias nano-banana-2-lite)
  • gemini-3.1-flash-lite-image-ext (kompatibel dengan alias nano-banana-2-lite-ext)
Keduanya memiliki parameter dan batasan yang sama (hanya 1K, tidak mendukung google_search / official_fallback, maksimum 14 gambar referensi). Keduanya tidak memiliki varian -official dan tidak mendukung parameter fallback official_fallback. Penagihan mengikuti konfigurasi backend dari masing-masing kanal.Alias nano-banana-2-lite (sesuai dengan gemini-3.1-flash-lite-image) dan nano-banana-2-lite-ext (sesuai dengan gemini-3.1-flash-lite-image-ext) setara dengan nama aslinya masing-masing dan dapat digunakan secara bergantian.
string
wajib
Deskripsi teks untuk pembuatan gambar
string
Rasio aspek gambarRasio yang didukung:
  • auto - Memilih rasio aspek secara otomatis
  • 1:1 - Persegi, avatars, social media
  • 3:2 / 2:3 - Foto standar
  • 4:3 / 3:4 - Rasio tampilan tradisional
  • 16:9 / 9:16 - Layar lebar / vertical video covers
  • 5:4 / 4:5 - Instagram images
  • 21:9 - Ultra-lebar banner
Untuk text-to-image, saat size bernilai auto, default-nya adalah 1:1 atau 16:9; untuk image-to-image, rasio aspek mengikuti respons upstream. (Kami menyarankan untuk menentukan rasio aspek.)
string
default:"1K"
Resolusi gambar outputNilai yang didukung:
  • 1K - ~1024px, resolusi standar (Lite hanya mendukung tingkat ini)
Lite hanya mendukung 1K. Mengirim 2K / 4K / 0.5K akan secara diam-diam diturunkan ke 1K, tanpa error dan tanpa benar-benar menghasilkan resolusi tinggi. UI frontend tidak perlu menampilkan opsi resolusi.
integer
default:"1"
Jumlah gambar yang akan dibuatRentang: 1 ~ 4, default 1Saat n>1, backend akan mengirim beberapa permintaan bersamaan ke upstream dan menagih berdasarkan jumlah gambar yang benar-benar berhasil. Disarankan frontend selalu mengirim 1 (menampilkan progres per gambar, penagihan lebih jelas).⚠️ Catatan: Harus memasukkan angka biasa (misalnya 1), jangan gunakan tanda kutip karena akan menyebabkan error
array
Daftar URL gambar referensi untuk pembuatan image-to-imageDua format didukung:1. URL gambar lengkap
  • URL gambar yang dapat diakses publik (http:// atau https://)
  • Contoh: https://example.com/image.jpg
2. Format berenkode Base64
  • Harus menggunakan format Data URI lengkap
  • Format: data:image/{format};base64,{base64data}
  • Format gambar yang didukung: jpeg, png, webp
  • Contoh: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • ⚠️ Catatan: Harus menyertakan prefiks data:image/jpeg;base64,
Batasan:
  • Maksimum 14 gambar referensi (disarankan: hingga 10 referensi objek + 4 referensi karakter)
  • Ukuran satu gambar: tidak melebihi 10MB
  • Format yang didukung: jpeg, png, webp
string
Alamat callback tugas (base)Saat tugas berhasil / gagal, platform ini akan memanggil callback webhook + /callback (tidak meneruskan upstream). Mengirim parameter ini dapat secara signifikan mengurangi polling; tetap disarankan mempertahankan polling sebagai cadangan.
Poin penting penggunaan Lite
  • Tidak mendukung google_search / google_image_search: Lite menggunakan endpoint interactions dari Developer API, upstream tidak membuka tool Search (akan mengembalikan “Search as tool is not enabled for this model”), dan adaptor platform juga tidak mengirimkan parameter tersebut. Mengirimnya tidak akan menyebabkan error dan gambar tetap dihasilkan seperti biasa, tetapi tanpa efek peningkatan pencarian apa pun. Jika membutuhkan peningkatan pencarian, gunakan gemini-3.1-flash-image-preview.
  • Tidak mendukung inpainting mask_url (seri Gemini menggunakan aspect ratio + gambar referensi, bukan mask).
  • Ditagih berdasarkan token (berbeda dari harga tetap per gambar pada flash/pro): input sekitar 0.25/jutatoken,outputgambarsekitar0.25/juta token, output gambar sekitar 30/juta token, satu gambar 1K ≈ 1120 output token ≈ $0.0336/gambar. Harga sebenarnya mengikuti konfigurasi pengali di backend.
  • Semua gambar yang dihasilkan mengandung watermark tak terlihat Google SynthID (perilaku upstream, tidak dapat dinonaktifkan).

Respons

integer
Kode status respons
array
Array data respons