Qwen Image 3.0
Pembuatan Gambar Qwen Image 3.0
- Mode pemrosesan asinkron, mengembalikan ID tugas untuk kueri berikutnya
- Mendukung text-to-image dan image-to-image (1-3 gambar referensi untuk pengeditan)
- Mendukung resolusi 1K / 2K, hingga 6 gambar per permintaan
- Varian Standard dan Pro (Pro lebih kuat untuk layout padat dan teks)
POST
Model yang Didukung
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- Standardqwen-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)://ataudata: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
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:416:9/9:163:2/2:3
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-imageagent- hanya text-to-image, penulisan ulang lebih agresif
Tabel Referensi Ukuran
Gabungkanresolution (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
- Asinkron: pengiriman mengembalikan
task_id. Poll Dapatkan Status Tugas setiap 3~5 detik; timeout klien ~3 menit (2K + multi-gambar lebih lambat). - Penyimpanan: Gambar di-mirror ke CDN platform untuk akses jangka panjang.
- Penagihan: Per gambar yang dikirim × tingkat resolusi berdasarkan area piksel aktual (> 2,25M piksel = 2K).
qwen-image-3.0mengenakan biaya sama untuk 1K/2K;-pro2K adalah 2× 1K. Kegagalan diganti penuh; gambar referensi gratis. - Error: Ukuran/rasio tidak valid,
agentpada image-to-image, referensi tidak terjangkau/terlalu besar → 400; batas laju → 429.
Kueri hasilGunakan Dapatkan Status Tugas untuk progres dan
result.images.