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

Otorisasi

string
wajib
Semua API memerlukan autentikasi menggunakan Bearer TokenDapatkan API Key:Kunjungi Halaman Manajemen API Key untuk memperoleh API Key AndaTambahkan ke header permintaan:

Body

string
default:"gemini-3-pro-image-preview"
wajib
Nama model pembuatan gambarModel yang didukung:
  • gemini-3-pro-image-preview - Versi standar (alias kompatibel nano-banana-pro-ext)
  • gemini-3-pro-image-preview-official - Versi resmi (alias kompatibel nano-banana-pro)
Contoh: "gemini-3-pro-image-preview" atau "gemini-3-pro-image-preview-official"
Untuk kompatibilitas dengan pemanggilan versi lama, alias nano-banana-pro-ext (sesuai dengan gemini-3-pro-image-preview), nano-banana-pro (sesuai dengan gemini-3-pro-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
Ukuran pembuatan gambarFormat yang didukung:
  • Rasios: auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
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.
integer
Jumlah gambar yang akan dibuatRentang: 1Default: 1⚠️ Catatan: Harus berupa angka murni (misalnya 1), jangan tambahkan tanda kutip, jika tidak akan terjadi error
string
Resolusi gambar outputNilai yang didukung:
  • 1K - Resolusi 1K (default)
  • 2K - Resolusi 2K
  • 4K - Resolusi 4K
⚠️ Catatan: Pembuatan gambar 4K dengan format base64 membutuhkan waktu pemrosesan lebih lama
boolean
default:"false"
Apakah akan menggunakan fallback kanal resmi
  • false: Jangan gunakan (default)
  • true: Gunakan kanal resmi
Saat menggunakan kanal resmi (gemini-3-pro-image-preview-official), parameter ini tidak dapat digunakan.
array
Daftar URL gambar referensi untuk image-to-image atau pengeditan gambar💡 Isi Cepat (area Try it):
  1. Klik ”+ Add an item” untuk menambahkan URL gambar
  2. Masukkan alamat URL gambar lengkap atau data base64
Batas: Maksimum 14 images

Respons

integer
Kode status respons
array
Array data respons