استكشاف الأخطاء وإصلاحها في Qwen Image Edit

يساعدك هذا الدليل في استكشاف الأخطاء الشائعة التي قد تواجهها عند استخدام Qwen Image Edit API وحزم SDK.

1. المشكلات الشائعة

1.1. الصورة لا تتغير كما هو متوقع

• المطالبة غير واضحة: تأكد من أن مطالبتك واضحة ومحددة. بدلًا من "تحسين الصورة"، جرب "اجعل الألوان أكثر حيوية وأضف تباينًا طفيفًا".
• المطالبة مستحيلة: قد تكون بعض التعديلات مستحيلة تقنيًا أو تتجاوز قدرات النموذج الحالي. على سبيل المثال، لا يمكنك إضافة كائنات غير موجودة في الصورة الأصلية بشكل واقعي تمامًا.
• جودة الصورة: قد تؤثر الصور منخفضة الدقة أو ذات الجودة الرديئة على دقة التعديلات.
• التحقق من عنوان URL للصورة: تأكد من أن عنوان URL للصورة المقدم يمكن الوصول إليه بشكل عام وصحيح.

1.2. أوقات معالجة بطيئة

• حجم الصورة: تؤدي الصور الأكبر حجمًا (من حيث الأبعاد أو حجم الملف) إلى أوقات معالجة أطول. حاول تحسين الصور قبل إرسالها.
• تعقيد المطالبة: قد تستغرق المطالبات الأكثر تعقيدًا التي تتضمن تعديلات متعددة أو تغييرات كبيرة وقتًا أطول.
• حركة مرور API: قد تؤثر فترات الذروة في استخدام API على أوقات الاستجابة. فكر في تنفيذ منطق إعادة المحاولة أو المعالجة غير المتزامنة.

2. أخطاء المصادقة

2.1. 401 Unauthorized

• مفتاح API مفقود أو غير صالح: تأكد من أنك تقوم بتضمين مفتاح API الصحيح في رأس Authorization كرمز حامل (Bearer YOUR_API_KEY).
• مفتاح API منتهي الصلاحية: تحقق مما إذا كان مفتاح API الخاص بك لا يزال صالحًا في لوحة تحكم Qwen Image Edit.

3. مشكلات الحصص وتحديد المعدل

3.1. 403 Forbidden أو 429 Too Many Requests

• تجاوز حدود المعدل: لقد تجاوزت عدد الطلبات المسموح بها في فترة زمنية معينة. قم بتنفيذ استراتيجية تراجع أسي (exponential backoff) لإعادة المحاولة.
• تجاوز الحصة: لقد تجاوزت إجمالي عدد العمليات المسموح بها لحسابك. تحقق من استخدامك في لوحة التحكم الخاصة بك أو اتصل بالدعم لزيادة حصتك.

4. مشكلات متعلقة بالصور

4.1. تنسيق الصورة غير مدعوم

• تنسيقات مدعومة: تأكد من أن صورتك بتنسيق مدعوم (مثل JPEG، PNG، WebP).

4.2. الصورة غير قابلة للوصول

• عنوان URL عام: إذا كنت تستخدم عنوان URL، فتأكد من أنه يمكن الوصول إليه بشكل عام من الإنترنت (وليس خلف جدار حماية أو يتطلب مصادقة).
• بيانات Base64 غير صالحة: إذا كنت تستخدم Base64، فتأكد من أنها مشفرة بشكل صحيح ولا تحتوي على أي أحرف تالفة.

5. مشكلات الشبكة

• مشكلات الاتصال: تأكد من أن تطبيقك يمكنه الوصول إلى نقاط نهاية Qwen Image Edit API. تحقق من تكوين جدار الحماية أو الوكيل.
• مهلات: قد تحدث مهلات بسبب بطء الاتصال بالشبكة أو أوقات معالجة طويلة. قم بزيادة مهلة طلب العميل إذا لزم الأمر.

6. فشل المعالجة

6.1. 500 Internal Server Error

• خطأ في API: يشير هذا إلى مشكلة على جانب الخادم. إذا استمرت المشكلة، فاتصل بدعم Qwen Image Edit مع job_id وأي تفاصيل ذات صلة.

6.2. job.failed Webhook

• إذا قمت بتكوين webhooks، فستتلقى إشعارًا عند فشل مهمة، بما في ذلك وصف الخطأ. استخدم هذا لتصحيح الأخطاء في تطبيقك.

7. مشكلات الأداء

• تحسين الصور: قلل من أبعاد الصورة وحجم الملف قبل إرسالها إلى API.
• المعالجة المتوازية: إذا كنت تعالج صورًا متعددة، ففكر في معالجتها بالتوازي (مع احترام حدود المعدل).

8. أدوات التصحيح

• سجلات API: راقب سجلات API الخاصة بك في لوحة تحكم Qwen Image Edit للحصول على معلومات مفصلة حول الطلبات والاستجابات والأخطاء.
• سجلات SDK: قم بتمكين التسجيل التفصيلي في SDK الخاص بك للحصول على مزيد من المعلومات حول ما يحدث على جانب العميل.
• أدوات المطور في المتصفح: إذا كنت تستخدم SDK في بيئة المتصفح، فاستخدم أدوات المطور لفحص طلبات واستجابات الشبكة.