Qwen Image Edit Sorun Giderme Kılavuzu

Bu kılavuz, Qwen Image Edit API'sini kullanırken karşılaşabileceğiniz yaygın sorunları gidermenize yardımcı olmak için tasarlanmıştır. Sorunları hızlı bir şekilde teşhis etmek ve çözmek için her bölümdeki adımları izleyin.

1. Yaygın Sorunlar

API çağrılarınızda bir sorunla karşılaşırsanız, öncelikle aşağıdakileri kontrol edin:

• API Anahtarı: API anahtarınızın doğru ve geçerli olduğundan emin olun.
• Bölge: İstemcinizin yapılandırıldığı bölgenin doğru olduğundan ve API anahtarınızla eşleştiğinden emin olun.
• İnternet Bağlantısı: Uygulamanızın aktif bir internet bağlantısına sahip olduğundan emin olun.
• SDK Sürümü: En son SDK sürümünü kullandığınızdan emin olun. Eski sürümler uyumluluk sorunlarına neden olabilir.

2. Kimlik Doğrulama Hataları

2.1. 401 Unauthorized

Bu hata genellikle geçersiz veya eksik bir API anahtarı nedeniyle oluşur.

• Çözüm: Authorization başlığında doğru API anahtarını Bearer YOUR_API_KEY formatında ilettiğinizden emin olun. Anahtarınızın süresinin dolmadığını veya iptal edilmediğini kontrol edin.

2.2. 403 Forbidden

Bu hata, API anahtarınızın istenen işlemi gerçekleştirmek için gerekli izinlere sahip olmadığını gösterir.

• Çözüm: Qwen Image Edit kontrol panelinizdeki API anahtarınızla ilişkili izinleri kontrol edin. Gerekirse izinleri güncelleyin.

3. Kota ve Hız Sınırlama Sorunları

3.1. 429 Too Many Requests

Bu hata, API hız sınırlarını aştığınızda meydana gelir.

• Çözüm: İstekleriniz arasına bir gecikme ekleyerek veya üstel geri çekilme stratejisi uygulayarak API çağrılarınızı azaltın. Daha yüksek hız sınırları için Qwen Image Edit destek ekibiyle iletişime geçmeyi düşünebilirsiniz.

3.2. 402 Payment Required

Bu hata, kullanım kotanızı aştığınızı veya hesabınızda yeterli kredi olmadığını gösterir.

• Çözüm: Qwen Image Edit kontrol panelinizdeki kullanımınızı ve faturalandırma bilgilerinizi kontrol edin. Gerekirse hesabınıza kredi ekleyin veya planınızı yükseltin.

4. Görselle İlgili Sorunlar

4.1. Invalid Image URL veya Image Not Found

API'ye iletilen görsel URL'si geçersiz veya erişilemez olduğunda bu hatalar oluşur.

• Çözüm: Görsel URL'sinin doğru yazıldığından, herkese açık olarak erişilebilir olduğundan ve güvenlik duvarları veya kimlik doğrulama gereksinimleri tarafından engellenmediğinden emin olun.

4.2. Unsupported Image Format

API'nin desteklemediği bir görsel formatı kullanıldığında bu hata oluşur.

• Çözüm: Görselinizin JPEG, PNG veya WebP gibi desteklenen bir formatta olduğundan emin olun. Gerekirse görseli dönüştürün.

4.3. Image Too Large

API'nin izin verdiğinden daha büyük bir görsel boyutu gönderildiğinde bu hata oluşur.

• Çözüm: Görseli API'nin izin verdiği maksimum boyuta (genellikle 10MB) sıkıştırın veya yeniden boyutlandırın.

5. Ağ Sorunları

5.1. Bağlantı Zaman Aşımı

Uygulamanız API sunucusuna bağlanamadığında veya yanıt çok uzun sürdüğünde oluşur.

• Çözüm: İnternet bağlantınızı kontrol edin. İstemcinizin yapılandırmasındaki zaman aşımı ayarlarını artırmayı deneyin. Qwen Image Edit hizmet durum sayfasını kontrol ederek herhangi bir kesinti olup olmadığını görün.

6. İşleme Başarısızlıkları

6.1. Processing Failed veya Internal Server Error (500)

Bu hatalar, API'nin isteğinizi işlerken dahili bir sorunla karşılaştığını gösterir.

• Çözüm: İsteğinizin geçerli olduğundan ve tüm parametrelerin doğru olduğundan emin olun. Sorun devam ederse, isteğinizin ayrıntılarıyla birlikte Qwen Image Edit destek ekibiyle iletişime geçin.

6.2. Invalid Prompt

Sağlanan istemin API tarafından anlaşılamadığını veya işlenemediğini gösterir.

• Çözüm: İsteminizin açık, özlü ve API'nin yetenekleriyle uyumlu olduğundan emin olun. Daha basit istemlerle deneme yapın veya örneklerdeki istem formatlarını takip edin.

7. Performans Sorunları

7.1. Yavaş Yanıt Süreleri

API yanıtlarının beklenenden daha uzun sürdüğünü fark ederseniz.

• Çözüm: Daha küçük görseller kullanmayı veya görsel boyutunu optimize etmeyi düşünün. Toplu işleme kullanıyorsanız, istek boyutunu azaltmayı deneyin. Ağ gecikmesini azaltmak için API'ye coğrafi olarak daha yakın bir bölge seçin.

8. Hata Ayıklama Araçları

• API Yanıtlarını Kontrol Edin: Her zaman API'den gelen tam yanıtı (durum kodları ve hata mesajları dahil) günlüğe kaydedin ve inceleyin.
• SDK Günlük Kaydı: SDK'nızın günlük kaydı özelliğini etkinleştirin (yapılandırma bölümüne bakın) ve daha ayrıntılı hata ayıklama bilgileri için günlükleri inceleyin.
• Qwen Image Edit Kontrol Paneli: İşlem geçmişinizi, API kullanımınızı ve hata günlüklerinizi kontrol panelinde inceleyin.