Skip to main content
POST
Catatan kompatibilitas nama model: Antarmuka ini juga mendukung alias nano-banana-2-ext, yang setara dengan gemini-3.1-flash-image-preview; keduanya dapat digunakan secara bergantian dengan hasil yang sama.

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-image-preview"
wajib
Nama model pembuatan gambarModel yang didukung:
  • gemini-3.1-flash-image-preview - Versi standar (alias kompatibel nano-banana-2-ext)
  • gemini-3.1-flash-image-preview-official - Versi resmi (alias kompatibel nano-banana-2)
Contoh: "gemini-3.1-flash-image-preview" atau "gemini-3.1-flash-image-preview-official"
Untuk kompatibilitas dengan pemanggilan versi lama, alias nano-banana-2-ext (sesuai dengan gemini-3.1-flash-image-preview), nano-banana-2 (sesuai dengan gemini-3.1-flash-image-preview-official) tetap dapat digunakan secara normal.
boolean
default:"false"
Menentukan apakah moderasi konten dijalankan sebelum tugas gambar dikirim.
  • true: periksa prompt dan gambar input dengan omni-moderation-latest
  • false atau dihilangkan: tidak mengirim permintaan moderasi, tanpa biaya atau latensi moderasi tambahan (default)
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
  • 1:4 / 4:1 - Long poster / banner
  • 1:8 / 8:1 - Extreme long images / banner ads
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:
  • 0.5K - ~512px, pratinjau resolusi rendah
  • 1K - ~1024px, resolusi standar (default)
  • 2K - ~2048px, resolusi tinggi
  • 4K - ~4096px, ultra-resolusi tinggi
Catatan: Resolusi berbeda memiliki harga berbeda. 4K lebih mahal daripada 1K.
integer
Jumlah gambar yang akan dibuatRentang: 1Default: 1⚠️ Catatan: Harus memasukkan angka biasa (misalnya 1), jangan gunakan tanda kutip karena akan menyebabkan error
boolean
default:"false"
Apakah akan menggunakan fallback kanal resmi
  • false: Jangan gunakan (default)
  • true: Gunakan kanal resmi
Saat menggunakan kanal resmi (gemini-3.1-flash-image-preview-official), parameter ini tidak dapat digunakan.
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
Aktifkan Google text search enhancement
  • true: Model akan mencari informasi teks web untuk membantu pembuatan gambar, cocok untuk skenario yang membutuhkan informasi dunia nyata
  • false: Dinonaktifkan (default)
Aktifkan peningkatan pencarian gambar Google
  • true: Selain pencarian teks, sistem juga akan mencari gambar referensi untuk membantu pembuatan, cocok untuk skenario yang membutuhkan referensi visual
  • false: Dinonaktifkan (default)
Catatan: Harus digunakan bersama google_search: true

Respons

integer
Kode status respons
array
Array data respons