Qwen-Image adalah model generasi gambar serbaguna yang mendukung berbagai gaya artistik dan unggul dalam complex text rendering . Model ini menangani tata letak multi-baris, generasi teks tingkat paragraf, dan rendering detail halus.
Akses cepat: Panduan pengguna| Coba online(Singapura | Beijing)| Blog teknis (lebih banyak contoh) |
Contoh
Prompt | Gambar yang dihasilkan |
|---|---|
A healing-style hand-drawn poster featuring three puppies playing with a ball on lush green grass, adorned with decorative elements such as birds and stars. The main title “Come Play Ball!” appears prominently at the top in bold, blue cartoon font. Below it, the subtitle “Come [Show Off Your Skills]!” appears in green font. A speech bubble adds playful charm with the text: “Hehe, watch me amaze my little friends next!” At the bottom, supplementary text reads: “We get to play ball with our friends again!” The color palette centers on fresh greens and blues, accented with bright pink and yellow tones to highlight a cheerful, childlike atmosphere. | ![]() |
Ikhtisar model
| Model | Deskripsi | Spesifikasi gambar output |
|---|---|---|
qwen-image-2.0-pro RecommendedKemampuan sama dengan qwen-image-2.0-pro-2026-04-22 | Seri Pro Qwen untuk generasi dan pengeditan gambar. Menawarkan rendering teks lebih kuat, tekstur realistis, dan kepatuhan semantik.Untuk pengeditan gambar, lihat Qwen-Image Editing. | Resolusi: Atur lebar dan tinggi secara bebas. Total piksel harus antara 512×512 dan 2048×2048. Resolusi default adalah 2048×2048.Format: PNGJumlah gambar: 1–6 |
qwen-image-2.0-pro-2026-06-22 Recommended | ||
| qwen-image-2.0-pro-2026-04-22 | ||
| qwen-image-2.0-pro-2026-03-03 | ||
qwen-image-2.0 RecommendedKemampuan sama dengan qwen-image-2.0-2026-03-03 | Seri akselerasi Qwen untuk generasi dan pengeditan gambar. Menyeimbangkan kualitas dan kecepatan respons.Untuk pengeditan gambar, lihat Qwen-Image Editing. | |
qwen-image-2.0-2026-03-03 Recommended |
Prasyarat
Sebelum melakukan panggilan, dapatkan Kunci API dan ekspor Kunci API sebagai variabel lingkungan. Untuk melakukan panggilan menggunakan SDK, instal SDK DashScope.
API Sinkron
HTTP
Panggilan sinkron mengembalikan hasil dalam satu permintaan.
Singapura:POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
Beijing:POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda.
Parameter permintaan |
|
Header permintaan | |
Content-Type string (Wajib)Tipe konten permintaan. Harus application/json. | |
Authorization string (Wajib)Mengotentikasi permintaan dengan Kunci API Model Studio. Contoh: Bearer sk-xxxx. | |
Body permintaan | |
model string (wajib)Nama model. Contoh: qwen-image-2.0-pro. | |
input object (wajib)Informasi input.
Properti messages array (wajib)Array objek pesan. Hanya percakapan satu giliran yang didukung, sehingga array harus berisi tepat satu elemen.
Properti role string (wajib)Peran pesan. Diatur ke user.contentarray (wajib)Array objek konten pesan.
Properti text string(wajib)Petunjuk positif yang menjelaskan konten, gaya, dan komposisi gambar yang Anda inginkan.Mendukung bahasa Tionghoa dan Inggris. Seri qwen-image-2.0 menerima hingga 1.300 token. Model lain menerima hingga 800 token. Sistem memotong token berlebih.Catatan: Hanya satu bidang teks yang diizinkan. Menghilangkannya atau memberikan lebih dari satu mengembalikan kesalahan. | |
parameters object (opsional)Parameter pemrosesan gambar.
Properti negative_prompt string (opsional)Prompt negatif yang menjelaskan apa yang tidak Anda inginkan dalam gambar.Mendukung bahasa Tionghoa dan Inggris. Panjang maksimum 500 karakter. Karakter berlebih dipotong secara otomatis.Contoh: resolusi rendah, kualitas buruk, anggota tubuh terdistorsi, jari-jari cacat, warna terlalu jenuh, tampilan seperti lilin, wajah tanpa detail, permukaan terlalu halus, kesan buatan AI, komposisi kacau, serta teks buram atau terdistorsi.size string (opsional)Resolusi gambar output, diformat sebagai width*height.Model seri qwen-image-2.0: Total piksel harus antara 512×512 dan 2048×2048. Resolusi default adalah 2048×2048. Resolusi yang direkomendasikan:
integer (opsional)Jumlah gambar output. Default adalah 1.Untuk model seri qwen-image-2.0, Anda dapat memilih 1–6 gambar.prompt_extend bool (opsional)Aktifkan penulisan ulang prompt cerdas. Model mengoptimalkan petunjuk positif. Tidak memengaruhi prompt negatif.
Lihat contoh penulisan ulang Prompt asli (orig_prompt): A sitting ginger cat with a joyful expression, looking lively, adorable, and incredibly lifelike.Prompt aktual (actual_prompt): Potret satwa liar fotorealistis: seekor kucing jahe duduk dengan bulu lebat yang berkilau terkena sinar matahari dan ekspresi ceria penuh semangat; matanya berbinar menunjukkan rasa ingin tahu dan kehangatan. Kepalanya sedikit miring, telinga terangkat ke depan, dan mulutnya sedikit terbuka dalam pose puas yang hidup—memancarkan pesona menggemaskan serta detail luar biasa yang tampak nyata. Pencahayaan alami yang lembut menonjolkan tekstur setiap helai kumis dan bulu, dengan sorotan halus pada moncong dan bagian dalam telinga. Latar belakang: taman musim gugur dengan efek buram lembut pada golden hour—nuansa hangat daun ambar, cahaya matahari yang menembus sela-sela pepohonan, dan sedikit petunjuk anak tangga batu berlumut. Komposisi menempatkan kucing sebagai fokus utama, ditangkap dalam fokus tajam dengan kedalaman bidang yang dangkal. Gaya: fotografi ultra-realistis, detail setara National Geographic, resolusi 8K, Canon EOS R5, bukaan f/1.2, pencahayaan sinematik, gradasi warna akurat, dan post-processing minimal. Tanpa teks atau hamparan. bool (opsional)Menambahkan watermark “Qwen-Image” di pojok kanan bawah gambar. Default: false. Gaya watermark: integer (opsional)Bibit angka acak. Rentang valid: [0,2147483647].Menggunakan seed yang sama menghasilkan output serupa. Jika dihilangkan, algoritma menggunakan seed acak.Catatan: Generasi gambar bersifat probabilistik. Bahkan dengan seed yang sama, hasilnya mungkin berbeda. |
Parameter respons |
URL gambar hanya berlaku selama 24 jam lalu secara otomatis dihapus. Simpan gambar yang dihasilkan segera. |
output objectInformasi output tugas.
Properti choices arrayOutput model. Array ini berisi tepat satu elemen.
Properti finish_reason stringAlasan tugas dihentikan. Nilainya stop untuk penghentian alami.message objectPesan respons model.
Properti role stringPeran pesan. Nilai tetap: assistant.contentarray
Properti image stringURL gambar yang dihasilkan (format PNG). Kedaluwarsa setelah 24 jam. Unduh dan simpan segera.objectStatistik hasil tugas. Tidak dikembalikan untuk model seri qwen-image-2.0.
Properti TOTAL integerTotal jumlah tugas.SUCCEEDED integerJumlah tugas yang berhasil.FAILED integerJumlah tugas yang gagal. | |
usage objectPanggilan SDK ImageSynthesis sinkron tidak mengembalikan bidang ini.
Properti image_count integerJumlah gambar yang dihasilkan. Untuk model seri qwen-image-2.0 ini sama dengan n yang diminta (1–6).width integerLebar gambar yang dihasilkan, dalam piksel.height integerTinggi gambar yang dihasilkan, dalam piksel. | |
request_id stringIdentifier permintaan unik untuk pelacakan dan troubleshooting. | |
code stringKode kesalahan. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode kesalahan. | |
message stringPesan kesalahan detail. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode kesalahan. |
Panggilan SDK DashScope
SDK DashScope mendukung Python dan Java.
Nama parameter dalam SDK sangat mirip dengan parameter HTTP, dan struktur parameter mengikuti konvensi khas bahasa pemrograman. Untuk parameter panggilan sinkron, lihat HTTP.
- Python
- Java
Contoh permintaan
Contoh respons
URL gambar kedaluwarsa setelah 24 jam. Unduh gambar segera.
Penggunaan dengan OpenAI Agents SDK
Model pembuatan gambar seperti Qwen-Image dipanggil melalui API native DashScope dan tidak mendukung mode kompatibel OpenAI (compatible-mode), sehingga tidak dapat digunakan secara langsung sebagai model penalaran suatu Agent dalam OpenAI Agents SDK.
Dalam kerangka kerja agent seperti OpenAI Agents SDK, Anda dapat membungkus pembuatan gambar sebagai tool (function tool) dan membiarkan model chat teks yang mendukung mode kompatibel OpenAI (misalnya qwen-plus) bertindak sebagai inti penalaran Agent untuk mengoordinasikannya. Contohnya:
Sebelum menjalankan, instal dependensi: pip install openai-agents dashscope.
Billing and rate limiting
- Untuk kuota gratis dan informasi harga, lihat Model pricing.
- Untuk batas laju (rate limits), lihat Qwen-Image.
- Detail Tagihan: Setiap successfully generated image akan dikenai biaya. Panggilan yang gagal atau error pemrosesan tidak dikenai biaya maupun mengurangi new user free quota Anda.
Kode error
Jika pemanggilan model gagal dan mengembalikan pesan error, lihat Kode error untuk resolusi.
FAQ
T: Haruskah saya mengaktifkan atau menonaktifkan parameter prompt_extend?
J: Aktifkan opsi ini (default) jika Anda menginginkan konten gambar yang lebih beragam dan agar model menambahkan detail. Nonaktifkan jika Anda memerlukan kontrol yang lebih ketat terhadap detail gambar, dan optimalkan prompt Anda menggunakan Text-to-Image Prompt Guide.
T: Apa perbedaan antara model seri qwen-image-2.0?
J:
-
Model gabungan untuk pembuatan dan pengeditan gambar: Mendukung teks-ke-gambar dan Pengeditan gambar.
qwen-image-2.0-prodanqwen-image-2.0-pro-2026-03-03: Kemampuan sama. Seri Pro memberikan rendering teks yang lebih profesional, tekstur realistis yang lebih halus, adegan realistis yang lebih detail, serta kepatuhan semantik yang lebih kuat. Hanya mendukung panggilan sinkron.qwen-image-2.0danqwen-image-2.0-2026-03-03: Kemampuan sama. Versi akselerasi ini menyeimbangkan kinerja dan kualitas model. Hanya mendukung panggilan sinkron.
