Özet
Qwen Image 3.0, metinden görsele üretimi ve referans yönlendirmeli düzenlemeyi Standard (qwen-image-3.0) ve Pro (qwen-image-3.0-pro) varyantları altında birleştirir. Bir metin istemiyle başlayın, bir çıktı boyutu seçin, bir görüntü üretim isteği gönderin ve çıktıyı derhal kaydedin. Düzenleme için bir ila üç referans görsel ve açık bir korunacak öğe talimatı ekleyin. CometAPI üzerinde, örnek çağrıları devreye almadan önce gerçek rotayı ve uyumlu istek şemasını doğrulayın.
Temel Çıkarımlar
- Qwen Image 3.0 API, Standard (qwen-image-3.0) ve Pro (qwen-image-3.0-pro) aracılığıyla metinden görsele üretimi ve referans yönlendirmeli düzenlemeyi destekler; yerel çıktı PNG’dir.
- Qwen Image 3.0 API erişimi CometAPI üzerinden mevcuttur. Geliştiriciler bir API anahtarı alabilir, desteklenen uç noktayı doğrulayabilir ve görüntü üretimini uygulamalarına entegre edebilir.
- Qwen Image 3.0 API fiyatlandırması CometAPI’de istek başına $0.024’ten başlar; Alibaba Cloud Singapore’da ise Standard çıktı görseli başına $0.030 ve Pro 1K çıktı görseli başına $0.040’dan başlayan oranlarla karşılaştırılmıştır.
- Qwen Image 3.0 görüntü düzenleme, yerel Alibaba Cloud API’si üzerinden en fazla üç referans görseli destekler; üretim, istek başına bir ila altı çıktı destekler.
- Qwen Image 3.0 API entegrasyonu, üretim iş akışlarını devreye almadan önce sağlayıcıya özgü parametreleri, kimlik doğrulamayı, faturalama birimlerini ve geçici görsel URL’lerini doğrulamanızı gerektirir.
Qwen Image 3.0 API Nedir?
Qwen Image 3.0 API, metin talimatlarını görsellere dönüştürür ve sağlanan fotoğrafları veya tasarım varlıklarını dönüştürebilir. Desteklenen senaryolar arasında çok dilli posterler, e-ticaret fotoğrafçılığı, kampanya maketleri, arka plan değiştirme ve birleşik görsel düzenleme bulunur.
Qwen Image 3.0 Standard (qwen-image-3.0), metinden görsele üretim ve referans yönlendirmeli düzenleme için maliyet odaklı temel seçenektir. E-ticaret arka plan varyasyonları, sosyal medya görsel taslakları ve kampanya konsept keşfi gibi yüksek hacimli iş akışları için önce bunu düşünün. Örneğin, Standard’ı kullanarak birkaç ürün arka plan seçeneği üretin, ardından ürün sadakatini gözden geçirip geliştirmeye değer sürümleri seçin.
Qwen Image 3.0 Pro (qwen-image-3.0-pro), üretim ve referans yönlendirmeli düzenlemeyi destekler ve daha yüksek fiyatlı yerel 2K çıktı katmanına sahiptir. Kampanya kahraman görselleri, detaylı ürün kompozisyonları ve promosyon posterleri gibi kaliteye duyarlı teslimatlar için değerlendirin. Örneğin, ince detay veya yerleşim önemli olduğunda kısa listeye kalan bir konsepti Pro ile test edin ve kabul edilen sonuçları Standard ile karşılaştırın; daha yüksek bütçeye karar vermeden önce ölçülü bir karşılaştırma yapın.
Nasıl seçmeli: Taslaklar ve varyasyonlar için maliyete duyarlı olarak Standard ile başlayın. Aynı brief üzerinde Pro’yu, talepkar nihai çıktılar için test edin; ölçülen iyileşme ek maliyeti haklı çıkarıyorsa Pro’yu seçin. Bu adlandırmalar, tipografi, ürün sadakati, nesne sayısı veya yerleşim doğruluğuna ilişkin uygulamaya özel testlerin yerine geçmez.
| Özellik | Qwen Image 3.0 | Qwen Image 3.0 Pro |
|---|---|---|
| Model ID | qwen-image-3.0 | qwen-image-3.0-pro |
| Üretim / düzenleme | Her ikisi de | Her ikisi de |
| Düzenleme için referanslar | 1–3 | 1–3 |
| İstek başına üretilen görsel | 1–6 | 1–6 |
| Çıktı formatı | PNG | PNG |
| Çıktı piksel alanı | 512²–2048² | 512²–2048² |
| Önerilen istem uzunluğu | 4,500 token | 4,500 token |
| Birincil seçim gerekçesi | Maliyet verimli çıktı | Üst düzey çıktı değerlendirmesi |
Qwen Image 3.0 API Hangi Parametreleri Destekler?
Bu parametreleri Alibaba Cloud’un yerel OpenAI uyumlu arayüzü ile kullanın. CometAPI isteklerine sağlayıcıya özgü seçenekleri yalnızca seçili rota bunları belgeliyorsa ekleyin.
Her iki varyant için geçerlidir: qwen-image-3.0 (Standard) ve qwen-image-3.0-pro (Pro), Alibaba Cloud’un yerel OpenAI uyumlu arayüzünde aşağıda listelenen aynı parametreleri destekler. Varyantı model ile seçin; üretim ve düzenleme kontrolleri ortaktır. Bu, çıktı kalitesi veya fiyatlandırmanın aynı olduğunu ya da her CometAPI rotasının tüm yerel parametreleri sunduğunu garanti etmez.
| Parametre | Tür / örnek | Amaç |
|---|---|---|
| model | qwen-image-3.0 | Standard veya Pro seçimi |
| prompt | string | Talimat ve içerik |
| image | URL / base64 string veya dizi | Düzenleme için 1–3 referans; üretim için atlayın |
| size | 1024x1024 | Çıktı boyutları; destekleniyorsa otomatik |
| n | integer 1–6 | Çağrı başına çıktı sayısı |
| negative_prompt | string | Kaçınılması gerekenleri tanımlayın |
| prompt_extend | boolean | İstem yeniden yazmayı etkinleştirin |
| prompt_extend_mode | direct / agent | Agent modu yalnızca T2I için |
| enable_thinking | boolean | Akıl yürütme kontrolü; geliştirme ayarlarına bağlı |
| watermark | boolean | İsteğe bağlı filigran |
| seed | integer | Tekrarlanabilirlik yardımı |
Yerel isteklerde, çıktı en-boy oranı 1:8 ile 8:1 arasında kalmalıdır. Referans görseller en fazla 10 MB olmalı, her bir kenar 1 ile 8.000 piksel arasında olmalı ve en uzun ile en kısa kenar oranı 10:1’i aşmamalıdır. Base64 girişi için bir veri URI’si kullanın. Thinking, prompt_extend=true gerektirir; agent geliştirmesi yalnızca metinden görsele için desteklenir.
Uyumlu bir görüntü isteği, üretim alanlarını JSON üst seviyesinde konumlandırır ve boyutları 1024x1024 biçiminde yazar. Yerel DashScope iç içe input/parameters kullanır ve boyutları genellikle 1024*1024 olarak yazar. Bu uç noktalar arasında dönüştürme yapılmadan kopyalanan bir istek başarısız olabilir.
Qwen Image 3.0 API’sini CometAPI ile Nasıl Çağırırsınız?
Bu adım adım anlatım; Python 3, Bash uyumlu bir terminal, modele erişimi olan bir CometAPI hesabı ve yeterli bakiye varsayar. İlk istek, sağlayıcı örneğinde gösterilen yalnızca model ve prompt alanlarını kullanır. Belgeler 16 Ekim 2026 tarihinde kontrol edilmiştir; bu örnekler ücretli bir hesaba karşı yürütülmemiştir.
Kimlik bilgileri oluşturun
CometAPI panonuzda sunucu taraflı bir API anahtarı oluşturun. Bunu asla web veya mobil istemciye gömmeyin.
export COMETAPI_KEY="your_api_key"python -m pip install requests
Minimal bir üretim isteği gönderin
Geliştiriciler, belgelendirilmiş görüntü üretim rotasını kullanarak CometAPI’de Qwen Image 3.0 API’ye erişebilir. Aşağıdaki minimal istekle başlayın; ardından isteğe bağlı parametreleri ekleyin.
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":"Premium skincare bottle on a stone pedestal, gentle studio lighting"}'
Dönen her görseli kaydedin
Aşağıdaki betiği generate.py olarak kaydedin ve python generate.py komutunu çalıştırın. Bir istek gönderir, URL veya Base64 görsel sonuçlarını işler ve her görseli yerel olarak yazar. Yanıt data dizisi yerine görev bilgileri içeriyorsa, bir yoklama uç noktası tahmin etmeden durur; tamamlanmış sonucu almak için hesaba özel asenkron sözleşmeyi kullanın.
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": "A sunny bookstore cafe, editorial photograph"}, 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"No synchronous images; inspect task/error fields: {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"Image {index} has no URL or Base64 payload") path = Path(f"qwen_image_{index}.png") path.write_bytes(content) print(f"Saved {path}")
Başarılı bir çalıştırma yerel görsel dosyaları üretir. Bunları açarak okunabilir olduklarını ve istenen sahneyle eşleştiklerini doğrulayın. İstek belirleyicisini ve kullanım alanlarını sunucu günlüklerinizde saklayın; kimlik bilgilerini günlüğe kaydetmeyin.
Qwen Image 3.0 ile Nasıl Birden Fazla Görsel Üretirsiniz?
Alibaba Cloud’un yerel arayüzünde, yaratıcı varyasyonlar için n değerini iki ile altı arasında ayarlayın. CometAPI için, seçili rotanızda destek doğrulandıktan sonra n’yi etkinleştirin. Dönen her varlığı ayrı ayrı doğrulayın; daha büyük bir n isteği, her sonucun aşağıdaki incelemeyi geçeceğini garanti etmez.
n parametresini ayarlayarak Qwen Image 3.0 ile tek bir istekte 6 adede kadar görsel üretebilirsiniz. Bu, hem qwen-image-3.0 hem de qwen-image-3.0-pro ile, metinden görsele üretim ve görsel düzenleme için çalışır. Varsayılan yalnızca bir görseldir.
Bunu yapmanın iki ana yolu vardır: platformunuz bu seçeneği sunuyorsa grafik arayüzü kullanın veya API’yi doğrudan çağırın.
API kullanarak birden fazla görsel üretin
- API belgelerini açın.
- QwenCloud konsolu/CometAPI’den bir API anahtarı alın.
qwen-image-3.0veyaqwen-image-3.0-proseçin.ndeğerini 1 ile 6 arasında istediğiniz görsel sayısına ayarlayın.- İsteminizi gönderin ve dönen görselleri kaydedin.
Örneğin, aynı istemin dört varyasyonu için "n": 4 ayarlayın.
Python örneği
Aşağıda OpenAI uyumlu API’yi kullanan, uyarlanabilir bir örnek vardır.
from openai import OpenAIimport requestsclient = OpenAI( api_key="YOUR_QWEN_API_KEY", base_url="https://maas.qwencloudapi.com/compatible-mode/v1")
result = client.images.generate( model="qwen-image-3.0-pro",
prompt=( "A cozy Japanese cafe on a rainy evening, " "warm glowing lights, cinematic photography, " "rich details, realistic reflections" ),
n=4,
size="1024x1024")# Save each generated image
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("Finished generating images!")
Gerekli paketleri önce yükleyin:
pip install openai requests
API, her sonuç için bir görsel URL’si döner. Üretilen görsel URL’leri geçicidir; bu nedenle görselleri derhal indirin.
Önemli ayarlar
| Parametre | Ne yapar |
|---|---|
| n=4 | Dört çıktı görseli üretir |
| model="qwen-image-3.0-pro" | Pro modeli seçer |
| size="1024x1024" | Kare görseller talep eder |
| seed=12345 | Sonuçları daha tekrarlanabilir kılar |
| negative_prompt | İstenmeyen görsel öğeleri hariç tutar |
Maksimum çıktı sayısı, istek başına altıdır. Daha fazla görsel istemenin üretim maliyetini artırdığını unutmayın.
Önemli bir ayrım: n=4, tek bir istemin dört varyasyonunu talep eder. Dört farklı istem istiyorsanız, ayrı istekler yapmalı veya istemleriniz üzerinde bir döngü otomasyonu kurmalısınız.
Qwen Image 3.0 ile Görselleri Nasıl Düzenlersiniz?
Bir düzenleme, bir ila üç görsel referansı ile talimatların birleşimidir. Hem istenen dönüşümü hem de değişmemesi gerekenleri açıklayın—örneğin ürün etiketi, renk, kamera açısı veya ambalaj geometrisi.
Aşağıdaki örnek Alibaba Cloud kimlik bilgilerini ve düzenleme için JSON görüntü alanı bağlantısını kullanır. Bölgesel bir Model Studio anahtarı oluşturun, çalışma alanı kimliğinizi edinin ve eşleşen uç noktayı yapılandırın. Bu isteğe CometAPI anahtarı koymayın.
export DASHSCOPE_API_KEY="your_model_studio_key"export ALIBABA_WORKSPACE_ID="your_workspace_id"export ALIBABA_IMAGE_ENDPOINT="https://${ALIBABA_WORKSPACE_ID}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/images/generations"
Aşağıdaki referans görsel doğrudan resmi API örneğinden gelmektedir. Bu, bu makalede üretilen bir sonuç değil, bir giriş görselidir.
import os, requests
endpoint = os.environ["ALIBABA_IMAGE_ENDPOINT"]
# documented regional .../images/generations endpoint
payload = {
"model": "qwen-image-3.0",
"prompt": "Change the outfit to a charcoal business suit in a cafe. Preserve the face and hairstyle.",
"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())
Yerel uyumlu uç nokta, /images/edits üzerinde çok parçalı yüklemeler değil, /images/generations üzerinde JSON kullanır. Maskeleri veya akış iletimini desteklemez. Dönen data dizisini okuyun ve yukarıda gösterilen aynı indirme döngüsüyle her URL’yi kaydedin.
İki referans için, image dizisine iki URL ekleyin ve istemde bunların rollerini belirtin (ör. birinci görselden ürün, ikinci görselden oda düzeni). Qwen Image 3.0 serisi üçten fazla referans görseli kabul etmez; daha büyük kaynak setleri için farklı bir model veya ön işleme iş akışı kullanın.
Qwen Image 3.0 API’nin Maliyeti Nedir?
Qwen Image 3.0 API fiyatlandırması, model varyantına, çıktı çözünürlüğüne ve sağlayıcıya göre değişir. Aşağıdaki tablo, orijinal Alibaba Cloud Singapore karşılaştırmasına, değerlendiricinin ekli fiyat tablosunda gösterilen CometAPI oranlarını ekler. Ek, görsel başına USD cinsinden çıktı fiyatları ve dört model/çözünürlük kombinasyonunun tümü için %20 indirim listeler. Bu oranlar canlı hesap faturalandırmasına karşı bağımsız olarak yeniden doğrulanmamıştır; üretim kullanımı öncesinde geçerli ücret tarifesini doğrulayın.
| Fiyat kalemi | Alibaba Cloud Standard | Alibaba Cloud Pro | CometAPI |
|---|---|---|---|
| Girdi referans görseli | $0.003/görsel | $0.003/görsel | Standard ve Pro için $0.0024/görsel |
| Başarılı 1K çıktı | $0.030/görsel | $0.040/görsel | Standard: $0.0240/görsel; Pro: $0.0320/görsel |
| Başarılı 2K çıktı | $0.030/görsel | $0.075/görsel | Standard: $0.0240/görsel; Pro: $0.0600/görsel |
| 100 başarılı 1K çıktı | $3.00 | $4.00 | Standard: $2.40; Pro: $3.20 (100 çıktı görsel için)* |
| 1.000 başarılı 2K çıktı | $30.00 | $75.00 | Standard: $24.00; Pro: $60.00 (1.000 çıktı görsel için)* |
| Faturalama birimi | Girdi/çıktı görseli | Girdi/çıktı görseli | Faturalandırılabilir girdi referans görseli ve başarılı çıktı görseli başına; sağlanan fiyat tablosuna göre |
| CometAPI çıktı indirimi | 1K ve 2K’de %20 | 1K ve 2K’de %20 | Girdi ve çıktı oranları, sağlanan tabloda karşılık gelen resmi görsel fiyatlarının %80’i |
*Yukarıdaki hacim örnekleri yalnızca çıktı görsellerini kapsar: 100 Standard 1K görsel $2.40 ve 100 Pro 1K görsel $3.20; 1.000 Standard 2K görsel $24.00 ve 1.000 Pro 2K görsel $60.00 tutarındadır. Düzenleme için, faturalandırılabilir her girdi referans görseli başına $0.0024 ekleyin. Başarısız iş kuralları, vergiler ve hesaba özgü ayarlamalar hariçtir.
Sağlanan girdi ve çıktı görsel oranlarını kullanarak, her iki sağlayıcı için de görsel ücretlerini aşağıdaki gibi tahmin edin:
Toplam maliyet = (faturalandırılabilir referans görseller × girdi görsel fiyatı) + (başarılı çıktılar × çıktı görsel fiyatı).
İki girdi referans görseli ve üç başarılı Standard 1K çıktı için faturalandırılan bir işte, Alibaba Cloud görsel ücretleri (2 × $0.0030) + (3 × $0.0300) = $0.0960’dır. Karşılık gelen CometAPI görsel ücretleri, sağlanan oranlara göre (2 × $0.0024) + (3 × $0.0240) = $0.0768’dir.
CometAPI, her iki varyant için de girdi referans görseli başına $0.0024 ücret alır. Çıktı fiyatları, 1K veya 2K’da Standard için görsel başına $0.0240, 1K’de Pro için görsel başına $0.0320 ve 2K’de Pro için görsel başına $0.0600’dır. Sağlanan tablo, her girdi ve çıktı oranını karşılık gelen resmi oranların %20 altında listeler. Aynı faturalandırılabilir görsel sayıları için bu nedenle görsel ücretleri %20 daha düşüktür; ek ücretler veya hesap koşulları nihai faturayı değiştirebilir.
Üretim bütçelemesi için, seçili varyantı, görsel çözünürlüğünü, referans görsel ücretlerini, istek başına çıktı sayısını ve geçerli hesap indirimlerini toplam kullanım maliyetini tahmin etmeden önce doğrulayın.
Qwen Image 3.0 API Hatalarını Nasıl Ele Alırsınız?
| Belirti | Olası neden | Eylem |
|---|---|---|
| 401/403 | Geçersiz anahtar veya yanlış bölge | Kimlik bilgilerini, izinleri ve dağıtım konumunu kontrol edin |
| 400 invalid image | Yanlış sayı/türde referans | 1–3 görsel, geçerli URL/base64, desteklenen formatlar kullanın |
| 400 invalid size | Desteklenmeyen alan/en-boy veya ayırıcı | Uç nokta için boyutları normalleştirin |
| Unexpected JSON | Yanlış uç nokta veya yanıt sözleşmesi | Yanıt alanlarını günlüğe alın ve ayrıştırıcıyı uyarlayın |
| Expired image URL | Görsel süre dolmadan kaydedilmedi | Üretilir üretilmez indirin ve saklayın |
| Unexpected bill | Hesaba katılmayan referanslar veya çıktı katmanı | Görsel kullanım alanlarını ve geçerli ücret tarifesini kullanın |
| Inconsistent brand text | Üretken sınırlamalar | İnceleme kapıları veya üretim sonrası metin bindirmesi kullanın |
SSS
Qwen Image 3.0 isteğini zaman aşımından sonra yeniden denemeli miyim?
İstemci zaman aşımı, üretimin durduğunu kanıtlamaz. Herhangi bir istek veya görev belirleyicisini saklayın, sağlayıcının iş geçmişini veya belgelenmiş durum API’sini kontrol edin ve yeniden göndermeden önce çıktıların zaten var olup olmadığını belirleyin. Kör yeniden denemeler, yinelenen işler ve ek ücretler oluşturabilir. Geçici hatalar için sınırlı yeniden denemeler kullanın ve mevcutsa sağlayıcının idempotency yönergelerini izleyin.
Qwen Image 3.0 ile yerel referans görsellerini nasıl kullanırım?
Yerel uyumlu arayüz için dosyayı bayt olarak okuyun, Base64 ile kodlayın ve data:image/png;base64, gibi bir veri URI’sini başına ekleyin. Bu tam dizeyi image alanına koyun. Base64 girişi yine de görsel boyutu ve boyut sınırlarını karşılamalıdır; yerel dosya sistemi yolu, hizmetin alabileceği bir URL değildir.
Qwen’e özgü seçenekleri bir OpenAI SDK’sından nasıl geçiririm?
Standart görsel alanlarını SDK’nızdaki olağan argümanlarda tutun ve Model Studio genişletme alanlarını, örneğin image ve prompt_extend, extra_body içine yerleştirin. Ham HTTP istekleri bu alanları doğrudan JSON üst seviyesine koyar. Bu rehberlik yerel uyumlu arayüz için geçerlidir; sağlayıcıya özgü seçenekleri iletmeden önce seçili CometAPI rotasını kontrol edin.
Qwen Image 3.0 istenenden daha az görsel döndürdüğünde ne yapmalıyım?
Önce başarılı çıktıları kaydedin ve gerçek sayıyı kayda alın. Yerel Alibaba Cloud faturalandırmasında, çıktı ücretleri başarılı şekilde üretilen görselleri takip eder. Ek varlıklar gerekiyorsa, yanıtı ve kullanım kaydını kontrol ettikten sonra yalnızca eksik miktar için istek yapın; CometAPI faturalandırması kendi hesap koşullarına göre mutabakata bağlanmalıdır.
Sonuç
Qwen Image 3.0, tek bir model ailesi içinde üretim ve referans odaklı düzenlemelere ihtiyaç duyan ekipler için pratik bir seçimdir. Maliyet odaklı temel için Standard’ı, daha talepkar 2K veya yaratıcı görevler için Pro’yu test edin ve yalnızca istek başına fiyatla yargılamak yerine kabul edilen çıktı maliyetini ölçün. Minimal üretim çağrısıyla başlayın, çıktıları kalıcı hale getirin ve ardından uygun sağlayıcı sözleşmesi üzerinden düzenleme veya çoklu çıktılar ekleyin. Kimlik bilgilerini ve istek şemalarını ayrı tutun, hataları açıkça yönetin ve görsel kullanımını seçili ücret tarifesiyle mutabakata bağlayın.