Skip to main content
POST

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-official"
wajib
Nama model pembuatan gambarTetap sebagai gpt-image-2-official (model resmi OpenAI gpt-image-2)
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
string
default:"1:1"
Rasio aspek gambarSecara eksternal menggunakan nilai rasio; secara internal dipetakan ke piksel aktual sesuai resolution.Rasio yang didukung, ditambah auto agar server memilih rasio yang sesuai secara otomatis:
  • auto - Otomatis (server memilih rasio berdasarkan prompt / gambar referensi)
  • 1:1 - Persegi (default, avatar sosial / logo)
  • 3:2 - Lanskap (rasio DSLR umum)
  • 2:3 - Potret (poster vertikal)
  • 4:3 - Lanskap (monitor klasik / slideshow)
  • 3:4 - Potret
  • 5:4 - Lanskap
  • 4:5 - Potret (post vertikal Instagram)
  • 16:9 - Lanskap (thumbnail video layar lebar)
  • 9:16 - Potret (layar penuh ponsel / sampul video pendek)
  • 2:1 - Lanskap (banner web)
  • 1:2 - Potret
  • 3:1 - Lanskap (banner ultra-lebar)
  • 1:3 - Potret (poster ekstra tinggi)
  • 21:9 - Lanskap (ultra-lebar sinematik)
  • 9:21 - Potret
Dimensi piksel juga dapat diteruskan langsung, seperti 1881x836 / 887x1774.
Saat size diatur ke auto, rasio default adalah 1:1.
string
default:"1k"
Tier resolusi (bidang baru)Mengontrol kejernihan output aktual.
  • 1k - Baseline 1024, hemat biaya untuk penggunaan harian (default)
  • 2k - Baseline 2048, cocok untuk poster / kebutuhan definisi tinggi
  • 4k - Baseline 3840, mendukung 15 rasio pada tabel pemetaan di bawah
4K mendukung 15 rasio dalam tabel pemetaan di bawah; Anda juga dapat meneruskan dimensi piksel dari tabel langsung melalui size.
string
default:"auto"
Kualitas gambar
  • auto - Otomatis (default, biasanya setara dengan low)
  • low - Cepat dan ekonomis, cukup untuk garis besar kasar
  • medium - Seimbang
  • high - Presisi maksimum (4K + high can take >120s)
string
default:"auto"
Mode latar belakang
  • auto - Otomatis (default)
  • opaque - Opaque
  • transparent - Meminta latar belakang transparan; output menyertakan kanal alfa
string
default:"auto"
Kekuatan moderasi
  • auto - Kekuatan moderasi default
  • low - Moderasi lebih longgar
string
default:"png"
Format output
  • png - Format default, mendukung latar belakang transparan
  • jpeg - File lebih kecil, tidak mendukung kanal alfa
  • webp - Mendukung latar belakang transparan, cocok untuk browser modern
Jika background bernilai transparent, hanya png atau webp yang dapat dipilih.
integer
Level kompresi output, rentang 0-100
  • Hanya efektif untuk jpeg / webp
integer
default:"1"
Jumlah gambar yang akan dibuatRentang: 1 ~ 4
Harus berupa angka murni (misalnya 1), jangan bungkus dengan tanda kutip
array
Array URL gambar referensi
string
URL gambar mask, digunakan untuk inpainting
  • Harus digunakan bersama image_urls
  1. Pastikan gambar mask memiliki kanal Alpha sebelum mengunggah.
  2. Dimensi gambar mask harus cocok dengan gambar referensi pertama.

Pemetaan Ukuran × Resolusi

size × resolution → piksel aktual OpenAI (15 ratios × 3 tiers):
Catatan: Beberapa dimensi diperkirakan berdasarkan kelipatan 16 dan batas piksel, seperti 3:2 / 2:3 @ 2K sebesar 2048×1360 dan 21:9 @ 4K sebesar 3840×1648. Gunakan piksel aktual dalam tabel sebagai sumber kebenaran.

Contoh Penggunaan

Text-to-image (permintaan minimal)
Text-to-image (stiker transparan)
Image-to-image (menghapus latar belakang)
Poster definisi tinggi 2K
Wallpaper 4K
Image-to-image (fusi multi-referensi)
Inpainting (mask)
Beberapa gambar (n > 1)
String piksel langsung (lanjutan)

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

Field usage menunjukkan penggunaan token yang ditagih untuk permintaan ini: Pada pembuatan gambar, output sebagian besar berupa token gambar, sehingga output_tokens_details.image_tokens biasanya sama dengan output_tokens. Pada contoh di atas, total_tokens = 22 + 196 = 218. Alur status tugas: submittedin_progresscompleted / failed. Akses gambar: data.result.images[0].url[0].