API Gambar — Pilih Model dan Endpoint
Bandingkan endpoint gambar GPT Image 2 / 2.5, Gemini Flash Image, dan Seedream. Gunakan edit multipart untuk gambar referensi GPT dan ikuti format input masing-masing model.
Ikhtisar API gambar
APIMaster menyediakan API gambar di bawah https://apimaster.ai/v1. Gambar-ke-gambar tidak menggunakan satu format input universal di semua model. Pilih model terlebih dahulu, lalu gunakan endpoint dan kolom referensi yang didokumentasikan.
Panduan model dan endpoint
| Model | Teks-ke-gambar | Gambar-ke-gambar | Panduan |
|---|---|---|---|
gpt-image-2 |
JSON /images/generations |
Multipart /images/edits, file image / image[] |
GPT Image 2 / 2.5 |
gpt-image-2.5-sunburst |
JSON /images/generations |
Multipart /images/edits, file image / image[] |
GPT Image 2 / 2.5 |
gpt-image-2.5-flare |
JSON /images/generations |
Multipart /images/edits, file image / image[] |
GPT Image 2 / 2.5 |
gemini-3.1-flash-image-preview |
JSON /images/generations |
JSON /images/generations dengan image_urls |
Gemini Flash Image |
gemini-nano-banana-2.1 |
JSON /images/generations |
multipart /images/edits / JSON image_urls |
Nano Banana 2.1 |
grok-imagine-image-2.0 |
JSON /images/generations |
JSON /images/generations dengan image_urls (maksimal 5) |
Grok Imagine Image 2.0 |
doubao-seedream-5-0-pro-260628 |
JSON /images/generations |
JSON /images/generations dengan image |
Seedream 5.0 Pro |
midjourney-v8.2 |
Asinkron /midjourney/generations |
Referensi JSON image_urls |
Midjourney v8.2 / Niji 7 |
midjourney-niji-7 |
Asinkron /midjourney/generations |
Referensi JSON image_urls |
Midjourney v8.2 / Niji 7 |
Untuk Grok Imagine Image 2.0, gunakan /images/generations sinkron dengan image_urls. Jalur asinkron klien dan /images/edits tidak didukung; lihat panduan Grok Imagine Image 2.0.
Untuk gambar referensi GPT, unggah file yang sebenarnya ke /images/edits untuk respons gambar atau /images/edits/async untuk respons tugas; jangan menyalin format JSON Gemini atau Seedream. Menyebutkan referensi dalam prompt bukanlah unggahan. GPT Image 2.5 adalah keluarga model terpisah, bukan alias GPT Image 2.
Midjourney v8.2 dan Niji 7 membuat tugas asinkron melalui /midjourney/generations; lakukan polling GET /tasks/{task_id}. Lihat panduan Midjourney v8.2 / Niji 7 untuk parameter dan contoh.
Autentikasi dan respons
- Buat kunci di konsol; kirim
Authorization: Bearer YOUR_API_KEY. - Panggilan generasi JSON menggunakan
Content-Type: application/json. Untuk edit multipart, biarkan klien HTTP menghasilkan Content-Type dan boundary. - Respons gambar sinkron berisi
data[]denganurlataub64_json; tangani kedua format. Unduh URL sementara segera. - Kolom opsional, batas referensi, ukuran, dan harga bergantung pada model dan rute yang tersedia. Periksa panduan model dan marketplace.
Pekerjaan asinkron
POST /images/generations/async, POST /images/edits/async dan GET /tasks/{task_id}?model=MODEL_ID menyediakan alur kerja gambar berbasis tugas untuk model yang didukung. Ini bukan mode universal untuk setiap operasi gambar:
- Untuk GPT Image 2, Sunburst dan Flare, gunakan JSON
generations/asyncuntuk teks-ke-gambar dan multipartedits/asyncuntuk pengeditan. Unggah file yang sama seperti edit sinkron, lalu lakukan polling dengan akun pengirim dan ID model yang sama. - Pembuatan atau pengeditan dapat selesai sebelum pengiriman asinkron mengembalikan ID tugas; jangan menganggap pengiriman itu instan. Jangan kirim ulang tugas yang ada saat melakukan polling. Penyelesaian dapat berupa
succeeded,success, ataucompleted; hasil yang dilacak menggunakan stringurl, sedangkan hasil lama dapat berisi array URL. - Gemini memiliki alur generasi asinkron sendiri; ikuti panduannya untuk input referensi.
- Seedream 5.0 Pro menggunakan generasi sinkron dan tidak mendukung
/images/generations/async.
Lihat panduan model untuk contoh cURL/Python lengkap, status polling, dan pemecahan masalah. Respons HTTP 200 saja tidak memverifikasi fidelitas gambar referensi.
