Skip to main content
POST

Model yang Didukung

Utamakan -pro untuk teks/layout padat. Gunakan qwen-image-3.0 untuk gambar umum. Prompt maks ~4.5k tokens. Nama model tidak dapat ditukar dengan seri 2.0.

Otorisasi

string
wajib
Semua endpoint memerlukan autentikasi Bearer TokenDapatkan API Key Anda dari Halaman Manajemen API Key:

Body

string
wajib
Nama model
  • qwen-image-3.0 - Standard
  • qwen-image-3.0-pro - Pro (teks / layout padat)
string
wajib
Deskripsi teks untuk pembuatan gambar, maks ~4.5k tokens
string[]
Array URL gambar referensi (image-to-image / pengeditan), 1-3 gambar
  • URL publik http(s):// atau data:image/png;base64,... (base64 diunggah ulang terlebih dahulu)
  • Format: JPG / JPEG / PNG / BMP / TIFF / WEBP / GIF
  • Per file ≤ 10MB; lebar/tinggi disarankan 384-2048 px
string
default:"1K"
Tingkat resolusi (mempengaruhi tingkat penagihan)
  • 1K (default; huruf kecil diterima)
  • 2K
Anda dapat melewati tingkat dan meneruskan piksel di size (mis. 1600x900). Dengan piksel mentah, area > 2,25M piksel ditagih sebagai 2K.
string
default:"1:1"
Rasio aspek, atau ukuran piksel eksplisitRasio yang didukung:
  • 1:1 (default)
  • 4:3 / 3:4
  • 16:9 / 9:16
  • 3:2 / 2:3
Juga menerima gaya 16x9, atau piksel seperti 1024x1024. Untuk piksel kustom, setiap sisi (lebar dan tinggi) harus 512–2048, rasio aspek 1:8 ~ 8:1.Jika size maupun resolution tidak diatur, output tetap di 1024×1024.
integer
default:"1"
Jumlah gambar, 1-6. Nilai di atas 6 dibatasi menjadi 6.
string
Prompt negatif: konten yang harus dihindari
boolean
default:"false"
Penulisan ulang prompt cerdasDefault nonaktif agar hasil dapat diprediksi. Setel true untuk mengaktifkan penulisan ulang cerdas.
string
Mode penulisan ulang (hanya seri 3.0; memerlukan prompt_extend: true)
  • direct - bekerja untuk text-to-image dan image-to-image
  • agent - hanya text-to-image, penulisan ulang lebih agresif
Nilai tidak valid diabaikan.

Tabel Referensi Ukuran

Gabungkan resolution (tingkat) + size (rasio):

Kasus Penggunaan

Text-to-image (beberapa)

Layout padat dengan penulisan ulang

Image-to-image (edit)

Prompt negatif

Batasan

Response

integer
Kode status; 200 saat berhasil
array
Array data respons

Perbedaan dari 2.0

Catatan

  1. Asinkron: pengiriman mengembalikan task_id. Poll Dapatkan Status Tugas setiap 3~5 detik; timeout klien ~3 menit (2K + multi-gambar lebih lambat).
  2. Penyimpanan: Gambar di-mirror ke CDN platform untuk akses jangka panjang.
  3. Penagihan: Per gambar yang dikirim × tingkat resolusi berdasarkan area piksel aktual (> 2,25M piksel = 2K). qwen-image-3.0 mengenakan biaya sama untuk 1K/2K; -pro 2K adalah 2× 1K. Kegagalan diganti penuh; gambar referensi gratis.
  4. Error: Ukuran/rasio tidak valid, agent pada image-to-image, referensi tidak terjangkau/terlalu besar → 400; batas laju → 429.
Kueri hasilGunakan Dapatkan Status Tugas untuk progres dan result.images.