أخطاء

تستخدم واجهة برمجة تطبيقات 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 مفقود	يُعاد هذا عندما لا يتضمن طلب العرض معرّف الوظيفة.
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	يُعاد هذا عندما لا يستطيع API تحديد مدة صالحة للمدخلات المحمّلة.
400	invalid_request_error	يجب أن يكون music_volume رقمًا بين 0 و100	يُعاد هذا عندما يتم توفير `music_volume` لكنه ليس رقمًا صالحًا بين 0 و100.
400	invalid_request_error	يجب أن يكون original_audio_volume رقمًا بين 0 و100	يُعاد هذا عندما يتم توفير `original_audio_volume` لكنه ليس رقمًا صالحًا بين 0 و100.
400	invalid_request_error	music_category غير صالح. القيم المسموح بها: corporate, romantic, sports, kids_and_comedy, ambient_and_nature, horror_and_suspense, documentary, trending_vlogs	يُعاد هذا عندما يتم توفير `music_category` ولكنه لا يطابق أيًا من فئات الموسيقى المدعومة.
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 موجودًا. يجب على العملاء الذين يصلون إلى هذا الحد تقليل تكرار الطلبات والمحاولة مرة أخرى بعد إعادة تعيين نافذة تحديد المعدل.
429	rate_limit_error	لديك بالفعل 10 وظائف قيد التشغيل أو في الطابور، وهو الحد الأقصى المسموح به. يرجى الانتظار حتى تنتهي بعض الوظائف قبل إرسال وظيفة أخرى.	يُعاد هذا عندما يكون لدى المستخدم بالفعل العدد الأقصى المسموح به من الوظائف الجارية (سواء كانت تعمل على الخوادم أو معلقة في الطابور). الحد الحالي هو 10 وظائف كحد أقصى قيد التشغيل أو في الطابور لكل مستخدم. يتم تحديد الملكية بمطابقة كل job_id على الخوادم المشغولة وإدخالات الطابور المعلقة مع user_email الخاص بالوظيفة. يجب على العملاء الذين يصلون إلى هذا الحد الانتظار حتى تكتمل وظيفة واحدة أو أكثر قبل إنشاء وظيفة جديدة أو تنفيذ التصيير لوظيفة أخرى.
500	api_error	خطأ مصادقة	يُعاد هذا عندما تفشل مصادقة مفتاح API بشكل غير متوقع على الخادم.
500	api_error	خطأ داخلي في الخادم	يُعاد هذا في حالات الفشل غير المتوقعة على جهة الخادم في نقاط النهاية الخاصة بالحالة أو التصيير أو المقتطفات البارزة.
500	server_error	فشل في إنشاء عنوان URL للتحميل	يُعاد هذا عندما يفشل الخادم في إنشاء عنوان URL موقع للتحميل.