Pembuatan gambar GPT-Image-2

• Model: gpt-image-2
• Endpoint: POST https://apimaster.ai/v1/images/generations
• Mode: Asinkron — mengembalikan task_id, lalu poll tugas
• Fitur: Text-to-image; image-to-image dengan hingga 16 gambar referensi (URL + campuran base64)

Autentikasi

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Parameter Body

Bidang	Tipe	Diperlukan	Catatan
model	string	ya	gpt-image-2
prompt	string	ya	Deskripsi adegan; moderasi keamanan berlaku
n	integer	tidak	Hanya 1 (numerik, tanpa tanda kutip)
size	string	tidak	Rasio aspek, default 1:1
resolution	string	tidak	1k / 2k / 4k, default 1k
image_urls	array	tidak	Gambar referensi → image-to-image
official_fallback	boolean	tidak	Fallback saluran resmi, default false

Nilai size

auto, 1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 2:1, 1:2, 3:1, 1:3, 21:9, 9:21, atau string piksel seperti 3840x2160.

Resolusi (sampel piksel)

size	1k	2k	4k
1:1	1024×1024	2048×2048	2880×2880
16:9	1536×864	2048×1152	3840×2160

Semua 15 rasio mendukung 4K.

image_urls

• Maksimal 16 gambar
• URL publik dan URI data base64 dapat dicampur
• Hilangkan size untuk mengikuti resolusi input; atur size untuk memaksa rasio aspek output

Contoh

Minimal text-to-image

{
  "model": "gpt-image-2",
  "prompt": "An orange cat on a windowsill at sunset, watercolor"
}

16:9 @ 2K

curl -s "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "a corgi astronaut on the moon, cinematic",
    "size": "16:9",
    "resolution": "2k"
  }'

Respons Pengiriman

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

HTTP	Artinya
400	Parameter tidak valid
401	Kunci API salah
402	Saldo tidak mencukupi
429	Batasan laju

Hasil poll tugas {#poll-task-result}

curl -s "https://apimaster.ai/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

URL gambar: data.result.images[0].url[0]

status	Artinya
submitted	Diserahkan
processing	Diproses
completed	Selesai
failed	Lihat kesalahan

Poll setelah 10–20 detik, setiap 3–5 detik. Batch: POST https://apimaster.ai/v1/tasks/batch dengan {"task_ids":[...]}.

Catatan

• Hanya asinkron — tidak ada URL gambar sinkron dalam respons buat.
• Lebih suka size untuk rasio aspek; hindari mengulangi rasio di prompt.
• Penagihan berdasarkan tingkat resolusi; lihat konsol untuk akun Anda.

Bandingkan dengan saluran resmi.