Langsung ke konten utama
POST
Gunakan gpt-image-2.6-ext dengan version berupa flare / sunburst. Biaya per gambar. Mendukung resolution 1k / 2k / 4k dengan n: 1, semua tingkat kualitas, dan PNG / JPEG / WebP / SVG / GIF.
Halaman ini membahas API Ext. Nama model dan aturannya berbeda dari GPT-Image-2.6 berbasis token.

Autentikasi

string
wajib
Gunakan kunci API platform dengan Bearer Token. Dapatkan di halaman kunci API. Kirim dengan Content-Type: application/json.

Pemilihan versi

Parameter permintaan

Nilai enum tidak membedakan huruf besar-kecil; spasi di awal dan akhir dihapus. Contoh memakai huruf kecil.
string
wajib
Nilai tetap: gpt-image-2.6-ext.
string
wajib
Instruksi wajib dan tidak boleh kosong. Untuk beberapa referensi, sebutkan gambar pertama atau kedua serta hal yang perlu diubah dan dipertahankan.
string
default:"flare"
flare / sunburst, bawaan flare. Nilai lain: HTTP 400. Harga antarversi dapat berbeda.
string
default:"1k"
1k / 2k / 4k (huruf besar 1K / 2K / 4K juga diterima). Bersama rasio size menentukan piksel keluaran; lihat tabel “Rasio dan dimensi” di bawah. Harga per gambar berbeda menurut tingkat; nilai seperti hd / 8k mengembalikan HTTP 400.
string
default:"auto"
Hanya auto atau 10 rasio di bawah, bukan piksel seperti 1024x1024. Untuk teks ke gambar, auto menghasilkan 1:1. Untuk edit, dipilih rasio terdekat yang didukung dari referensi pertama yang dimensinya dapat dibaca. Untuk GIF, hilangkan atau gunakan auto.
string
Alias size; cukup gunakan salah satunya. Jika keduanya dikirim harus sama, jika tidak HTTP 400. Untuk GIF, hilangkan atau gunakan auto.
integer
default:"1"
Saat ini gunakan bilangan bulat 1.
string
auto / low / medium / high / xhigh / max. Jika dihilangkan, parameter tidak diteruskan dan penyedia memilih otomatis. auto tidak selalu low. Harga per gambar tetap sama; tingkat tinggi biasanya lebih lama. Nilai lain: HTTP 400.
string
default:"png"
png / jpeg / webp / svg / gif; jpg adalah alias jpeg. SVG dan GIF hanya mendukung teks ke gambar. Format lain: HTTP 400.
Keluaran SVG belum didukung.
string
low / medium / high; penyedia menentukan jika dihilangkan. Mengatur kerumitan adegan: low untuk ikon sederhana dan ilustrasi datar, high untuk detail kaya. Tidak mengubah harga per gambar.
string[]
Maksimal 16 gambar, masing-masing 20 MB. PNG / JPEG / WebP / GIF / BMP. URL HTTP(S) publik atau Data URL gambar seperti data:image/png;base64,.... Referensi mengaktifkan mode edit. SVG dan GIF tidak menerima referensi.
Saat resolution bernilai 2k / 4k, gambar referensi tidak boleh GIF / BMP.
Alias yang diterima: image_url, image, images, input_image, input_images. Disarankan image_urls. URL harus dapat diakses publik tanpa login.

Rasio dan dimensi

Dengan auto, teks ke gambar memakai 1:1: 1024×1024 pada 1k, 2048×2048 pada 2k, 2880×2880 pada 4k. Edit memilih rasio terdekat dalam tabel, bukan menjamin dimensi piksel asli.

Contoh edit dengan referensi

Edit juga menggunakan POST /v1/images/generations. Ganti URL contoh dengan gambar yang dapat diakses.

Keluaran SVG

Tetapkan output_format: "svg". Hanya teks ke gambar dengan n=1. size menerima rasio; complexity: "low" cocok untuk gambar vektor sederhana.
object
Konfigurasi model penulis SVG yang opsional, khusus SVG. Seluruh objek boleh dihilangkan. Model teks pembuat SVG tidak dikenakan biaya tambahan.

GIF animasi

Tetapkan output_format: "gif". Hanya teks ke gambar. Hilangkan size / aspect_ratio atau gunakan auto; rasio dan nilai piksel menghasilkan HTTP 400. Jelaskan gerakan dan pengulangannya.

Parameter tidak didukung dan diabaikan

Pengiriman dan hasil tugas

Pengiriman berhasil mengembalikan HTTP 200. Baca data[0].task_id, lalu periksa API status tugas setiap 3–5 detik hingga completed atau failed. Jika klien kehabisan waktu, lanjutkan memeriksa tugas yang sama, jangan mengirim ulang pembuatan.
Contoh menampilkan objek tugas. Jika respons memakai pembungkus {code, data}, baca data terlebih dahulu. Contoh Python / JavaScript menangani kedua bentuk.
result.images[0].url adalah array; tautan pertama ada di result.images[0].url[0]. Unduh sebelum expires_at; masa berlaku yang disarankan adalah 24 jam setelah selesai. cost / credits_cost menunjukkan biaya akhir. Pemeriksaan batch: POST /v1/tasks/batch dengan {"task_ids":["task_xxx","task_yyy"]}.

Penagihan

Harga per gambar hanya bergantung pada version × resolution. Kualitas, format termasuk SVG / GIF, kompleksitas, rasio, jumlah referensi, dan svg.model tidak mengubah harga. Saat ini gunakan n=1; tugas gagal dikembalikan penuh. Tarif terbaru: halaman harga APIMart atau /api/pricing.

Penanganan kesalahan