Skip to main content
POST

Model yang Didukung

Otorisasi

string
wajib
Semua permintaan API memerlukan autentikasi Bearer TokenDapatkan API Key Anda:Kunjungi halaman manajemen API Key untuk memperoleh API Key AndaTambahkan berikut ini ke header permintaan Anda:

Body

string
wajib
Nama model
  • gpt-image-1-official - Mengutamakan stabilitas, cocok untuk pembuatan gambar umum
  • gpt-image-1.5-official - Versi baru, cocok untuk kualitas lebih tinggi dan pengeditan kompleks
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 Mandarin dan Inggris
string
default:"1:1"
Rasio aspekRasio yang didukung:
  • 1:1 - Persegi (default)
  • 3:2 - Lanskap
  • 2:3 - Potret
integer
default:"1"
Jumlah gambar yang akan dibuatRentang: 1-4
  • Values ≤ 0 will be treated as 1
  • Values > 4 will be treated as 4
Peringatan: Harus berupa angka biasa (misalnya 1), jangan tambahkan tanda kutip, jika tidak akan menyebabkan error
string
default:"auto"
Kualitas gambar
  • auto - Pemilihan kualitas otomatis (default)
  • low - Faster, more economical
  • medium - Keseimbangan antara kualitas dan biaya
  • high - Kualitas lebih tinggi, biaya lebih tinggi
string
default:"auto"
Mode latar belakang
  • auto - Latar belakang otomatis (default)
  • opaque - Opaque background
  • transparent - Latar belakang transparan, direkomendasikan dengan format output png
background: transparent tidak dapat digunakan dengan output_format: jpeg secara bersamaan
string
default:"auto"
Moderation level
  • auto - Level moderasi default
  • low - Moderasi lebih longgar
string
default:"png"
Format output
  • png - Format default, cocok untuk latar belakang transparan
  • jpeg - Ukuran file lebih kecil, cocok untuk output gambar umum
background: transparent tidak dapat digunakan dengan output_format: jpeg secara bersamaan
integer
Level kompresi output, range 0-100
  • Direkomendasikan hanya untuk jpeg
  • Tidak direkomendasikan untuk png
array
Array URL gambar referensi; mengaktifkan mode image-to-image saat disediakanBatas: Hingga 15 gambar referensi
string
URL gambar mask untuk inpainting
  • Harus digunakan bersama image_urls
  • Akan dikirim melalui API pengeditan resmi
  1. Sebelum mengunggah gambar mask, pastikan kanal Alpha gambar bernilai “Yes”.
  2. Ukuran gambar mask harus cocok dengan gambar referensi pertama.

Referensi Ukuran

Rasio aspek digunakan secara eksternal; sistem otomatis memetakannya ke dimensi resmi secara internal.

Contoh Penggunaan

Text-to-Image (minimal)
Text-to-Image (parameter lengkap)
Image-to-Image (referensi tunggal)
Image-to-Image (fusi multi-referensi)
Beberapa gambar (n > 1)

Respons

integer
Kode status respons
array
Array data respons

Catatan

  1. Pemrosesan asinkron: Setelah pengiriman, task_id dikembalikan. Polling /v1/tasks/{task_id} untuk mendapatkan hasil
  2. Pemilihan model: Gunakan gpt-image-1-official untuk pembuatan gambar umum; gunakan gpt-image-1.5-official untuk pengeditan berkualitas tinggi dan tugas image-to-image yang kompleks
  3. Persyaratan URL gambar: Untuk image-to-image, gunakan URL gambar yang dapat diakses publik dan stabil
  4. Penagihan: Ditagih per gambar yang berhasil dibuat; tidak ada biaya untuk kegagalan