Gemini 3.1 Flash Image Preview

• Model: gemini-3.1-flash-image-preview (tetap)
• Fitur: Teks ke gambar, gambar ke gambar (hingga 14 referensi), hingga 4K, rasio aspek ekstrem, penelusuran Google grounding opsional

Jangan memanggil model ini melalui /v1/chat/completions — Anda akan mendapat 400 dengan petunjuk untuk menggunakan Images API.

Endpoint

Mode	Endpoint	Kapan digunakan
Sinkron (disarankan)	POST https://apimaster.ai/v1/images/generations	Satu kali perjalanan bolak-balik HTTP; platform melakukan polling upstream dan mengembalikan { "data": [{ "url" }] }
Asinkron	POST https://apimaster.ai/v1/images/generations/async → GET https://apimaster.ai/v1/tasks/{task_id}?model=gemini-3.1-flash-image-preview	Pekerjaan panjang, antrian kustom

Mulai cepat (sinkron)

curl -s "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-preview",
    "prompt": "Cyberpunk city at night, neon lights",
    "size": "16:9",
    "resolution": "2K",
    "n": 1
  }'

Berhasil

{
  "created": 1782633696,
  "data": [{ "url": "https://apimaster.ai/imgs/1782633695067198543.jpg" }]
}

Atur waktu tunggu baca HTTP ≥ 180 detik untuk resolusi 2K/4K. Unduh atau mirror URL segera — URL akan kedaluwarsa.

Alur asinkron

Kirim

curl -s "https://apimaster.ai/v1/images/generations/async" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-preview",
    "prompt": "a corgi astronaut on the moon",
    "size": "1:1",
    "resolution": "1K",
    "n": 1
  }'

Respons kirim

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

Polling

curl -s "https://apimaster.ai/v1/tasks/TASK_ID?model=gemini-3.1-flash-image-preview" \
  -H "Authorization: Bearer YOUR_API_KEY"

Jika berhasil, baca data.result.images[0].url. Status polling umum: in_progress → succeeded / completed.

Tunggu 10–20 detik sebelum polling pertama, lalu setiap 3–5 detik.

Otentikasi

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Parameter body

Field	Tipe	Wajib	Catatan
model	string	ya	gemini-3.1-flash-image-preview
prompt	string	ya	Deskripsi adegan
size	string	tidak	Rasio aspek; lihat di bawah
resolution	string	tidak	0.5K / 1K / 2K / 4K, default 1K; tidak peka huruf besar/kecil
n	integer	tidak	Hanya 1 yang didukung (numerik, bukan string)
image_urls	array	tidak	Gambar referensi (URL atau data URI)
google_search	boolean	tidak	Pencarian teks Google grounding
google_image_search	boolean	tidak	Memerlukan google_search: true

Tingkat resolusi & penagihan

Nilai	~piksel	Harga vs basis 1K
0.5K	~512	sama dengan 1K
1K	~1024	basis
2K	~2048	× 4/3
4K	~4096	× 2

Biaya aktual = harga saluran × pengali resolusi × rasio grup. Lihat marketplace atau log konsol.

Kesalahan

HTTP	Arti
400	Parameter buruk, atau endpoint salah (chat)
401	Kunci API tidak valid
402	Saldo tidak mencukupi
408	Waktu tunggu habis — pulihkan pengiriman asli; jangan kirim ulang otomatis
500 / 502	Kesalahan upstream atau platform

Rasio aspek yang tidak valid dapat muncul sebagai 500 ketika hanya satu saluran yang dikonfigurasi.

Catatan

• Log penggunaan menyertakan result_url untuk pratinjau gambar dan request_data.effective_resolution.
• Harga bervariasi menurut saluran dan resolusi — lihat marketplace.

Images: Idempotency-Key and original-submission recovery (English).