مستندات المطور 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مع التراجع واحترام حدود معدل الخادم. - بالنسبة لحالات الفشل العابرة، أعد المحاولة فقط بعد التحقق من حالة المهمة الحالية لتجنب التكرارات.