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 polling sinkron habis — coba ulang secara asinkron atau turunkan resolusi
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.