أخطاء

تستخدم واجهة برمجة تطبيقات VIDIO تنسيق كائن خطأ متسق. استخدم هذه الصفحة لفهم أنواع الأخطاء الشائعة ورموز حالة HTTP ورسائل الأمثلة التي تعود بها واجهة برمجة التطبيقات.

الوصول إلى واجهة برمجة التطبيقات متاح حاليًا لخطة الاستوديو وما فوق.

نظرة عامة

عندما يفشل الطلب، تعيد واجهة برمجة التطبيقات VIDIO كائن error مع type و message. قد تتضمن بعض الأخطاء أيضًا حقولًا إضافية لمساعدة في تفسير الفشل.

تنسيق الخطأ

json

{
  "error": {
    "type": "invalid_request_error",
    "message": "المهمة غير موجودة"
  }
}

مرجع الأخطاء

Status	Type	Message	Description
400	invalid_request_error	معلمات الاستعلام المطلوبة مفقودة في طلب عنوان URL للتحميل	يُرجع عندما تكون معلمات الاستعلام المطلوبة مفقودة من طلب عنوان URL للتحميل.
400	invalid_request_error	معرّف job_id مفقود	يُرجع عندما لا يتضمن طلب العرض معرّف job_id.
400	invalid_request_error	لا توجد مخرجات متاحة لهذه المهمة	يُرجع عندما لا تحتوي المهمة على أي مخرجات قابلة للعرض.
400	invalid_request_error	يجب أن تكون input_keys مصفوفة غير فارغة	يُرجع عندما تكون `input_keys` مفقودة أو فارغة.
400	invalid_request_error	يجب أن تحتوي input_keys على مفتاح إدخال صالح واحد على الأقل	يُرجع عندما تكون جميع مفاتيح الإدخال المقدمة فارغة أو غير صالحة بعد التطبيع.
400	input_duration_requirement_error	يجب أن يكون إجمالي مدة الإدخال أكثر من ثانيتين	يُرجع عندما تكون المدة المجمعة لجميع وسائط الإدخال ثانيتين أو أقل.
400	input_duration_requirement_error	يجب أن تكون مدة الإدخال الإجمالية أقل من 6 ساعات	يُرجع عندما تكون المدة المجمعة لجميع وسائط الإدخال 6 ساعات أو أكثر.
400	input_image_count_requirement_error	يجب ألا يزيد عدد صور الإدخال عن 4000	يُرجع عندما يتجاوز عدد صور الإدخال الحد الأقصى المسموح به وهو 4000.
400	input_video_count_requirement_error	يجب ألا يزيد عدد فيديوهات الإدخال عن 400	يُرجع عندما يتجاوز عدد فيديوهات الإدخال الحد الأقصى المسموح به وهو 400.
400	invalid_request_error	video_category غير صالح. القيم المسموح بها: podcast, ball-sports, non-ball-sports, beauty-product-demo, wedding, travel, others	يُرجع عندما لا يكون `video_category` مدعومًا.
400	invalid_request_error	aspect_ratio غير صالح. القيم المسموح بها: square, portrait, landscape	يُرجع عندما لا يكون `aspect_ratio` مدعومًا.
400	invalid_request_error	يجب أن يكون output_length رقمًا موجبًا	يُرجع عندما يكون `output_length` مفقودًا أو صفرًا أو سالبًا.
400	invalid_request_error	تعذّر تحديد مدة إدخال موجبة من البيانات الوصفية لـ input_keys	يُرجع عندما لا تستطيع واجهة برمجة التطبيقات تحديد مدة صالحة للمدخلات المحمّلة.
401	authentication_error	مفتاح API مفقود	يُرجع عندما لا يتم تقديم ترويسة `x-api-key`.
401	authentication_error	مفتاح API غير صالح	يُرجع عندما لا يتطابق مفتاح API المقدم مع مفتاح نشط.
402	insufficient_balance	ليس لديك رصيد كافٍ لمعالجة هذه المهمة	يُرجع عندما لا يحتوي الحساب على رصيد كافٍ للمعالجة أو التصيير.
403	permission_error	ليس لديك الإذن للوصول إلى هذه المهمة	يُرجع عندما لا يمتلك المستخدم المصادق عليه المهمة المطلوبة.
403	permission_error	ليس لديك إذن لتصيير هذه المهمة	يُرجع عندما لا يمتلك المستخدم المصادق عليه المهمة الجاري تصييرها.
404	invalid_request_error	المهمة غير موجودة	يُرجع عندما لا توجد المهمة المطلوبة.
404	invalid_request_error	المستخدم غير موجود	يُرجع عندما لا يمكن العثور على سجل المستخدم المصادق عليه.
429	rate_limit_error	عدد كبير جدًا من الطلبات	يُرجع عندما يتجاوز العميل معدل الطلبات المسموح به لهذا الطرف النهائي. الحد الحالي هو 60 طلبًا في الدقيقة. يتم تطبيق تحديد المعدل في المقام الأول لكل مفتاح API باستخدام ترويسة x-api-key، ويعود إلى عنوان IP الخاص بالعميل عندما لا يكون مفتاح API موجودًا. يجب على العملاء الذين يصلون إلى هذا الحد تقليل تكرار الطلبات وإعادة المحاولة بعد إعادة تعيين نافذة تحديد المعدل.
500	api_error	خطأ في المصادقة	يُرجع عندما تفشل مصادقة مفتاح API بشكل غير متوقع على الخادم.
500	api_error	خطأ داخلي في الخادم	يُرجع لحالات الفشل غير المتوقعة على جانب الخادم في نقاط النهاية status أو render أو highlight reel.
500	server_error	فشل إنشاء عنوان URL للتحميل	يُرجع عندما يفشل الخادم في إنشاء عنوان URL موقّع للتحميل.