Skip to main content
POST
Catatan kompatibilitas nama model: Antarmuka ini juga mendukung alias nano-banana-ext, yang setara dengan gemini-2.5-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-2.5-flash-image-preview"
wajib
Nama model pembuatan gambarModel yang didukung:
  • gemini-2.5-flash-image-preview - Versi standar (alias kompatibel nano-banana-ext)
  • gemini-2.5-flash-image-preview-official - Versi resmi (alias kompatibel nano-banana)
Contoh: "gemini-2.5-flash-image-preview" atau "gemini-2.5-flash-image-preview-official"
Untuk kompatibilitas dengan pemanggilan versi lama, alias nano-banana-ext (sesuai dengan gemini-2.5-flash-image-preview), nano-banana (sesuai dengan gemini-2.5-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 gambarMaksimum 1000 characters
string
Ukuran pembuatan gambarFormat yang didukung:
  • Rasio: 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.
string
default:"1K"
Resolusi gambar outputNilai yang didukung:
  • 1K - Resolusi 1K (default)
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-2.5-flash-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