TL;DR
Qwen Image 3.0 menyatukan pembuatan gambar dari teks dan pengeditan berpanduan referensi dalam varian Standard (qwen-image-3.0) dan Pro (qwen-image-3.0-pro). Mulailah dengan prompt teks, pilih ukuran keluaran, kirim permintaan pembuatan gambar, dan segera simpan hasilnya. Untuk pengeditan, sertakan satu hingga tiga gambar referensi dan instruksi pelestarian yang eksplisit. Di CometAPI, verifikasi rute aktual dan skema permintaan yang kompatibel sebelum menerapkan panggilan contoh.
Key Takeaways
- Qwen Image 3.0 API mendukung pembuatan gambar dari teks dan pengeditan berpanduan referensi melalui Standard (qwen-image-3.0) dan Pro (qwen-image-3.0-pro); keluaran native adalah PNG.
- Akses Qwen Image 3.0 API tersedia melalui CometAPI. Developer dapat memperoleh kunci API, memverifikasi endpoint yang didukung, dan mengintegrasikan pembuatan gambar ke dalam aplikasi.
- Harga Qwen Image 3.0 API mulai $0.024/per permintaan di CometAPI, dibandingkan tarif Alibaba Cloud Singapore yang mulai $0.030 per gambar keluaran Standard dan $0.040 per gambar keluaran Pro 1K.
- Pengeditan gambar Qwen Image 3.0 mendukung hingga tiga gambar referensi melalui API native Alibaba Cloud, sementara pembuatan mendukung satu hingga enam keluaran per permintaan.
- Integrasi Qwen Image 3.0 API memerlukan verifikasi parameter khusus penyedia, autentikasi, satuan penagihan, dan URL gambar sementara sebelum menerapkan alur kerja produksi.
What Is the Qwen Image 3.0 API?
Qwen Image 3.0 API mengubah instruksi teks menjadi gambar dan dapat mentransformasi foto atau aset desain yang disediakan. Skenario yang didukung mencakup poster multibahasa, fotografi e-commerce, mockup kampanye, penggantian latar belakang, dan pengeditan gambar komposit.
Qwen Image 3.0 Standard (qwen-image-3.0) adalah basis berbiaya efisien untuk pembuatan gambar dari teks dan pengeditan berpanduan referensi. Pertimbangkan terlebih dahulu untuk alur kerja volume tinggi seperti variasi latar e-commerce, draf visual media sosial, dan eksplorasi konsep kampanye. Misalnya, gunakan Standard untuk menghasilkan beberapa opsi latar produk, lalu tinjau kesetiaan produk dan pilih versi yang layak untuk disempurnakan.
Qwen Image 3.0 Pro (qwen-image-3.0-pro) mendukung pembuatan dan pengeditan berpanduan referensi, dengan tingkatan keluaran native 2K yang berharga lebih tinggi. Evaluasi untuk deliverable yang sensitif terhadap kualitas seperti gambar hero kampanye, komposisi produk detail, dan poster promosi. Misalnya, uji konsep yang masuk daftar pendek dengan Pro ketika detail halus atau tata letak penting, lalu bandingkan hasil yang diterima dengan Standard sebelum mengalokasikan anggaran yang lebih besar.
Cara memilih: Mulailah dengan Standard untuk draf dan variasi yang sensitif biaya. Uji Pro pada brief yang sama untuk aset final yang menuntut; pilih bila peningkatan yang terukur membenarkan biaya tambahan. Penetapan tersebut tidak menggantikan pengujian spesifik aplikasi atas tipografi, kesetiaan produk, jumlah objek, atau akurasi tata letak.
| Specification | Qwen Image 3.0 | Qwen Image 3.0 Pro |
|---|---|---|
| Model ID | qwen-image-3.0 | qwen-image-3.0-pro |
| Generation / editing | Keduanya | Keduanya |
| Reference images for editing | 1–3 | 1–3 |
| Generated images per request | 1–6 | 1–6 |
| Output format | PNG | PNG |
| Output pixel area | 512²–2048² | 512²–2048² |
| Recommended prompt length | 4,500 tokens | 4,500 tokens |
| Primary selection rationale | Throughput hemat biaya | Evaluasi keluaran premium |
What Parameters Does Qwen Image 3.0 API Support?
Gunakan parameter berikut dengan antarmuka native Alibaba Cloud yang kompatibel dengan OpenAI. Tambahkan opsi khusus penyedia ke permintaan CometAPI hanya jika rute yang dipilih mendokumentasikannya.
Berlaku untuk kedua varian: qwen-image-3.0 (Standard) dan qwen-image-3.0-pro (Pro) mendukung parameter yang sama di bawah ini pada antarmuka native Alibaba Cloud yang kompatibel dengan OpenAI. Pilih varian dengan model; kontrol pembuatan dan pengeditan dibagi. Ini tidak menyiratkan kualitas keluaran atau harga yang identik, atau menjamin bahwa setiap rute CometAPI mengekspos semua parameter native.
| Parameter | Type / example | Purpose |
|---|---|---|
| model | qwen-image-3.0 | Pilih Standard atau Pro |
| prompt | string | Instruksi dan konten |
| image | URL / base64 string or array | 1–3 referensi untuk pengeditan; kosongkan untuk pembuatan |
| size | 1024x1024 | Dimensi keluaran; otomatis jika didukung |
| n | integer 1–6 | Jumlah keluaran per panggilan |
| negative_prompt | string | Jelaskan yang harus dihindari |
| prompt_extend | boolean | Aktifkan penulisan ulang prompt |
| prompt_extend_mode | direct / agent | Mode agent hanya untuk T2I |
| enable_thinking | boolean | Kontrol penalaran, tunduk pada pengaturan peningkatan |
| watermark | boolean | Tanda air opsional |
| seed | integer | Bantuan reprodusibilitas |
Untuk permintaan native, rasio aspek keluaran harus tetap antara 1:8 dan 8:1. Gambar referensi maksimal 10 MB, dengan setiap sisi antara 1 dan 8.000 piksel dan rasio sisi terpanjang ke terpendek tidak lebih dari 10:1. Gunakan data URI untuk input Base64. Thinking membutuhkan prompt_extend=true; peningkatan agent mendukung text-to-image saja.
Permintaan gambar yang kompatibel menempatkan field pembuatan di level atas JSON dan memformat dimensi sebagai 1024x1024. DashScope native menggunakan input/parameters bertingkat dan umum menulis dimensi sebagai 1024*1024. Permintaan yang disalin di antara endpoint ini tanpa konversi dapat gagal.
How Do You Call Qwen Image 3.0 API with CometAPI?
Panduan ini mengasumsikan Python 3, terminal yang kompatibel Bash, akun CometAPI dengan akses model, dan saldo yang cukup. Permintaan pertama hanya menggunakan field model dan prompt yang ditampilkan di contoh penyedia. Dokumentasi diperiksa pada 16 Oktober 2026; contoh ini belum dijalankan pada akun berbayar.
Create credentials
Buat kunci API sisi server di dasbor CometAPI Anda. Jangan pernah menanamkannya pada klien web atau seluler.
export COMETAPI_KEY="kunci_api_anda"python -m pip install requests
Submit a minimal generation request
Developer dapat mengakses Qwen Image 3.0 API di CometAPI menggunakan rute pembuatan gambar yang didokumentasikan. Mulailah dengan permintaan minimal di bawah ini sebelum menambahkan parameter opsional.
curl --fail-with-body https://api.cometapi.com/v1/images/generations \ -H "Authorization: Bearer $COMETAPI_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"qwen-image-3.0","prompt":"Botol skincare premium di atas pedestal batu, pencahayaan studio lembut"}'
Save every returned image
Simpan skrip berikut sebagai generate.py dan jalankan python generate.py. Skrip ini mengirim permintaan, menangani hasil gambar berupa URL atau Base64, dan menulis setiap gambar secara lokal. Jika respons berisi informasi tugas alih-alih array data, skrip berhenti alih-alih menebak endpoint polling; gunakan kontrak asinkron spesifik akun untuk mengambil hasil yang selesai.
import base64import osfrom pathlib import Pathimport requestsresponse = requests.post( "https://api.cometapi.com/v1/images/generations", headers={"Authorization": f"Bearer {os.environ['COMETAPI_KEY']}"}, json={"model": "qwen-image-3.0", "prompt": "Kafe toko buku yang cerah, fotografi editorial"}, timeout=(15, 600),)response.raise_for_status()result = response.json()images = result.get("data")if not isinstance(images, list) or not images: raise RuntimeError(f"Tidak ada gambar sinkron; periksa bidang task/error: {list(result)}")for index, item in enumerate(images, 1): if item.get("url"): download = requests.get(item["url"], timeout=(15, 120)) download.raise_for_status() content = download.content elif item.get("b64_json"): content = base64.b64decode(item["b64_json"], validate=True) else: raise RuntimeError(f"Gambar {index} tidak memiliki URL atau payload Base64") path = Path(f"qwen_image_{index}.png") path.write_bytes(content) print(f"Disimpan {path}")
Eksekusi yang berhasil akan menghasilkan file gambar lokal. Buka untuk memastikan dapat dibaca dan sesuai dengan skena yang diminta. Simpan pengenal permintaan dan field penggunaan di log server Anda tanpa mencatat kredensial.
How Do You Generate Multiple Images with Qwen Image 3.0?
Pada antarmuka native Alibaba Cloud, setel n menjadi dua hingga enam untuk variasi kreatif. Untuk CometAPI, aktifkan n hanya setelah mengonfirmasi dukungan pada rute yang dipilih. Validasi setiap aset yang dikembalikan secara terpisah; n yang lebih besar tidak menjamin setiap hasil lolos peninjauan hilir.
Anda dapat membuat hingga 6 gambar dalam satu permintaan dengan Qwen Image 3.0 dengan menyetel parameter n. Ini berfungsi dengan qwen-image-3.0 dan qwen-image-3.0-pro, baik untuk pembuatan dari teks maupun pengeditan gambar. Defaultnya hanya satu gambar.
Ada dua cara utama: gunakan antarmuka grafis jika platform Anda menampilkannya, atau panggil API secara langsung.
Generate multiple images using the API
- Buka dokumentasi API.
- Dapatkan kunci API dari konsol QwenCloud/ CometAPI.
- Pilih
qwen-image-3.0atauqwen-image-3.0-pro. - Setel
nke jumlah gambar yang diinginkan, dari1hingga6. - Kirim prompt Anda dan simpan gambar yang dikembalikan.
Sebagai contoh, setel "n": 4 untuk meminta empat variasi dari prompt yang sama.
Python example
Berikut contoh siap-adaptasi menggunakan API yang kompatibel dengan OpenAI.
from openai import OpenAIimport requestsclient = OpenAI( api_key="KUNCI_API_QWEN_ANDA", base_url="https://maas.qwencloudapi.com/compatible-mode/v1")
result = client.images.generate( model="qwen-image-3.0-pro",
prompt=( "Sebuah kafe Jepang yang nyaman di malam hari saat hujan, " "cahaya hangat berpendar, fotografi sinematik, " "detail kaya, refleksi realistis" ),
n=4,
size="1024x1024")# Simpan setiap gambar yang dihasilkan
for i, item in enumerate(result.data, start=1): response = requests.get(item.url) response.raise_for_status() with open(f"qwen_image_{i}.png", "wb")
as f:
f.write(response.content)print("Selesai membuat gambar!")
Instal paket yang diperlukan terlebih dahulu:
pip install openai requests
API mengembalikan URL gambar untuk setiap hasil. URL gambar yang dihasilkan bersifat sementara, jadi unduh gambar segera.
Important settings
| Parameter | What it does |
|---|---|
| n=4 | Menghasilkan empat gambar keluaran |
| model="qwen-image-3.0-pro" | Memilih model Pro |
| size="1024x1024" | Meminta gambar persegi |
| seed=12345 | Membantu membuat hasil lebih dapat direproduksi |
| negative_prompt | Mengecualikan elemen visual yang tidak diinginkan |
Jumlah maksimum keluaran adalah enam per permintaan. Perlu diingat bahwa meminta lebih banyak gambar akan meningkatkan biaya pembuatan.
Satu perbedaan penting: n=4 meminta empat variasi dari satu prompt. Jika Anda menginginkan empat prompt berbeda, Anda harus membuat permintaan terpisah atau mengotomatisasi loop atas prompt Anda.
How Do You Edit Images with Qwen Image 3.0?
Sebuah pengeditan menggabungkan satu hingga tiga gambar referensi dengan instruksi. Jelaskan baik transformasi yang diinginkan maupun apa yang tidak boleh berubah—misalnya label produk, warna, sudut kamera, atau geometri kemasan.
Contoh berikut menggunakan kredensial Alibaba Cloud dan field JSON image untuk pengeditan. Buat kunci Model Studio regional, dapatkan ID workspace Anda, dan konfigurasikan endpoint yang sesuai. Jangan mengganti kunci CometAPI ke dalam permintaan ini.
export DASHSCOPE_API_KEY="kunci_model_studio_anda"export ALIBABA_WORKSPACE_ID="id_workspace_anda"export ALIBABA_IMAGE_ENDPOINT="https://${ALIBABA_WORKSPACE_ID}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/images/generations"
Gambar referensi di bawah berasal langsung dari contoh API resmi. Ini adalah gambar input, bukan hasil yang dihasilkan dari artikel ini.
import os, requests
endpoint = os.environ["ALIBABA_IMAGE_ENDPOINT"]
# endpoint regional terdokumentasi .../images/generations
payload = {
"model": "qwen-image-3.0",
"prompt": "Ubah pakaian menjadi setelan bisnis warna arang di sebuah kafe. Pertahankan wajah dan gaya rambut.",
"image": ["https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/yBRq1ZPYEaXdyOdv/img/33a80a19-7ac7-4c64-b0fa-7d685b7046a0.png"],
"size": "1024x1024",
"n": 1}
r = requests.post(endpoint, headers={
"Authorization": f"Bearer {os.environ['DASHSCOPE_API_KEY']}"}, json=payload, timeout=(15, 600))
r.raise_for_status()
print(r.json())
Endpoint kompatibel native menggunakan JSON pada /images/generations, bukan unggahan multipart pada /images/edits. Tidak mendukung mask atau streaming. Baca array data yang dikembalikan dan simpan setiap URL menggunakan loop unduhan yang sama seperti di atas.
Untuk dua referensi, sertakan dua URL dalam array image dan tentukan perannya di prompt (contoh, produk dari gambar satu, setting ruangan dari gambar dua). Seri Qwen Image 3.0 menerima tidak lebih dari tiga gambar referensi; gunakan model lain atau alur kerja prapemrosesan untuk set sumber yang lebih besar.
How Much Does Qwen Image 3.0 API Cost?
Harga Qwen Image 3.0 API bervariasi berdasarkan varian model, resolusi keluaran, dan penyedia. Tabel di bawah melengkapi perbandingan Alibaba Cloud Singapore asli dengan tarif CometAPI yang ditampilkan dalam tabel harga terlampir oleh peninjau. Lampiran mencantumkan harga keluaran dalam USD per gambar dan diskon 20% untuk keempat kombinasi model/resolusi. Tarif yang diberikan ini belum divalidasi ulang secara independen terhadap penagihan akun langsung; konfirmasikan kartu tarif yang berlaku sebelum penggunaan produksi.
| Pricing item | Alibaba Cloud Standard | Alibaba Cloud Pro | CometAPI |
|---|---|---|---|
| Input reference image | $0.003/image | $0.003/image | $0.0024/image untuk Standard dan Pro |
| Successful 1K output | $0.030/image | $0.040/image | Standard: $0.0240/image; Pro: $0.0320/image |
| Successful 2K output | $0.030/image | $0.075/image | Standard: $0.0240/image; Pro: $0.0600/image |
| 100 successful 1K outputs | $3.00 | $4.00 | Standard: $2.40; Pro: $3.20 untuk 100 gambar keluaran* |
| 1,000 successful 2K outputs | $30.00 | $75.00 | Standard: $24.00; Pro: $60.00 untuk 1.000 gambar keluaran* |
| Billing unit | Input/output image | Input/output image | Per gambar referensi input yang ditagihkan dan gambar keluaran yang berhasil, sesuai tabel harga yang disediakan |
| CometAPI output-price discount | 20% at 1K and 2K | 20% at 1K and 2K | Tarif input dan output adalah 80% dari harga gambar resmi yang sesuai dalam tabel yang disediakan |
**Contoh volume di atas hanya mencakup gambar keluaran: 100 gambar Standard 1K berbiaya $2.40 dan 100 gambar Pro 1K berbiaya $3.20; 1.000 gambar Standard 2K berbiaya $24.00 dan 1.000 gambar Pro 2K berbiaya $60.00. Untuk pengeditan, tambahkan $0.0024 per gambar referensi input yang ditagihkan. Aturan untuk pekerjaan gagal, pajak, dan penyesuaian khusus akun dikecualikan.*
Menggunakan tarif gambar input dan output yang disediakan, perkirakan biaya gambar untuk salah satu penyedia sebagai berikut:
Biaya total = (gambar referensi yang ditagihkan × harga gambar input) + (keluaran yang berhasil × harga gambar output).
Untuk pekerjaan yang ditagihkan dua gambar referensi input dan tiga keluaran Standard 1K yang berhasil, biaya gambar Alibaba Cloud adalah (2 × $0.0030) + (3 × $0.0300) = $0.0960. Biaya gambar CometAPI yang sesuai adalah (2 × $0.0024) + (3 × $0.0240) = $0.0768, berdasarkan tarif yang disediakan.
CometAPI mengenakan biaya $0.0024 per gambar referensi input untuk kedua varian. Harga keluaran adalah $0.0240 per gambar Standard pada 1K atau 2K, $0.0320 per gambar Pro pada 1K, dan $0.0600 per gambar Pro pada 2K. Tabel yang disediakan mencantumkan setiap tarif input dan output 20% di bawah harga resmi yang sesuai. Untuk jumlah gambar yang ditagihkan sama, biaya gambar ini karenanya 20% lebih rendah; biaya tambahan atau ketentuan akun dapat mengubah tagihan akhir.
Untuk penganggaran produksi, verifikasi varian yang dipilih, resolusi gambar, biaya gambar referensi, jumlah keluaran per permintaan, dan diskon akun yang berlaku sebelum memperkirakan total biaya penggunaan.
How Do You Handle Qwen Image 3.0 API Errors?
| Symptom | Likely cause | Action |
|---|---|---|
| 401/403 | Kunci tidak valid atau region salah | Periksa kredensial, izin, dan lokasi deployment |
| 400 invalid image | Jumlah/tipe referensi salah | Gunakan 1–3 gambar, URL/base64 valid, format didukung |
| 400 invalid size | Area/rasio aspek tidak didukung atau pemisah | Normalisasi dimensi untuk endpoint |
| Unexpected JSON | Endpoint salah atau kontrak respons berbeda | Catat field respons dan adaptasikan parser |
| Expired image URL | Gambar tidak disimpan sebelum kedaluwarsa | Unduh dan simpan segera setelah diproduksi |
| Unexpected bill | Gambar referensi atau tier keluaran tak dihitung | Gunakan field penggunaan gambar dan kartu tarif saat ini |
| Inconsistent brand text | Keterbatasan generatif | Gunakan gerbang tinjau atau overlay teks pascaproduksi |
FAQ
Should I retry a Qwen Image 3.0 request after a timeout?
Timeout pada klien tidak membuktikan bahwa pembuatan berhenti. Simpan pengenal permintaan atau tugas, periksa riwayat pekerjaan penyedia atau API status yang didokumentasikan, dan tentukan apakah keluaran sudah ada sebelum mengirim ulang. Retry membabi buta dapat membuat pekerjaan duplikat dan biaya tambahan. Gunakan retry terbatas untuk kegagalan sementara dan ikuti panduan idempotensi penyedia jika tersedia.
How can I use local reference images with Qwen Image 3.0?
Untuk antarmuka kompatibel native, baca file sebagai bytes, lakukan Base64-encode, dan tambahkan data URI seperti data:image/png;base64,. Tempatkan string lengkap tersebut di image. Input Base64 tetap harus memenuhi batas ukuran dan dimensi gambar; path filesystem lokal bukan URL yang dapat diambil layanan.
How do I pass Qwen-specific options through an OpenAI SDK?
Simpan field gambar standar di argumen SDK biasa dan tempatkan field ekstensi Model Studio, seperti image dan prompt_extend, di dalam extra_body. Permintaan HTTP mentah menempatkan field tersebut langsung di level atas JSON. Panduan ini berlaku untuk antarmuka kompatibel native; periksa rute CometAPI yang dipilih sebelum meneruskan opsi khusus penyedia.
What should I do when Qwen Image 3.0 returns fewer images than requested?
Simpan keluaran yang berhasil terlebih dahulu dan catat jumlah aktual. Untuk penagihan native Alibaba Cloud, biaya keluaran mengikuti gambar yang berhasil dihasilkan. Jika diperlukan aset tambahan, minta hanya jumlah yang kurang setelah memeriksa respons dan catatan penggunaan; penagihan CometAPI harus direkonsiliasi terhadap ketentuan akun masing-masing.
Conclusion
Qwen Image 3.0 adalah pilihan praktis bagi tim yang membutuhkan pembuatan dan pengeditan berbasis referensi dalam satu keluarga model. Gunakan Standard untuk baseline yang berfokus pada biaya, uji Pro untuk tugas 2K atau kreatif yang lebih menuntut, dan ukur biaya keluaran yang diterima alih-alih menilai berdasarkan harga per permintaan semata. Mulailah dengan panggilan pembuatan minimal, persistensikan keluarannya, lalu tambahkan pengeditan atau banyak keluaran melalui kontrak penyedia yang sesuai. Jaga kerahasiaan kredensial dan skema permintaan tetap terpisah, tangani error secara eksplisit, dan cocokkan penggunaan gambar dengan kartu tarif yang dipilih.