Qwen Image 2.1 API İncelemesi: Erişilebilirlik ve Düzenleme

Qwen Image 2.1, indirilebilir ağırlıklar olarak sunuluyor; ayrıca uç noktaları, fiyatlandırması, şemaları ve çıktıları birbirinden farklı üçüncü taraf servisler üzerinden de kullanılabiliyor. Üretim ortamında görsel düzenleme söz konusu olduğunda kritik nokta modelin adı değil, resmî servisle aracı katman arasındaki fark.

API durumu: Kısa cevap tek tabloda

Resmî belgelerde ağırlıklar ve yerel çalıştırma entegrasyonları anlatılıyor; görsel başına herkese açık fiyatı olan birinci taraf barındırılan bir uç nokta ise belgelenmiş değil. Resmî duyuru ve GitHub deposu, 7B görsel üretici, Qwen3-VL 8B kodlayıcı, yerel şeffaflık desteği ve birden fazla referansla düzenleme özelliklerini açıklıyor.

“API kullanılabilir” demek gerçekte ne anlama geliyor?

Ağırlıkları kendi altyapınızda çalıştırabilir, yerel çıkarımı şirket içi bir HTTP servisiyle sarmalayabilir veya üçüncü taraf bir uç noktaya istek gönderebilirsiniz. Bir sağlayıcının model ID’sini kullanıyor olmanız, o servisi resmî Qwen hizmetine dönüştürmez.

SpicyAPI Qwen Image 2.1 rehberi, bu sağlayıcının temel metinden görsele, temel düzenleme, LoRA metinden görsele ve LoRA düzenleme uç noktalarını belgeliyor. Rehberde aspect_ratio ve resolution alanları, 1k, 1.5k ve 2k seviyeleri, 10 adede kadar referans görsel ve üç adede kadar LoRA desteği aktarılıyor. Ancak bunlar her Qwen kurulumunun değil, SpicyAPI’nin sözleşmesinin parçası.

Bu alanları bir adaptörün arkasında tutun:

SpicyAPI rehberine göre 2.1 şeması, eski Qwen Image 2.0 sürümündeki size alanını yok saymak yerine reddediyor. Bu tür alanları uygulama kodunun her yerine yaymak yerine adaptör katmanında dönüştürün.

Üretim ortamı için görsel düzenleme iş akışı

1. Değişikliği tanımlayın, referanslara rol verin

Önce neyin değişeceğini, hangi özelliklerin korunacağını ve hangi durumların başarısız sayılacağını netleştirin. Referansları rollerine göre etiketleyin ve mümkün olan en küçük setle başlayın; fazla görsel çelişen nitelikler üretebilir ve sağlayıcı maliyetini artırabilir.

2. Bölge işareti kullanın, ardından taşmayı kontrol edin

Resmî Qwen duyurusu, renkli daireler, boyanmış işaretler ve ayrı maskelerle yerel düzenleme örnekleri gösteriyor. Servis destekliyorsa ayrı maske daha iyi bir seçimdir; çünkü yönlendirme bilgisini kaynak görselin üzerine çizmez. Daire ve boya işaretleri ise kesin piksel sınırları değil, kullanışlı anlamsal ipuçlarıdır.

İstekte hedefi ve korunacak unsurları açıkça belirtin:

“Mavi işaretli bölgenin içindeki ceketi koyu yeşile çevir. Mavi işareti kaldır. Yüzü, elleri, arka planı, logoyu ve ışığı koru.”

SpicyAPI, daireyle yönlendirilen düzenlemelerin işaretli alanın dışındaki pikselleri de etkileyebileceğini belirtiyor. Sonucu kabul etmeden önce korunması gereken bölgeleri girdideki görselle karşılaştırın.

3. Taslakları 1K’da hazırlayın, seçtiklerinizi 2K’ya taşıyın

İlk denemeleri 1k seviyesinde yapın; yalnızca onaylanan çalışmayı 2k olarak yeniden üretin. İncelenen uç noktaya göre çözünürlük fiyatı değiştiriyor, en-boy oranı ise değiştirmiyor. Bu ücretlendirme kuralını başka bir sağlayıcı için genellemeyin.

Dönen dosyayı mutlaka doğrulayın:

• MIME türünü ve piksel boyutlarını.
• Yalnızca .png uzantısına bakmak yerine gerçek alfa kanalını.
• Yüzleri, elleri, logoları, ürün metinlerini ve küçük tipografik ayrıntıları.
• İstenen bölgenin dışındaki pikselleri.
• Her referanstan aktarılması gereken özellikleri.
• Sonucun kabul edilen önceki sürümden gerçekten anlamlı ölçüde farklı olup olmadığını.

Checkpoint yerel RGBA üretimini destekliyor; ancak SpicyAPI, kendi uç noktasının PNG isteklerinde beyaz arka planlı üç kanallı RGB döndürdüğünü bildiriyor. Şeffaflığa güvenmeden önce görsel kanallarını inceleyin ve gerçek bir üst üste bindirme testi çalıştırın.

4. Kabul edilen çıktıları karşılaştıracak kadar kayıt tutun

Kabul edilen her görselle birlikte normalize edilmiş istemi, referans sırasını, düzenleme varlığını, model ve sağlayıcı ID’lerini, çözünürlüğü, seed değerini, istek ID’sini ve dönen dosyanın meta verilerini saklayın. SpicyAPI, seed kullanılmasının piksel düzeyinde birebir aynı sonuçları garanti etmediğini belirtiyor.

İnceleme bağlamı: Kalite ve dağıtım dengesi

Qwen’in yayımladığı Qwen-Image-Bench skoruna göre model 60.28 puan alıyor; kaynakta karşılaştırılan Nano Banana 2.0 59.82, GPT Image 1.5 ise 59.65 seviyesinde. Bunlar Qwen’in benchmark sonuçları; sağlayıcılar arasında bağımsız bir sıralama değil. Bu nedenle sonuçları mutlak bir kazanan iddiası olarak değil, test setine dair bir sinyal olarak değerlendirin.

Yerel dağıtımın kapladığı alan da “7B” etiketinin düşündürdüğünden daha büyük. Tam iş akışında 7B görsel üreticiye ek olarak Qwen3-VL 8B kodlayıcı ve VAE bulunuyor. APIMaster’ın aktardığına göre BF16 ağırlıkları yaklaşık 33 GB yer kaplıyor; kuantize edilmiş bir ComfyUI birleşimi ise yaklaşık 14 GB seviyesinde. Bununla birlikte gerçek hız ve donanım uyumu kuantizasyon ile offloading tercihine bağlı.

Qwen Image 2.1 hangi durumlarda yanlış üretim tercihi?

En büyük engel lisans. Qwen-Image-2.1 lisansı bir Qwen Research License; yayın materyallerinde ticari kullanım için ayrı bir ticari lisans gerektiği belirtiliyor. Ücretli bir SaaS özelliği, müşteri teslimatı veya yeniden satılan bir çıkarım API’si sunmadan önce hukuki inceleme yapılmalı.

İkinci sorun ise servis sözleşmesindeki belirsizlik. Bir sağlayıcı yerel RGBA desteğini korumayabilir, maskeleri farklı yorumlayabilir ya da model ID’lerini ve fiyatlarını değiştirebilir. Başarısız doğrulama denemeleriyle birlikte GPU veya sağlayıcı ücretlerini de hesaba katarak kabul edilen görsel başına maliyeti karşılaştırın.

Yerel kontrol, birleşik düzenleme ve şeffaf varlıklar için gereken dağıtım emeği ve lisans süreci karşılanabiliyorsa Qwen Image 2.1 mantıklı bir seçenek. Belgelenmiş hizmet koşulları ve istikrarlı faturalandırma, model yığınını kendiniz yönetmekten daha önemliyse yönetilen ticari bir görsel API’si tercih edin.

Sık sorulan sorular

API şeffaf PNG döndürebilir mi?

Model yerel RGBA üretimini destekliyor; ancak barındırılan bir servis RGB döndürebilir. Şeffaflığa güvenmeden önce dönen görselin kanallarını kontrol edin.

Bir düzenlemede kaç referans görsel kullanılmalı?

Belgelenen iş akışı 10 adede kadar referans destekliyor. Önce gerekli bilgiyi taşıyan, açıkça etiketlenmiş en küçük setle başlayın.

Sabit seed aynı çıktıyı garanti eder mi?

Hayır. Yeniden üretilebilirlik; sağlayıcıya, çalışma zamanına, model sürümüne, scheduler’a ve diğer ayarlara da bağlıdır.

Qwen Image 2.1’i ücretli bir üründe kullanabilir miyim?

Otomatik olarak kullanamazsınız. Güncel Qwen Research License metnini inceleyin ve modeli gelir getiren bir iş akışında kullanmadan önce gerekli ticari izni alın.

Yayına almadan önce verilecek karar

Servisi, lisansı, şemayı, alfa davranışını, düzenleme bölgesinin nasıl işlendiğini ve kabul edilen görsel başına maliyeti doğrulamadan yayına çıkmayın. Bu kontroller tamamlanana kadar Qwen Image 2.1’i resmî API gibi değerlendirmek yerine araştırma veya staging ortamında tutun.