تخطَّ إلى المحتوى

مستندات المطور UlazAI

أخطاء الفيديو وحدودها

حدود التحقق والتكامل

فرض التحقق من جانب العميل قبل إرسال الطلبات. معظم حالات الفشل تأتي من مجموعات نماذج غير صالحة (المدة أو النسبة أو الجودة أو نوع الإدخال).

استجابات HTTP الشائعة

الكود معنى سبب نموذجي
400 طلب غير صالح النسبة/المدة/الجودة غير مدعومة، prompt مفقود، عنوان URL غير صالح
401 غير مصرح به جلسة مفقودة أو سياق مصادقة API
402 الدفع مطلوب الاعتمادات غير كافية لمجموعة الوظائف المطلوبة
404 لم يتم العثور عليه سبيكة نموذجية غير معروفة أو معرف مهمة غير معروف
429 معدل محدود تم تجاوز حدود الطلب لكل مستخدم

حراس نموذج محدد

  • model_slug يجب أن تكون موجودة في مصفوفة نموذج الفيديو.
  • aspect_ratio و duration_seconds يجب أن تتطابق مع خيارات النموذج تمامًا.
  • quality_mode يكون مطلوبًا عندما يكون للنموذج إعدادات مسبقة عالية الجودة.
  • Hailuo 2.3 يتطلب واحدًا input_image_urls الإدخال ولا يدعم صورتين.
  • wan_2_6_v2v يتطلب واحدا input_video_urls دخول.
  • يدعم Kling 3.0 الاختياري start_frame_url, end_frame_url، و elements مع التحقق الصارم من الشكل.
  • يقتصر حجم الدفعة على 4 وظائف لكل طلب.

حدود الطول Prompt

  • Kling 3.0 وKling 2.6: 2500 حرفًا.
  • فيديو Grok Imagine: 5000 حرف.
  • Hailuo 2.3 قياسي/برو: 5000 حرف.
  • تتبع معظم الطرز المتبقية التحقق القياسي من صحة prompt في خدمات التوليد.

حدود المعدل

  • /api/v1/video-studio/generate/: 24 طلب POST لكل مستخدم في الساعة.
  • نقاط نهاية أداة Video Studio: 24 طلب POST لكل مستخدم في الساعة.
  • Veo 3.1 إجراءات موسعة ومتطورة: 48 طلب POST لكل مستخدم في الساعة.

أعد محاولة الإستراتيجية

  • لا تقم بإعادة المحاولة 400 أو 404 دون إصلاح بيانات الطلب.
  • لا تقم بإعادة المحاولة 402 حتى يكون لدى الحساب أرصدة كافية.
  • أعد المحاولة 429 مع التراجع واحترام حدود معدل الخادم.
  • بالنسبة لحالات الفشل العابرة، أعد المحاولة فقط بعد التحقق من حالة المهمة الحالية لتجنب التكرارات.