Langsung ke konten utama
POST
/
v1
/
images
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-3.1-flash-lite-image",
    "prompt": "赛博朋克风格的城市夜景，霓虹灯闪烁",
    "size": "16:9",
    "resolution": "1K",
    "n": 1
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-3.1-flash-lite-image",
    "prompt": "赛博朋克风格的城市夜景，霓虹灯闪烁",
    "size": "16:9",
    "resolution": "1K",
    "n": 1
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

​
Otorisasi

​
Authorization
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:
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
default:"gemini-3.1-flash-lite-image"
wajib
Nama model pembuatan gambarIsi selalu dengan nama model ini: gemini-3.1-flash-lite-image (Nano Banana Lite)
Model ini terhubung langsung ke kanal resmi Gemini, tidak memiliki varian -official, dan tidak mendukung parameter fallback official_fallback.
​
prompt
string
wajib
Deskripsi teks untuk pembuatan gambar
​
size
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.)
​
resolution
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.
​
n
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
​
image_urls
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
​
webhook
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

​
code
integer
Kode status respons
​
data
array
Array data respons