مستندات المطور UlazAI
الأخطاء والحدود
معالجة الأخطاء وحدود النظام الأساسي
استخدم المعالجة المنظمة لأخطاء API وتحقق من صحة المدخلات من جانب العميل لتقليلها إعادة المحاولة.
استجابات HTTP الشائعة
| الكود | معنى | سبب نموذجي |
|---|---|---|
400 |
طلب غير صالح | prompt مفقود، حجم غير مدعوم، معلمات نموذج غير صالحة |
401 |
غير مصرح به | مفتاح/رمز الجلسة API مفقود أو غير صالح |
402 |
الدفع مطلوب | الأرصدة المشتراة غير كافية أو تقييد الوصول إلى API |
403 |
ممنوع | تم تعطيل نقاط نهاية التسجيل/تسجيل الدخول API عمدًا |
404 |
لم يتم العثور عليه | معرف الجيل غير مملوك للمستخدم الحالي أو عدم تطابق نقطة النهاية |
500 |
خطأ في الخادم | فشل موفر المنبع أو انتهاء مهلة الشبكة |
حدود الطلب لفرض جانب العميل
prompt: الحد الأقصى 5000 حرف على نقطة النهاية الموحدة.image_urls: الحد الأقصى لـ 14 عنوان URL على نقطة النهاية الموحدة.size: نموذج محدد، التحقق من صحة ضد مصفوفة نموذجية.quality: القيم الخاصة بالطراز لـ Seedream 5 Lite وNano Banana 2 وIdeogram وQwen.- يتطلب استخدام API اعتمادات تم شراؤها؛ أرصدة ترحيبية متاحة على موقع الويب فقط.
أعد محاولة الإستراتيجية
سلوك الإنتاج الموصى به:
- لا تقم بإعادة المحاولة
400,401,402أو403دون تغيير المدخلات أو المصادقة. - أعد المحاولة
500مع التراجع الأسي ومفتاح العجز في طبقة التطبيق الخاص بك. - نقطة نهاية حالة الاستقصاء قبل إطلاق مهام الإنشاء المكررة.