Skip to main content
POST
Catatan kompatibilitas nama model: Antarmuka ini juga mendukung alias gpt-image-2-ext, yang setara dengan gpt-image-2; keduanya dapat digunakan secara bergantian dengan hasil yang sama.

Otorisasi

string
wajib
Semua endpoint memerlukan autentikasi Bearer TokenDapatkan API Key Anda:Kunjungi halaman manajemen API Key untuk mendapatkan API Key AndaSertakan di header permintaan:

Body

string
default:"gpt-image-2"
wajib
Nama model pembuatan gambarTetap sebagai gpt-image-2 (juga kompatibel dengan alias gpt-image-2-ext)
Untuk kompatibilitas dengan pemanggilan versi lama, alias gpt-image-2-ext (sesuai dengan gpt-image-2) tetap dapat digunakan secara normal.
boolean
default:"false"
Menentukan apakah moderasi konten dijalankan sebelum tugas gambar dikirim.
  • true: periksa prompt dan gambar input dengan omni-moderation-latest
  • false atau dihilangkan: tidak mengirim permintaan moderasi, tanpa biaya atau latensi moderasi tambahan (default)
string
wajib
Deskripsi teks untuk pembuatan gambar
  • Mendukung bahasa Inggris dan Mandarin; deskripsi yang terperinci direkomendasikan
  • Moderasi konten / tinjauan keamanan sebelum pengiriman — pelanggaran langsung ditolak
integer
default:"1"
Jumlah gambar yang akan dibuatNilai: 1
Harus berupa angka murni (misalnya 1), jangan bungkus dengan tanda kutip
string
default:"1:1"
Rasio aspek gambarRasio yang didukung, ditambah auto agar server memilih rasio yang sesuai secara otomatis:Dimensi piksel juga dapat diteruskan langsung, seperti 1881x836 / 887x1774.
Saat size diatur ke auto, rasio default adalah 1:1.
string
default:"1k"
Tier resolusi outputOptions: 1k / 2k / 4ksize × resolution → pemetaan piksel aktual:
4K mendukung 15 rasio yang tercantum di atas; Anda juga dapat meneruskan dimensi piksel dari tabel langsung melalui size.
array
Array gambar referensi (bidang standar OpenAI). Beralih ke mode image-to-image saat disediakan.
Bidang standar OpenAI lainnya (response_format, style) tidak didukung dan akan diabaikan. Hasil tugas hanya mengembalikan url — unduh dan konversi sendiri ke base64 jika diperlukan.
boolean
default:"false"
Apakah akan fallback ke kanal resmi
  • false: Jangan gunakan (default)
  • true: Gunakan kanal resmi

Contoh Penggunaan

Text-to-image (permintaan minimal)
Text-to-image (dengan rasio + 2K)
Text-to-image (output 4K)
Text-to-image (multipel)
Image-to-image (referensi = URL)
Image-to-image (referensi = base64)
Image-to-image (fusi multi-referensi, URL + base64 campuran)

Respons

integer
Kode status respons
array
Array data respons

Mengueri Hasil Tugas

Setelah pengiriman berhasil, task_id dikembalikan. Polling status tugas melalui GET /v1/tasks/{task_id}; lihat API Kueri Tugas untuk detail.

Contoh Respons Berhasil

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

Task Status