اختر واجهة برمجة تطبيقات فيديو
إنشاء فيديو Seedance
إنشاء مهام فيديو Seedance.
إنشاء فيديو HappyHorse
إنشاء مهام HappyHorse من النص إلى الفيديو.
إنشاء فيديو Sora 2
إنشاء مهام فيديو Sora 2.
استرجاع فيديو Sora 2
الاستعلام عن مهام فيديو Sora.
إنشاء فيديو Veo 3
إنشاء مهام فيديو Veo.
إنشاء فيديو Wan
إنشاء مهام Wan من النص إلى الفيديو.
إنشاء فيديو xAI
توليد مهام فيديو xAI.
إنشاء فيديو Vidu
إنشاء مهام Vidu من النص إلى الفيديو.
إنشاء فيديو Omni (بيتا)
إنشاء مهام فيديو Omni التجريبية.
إنشاء مهمة Kling من النص إلى الفيديو
توليد فيديوهات Kling من prompts نصية.
إنشاء مهمة Runway من الصورة إلى الفيديو
توليد فيديوهات Runway من الصور.
إنشاء مهمة فيديو والاستعلام عنها حتى الاكتمال
استخدم model ID يدعم الفيديو من صفحة Models أو دليل النماذج. تنشئ الأمثلة أدناه مهمة فيديو باستخدامPOST /v1/videos، ثم تستعلم بشكل متكرر عن task ID المُعاد حتى تصل المهمة إلى حالة نهائية.
تستخدم هذه الأمثلة القيمة البديلة
your-video-model-id. استبدلها بـ model ID فيديو متاح من صفحة Models أو دليل النماذج قبل تشغيل الطلب.أمثلة على الاستجابة
قد تبدو استجابة الإنشاء الناجحة كما يلي. خزّن task ID قبل بدء الاستعلام:video_url؛ وتستخدم بعض تنسيقات المزوّد حقول نتائج خاصة بكل model أو مسار محتوى الفيديو عندما يكون ذلك المسار موثقًا:
سجلات نماذج مثال
يوضح هذا المثال لاستجابة فهرس النماذج غلاف
/api/models وشكل سجل نموذج فيديو واحد. وهو ليس قائمة نماذج كاملة.cURL
الأخطاء الشائعة
معرّف المهمة مفقود
معرّف المهمة مفقود
خزّن المعرّف من استجابة الإنشاء قبل الإرجاع من معالج المهمة الخاص بك.
الاستطلاع سريع جدًا
الاستطلاع سريع جدًا
أضف تأخيرًا وتراجعًا تدريجيًا بين عمليات التحقق من الحالة.
المدة أو الحجم غير مدعوم
المدة أو الحجم غير مدعوم
استخدم حقول المدة والدقة الموثقة لنقطة نهاية الفيديو المحددة.
video_url مفقود
video_url مفقود
تعامل مع
video_url على أنه اختياري، وارجع إلى حقول النتائج الخاصة بالنموذج أو مسار content عند توفره.لم يتم استلام Callback
لم يتم استلام Callback
استخدم الاستطلاع بوصفه المصدر الموثوق للحقيقة، وتحقق من أن عنوان URL الخاص بـ callback يقبل طلبات POST.
رموز الأخطاء واستراتيجية إعادة المحاولة
400
400
لا تُعِد المحاولة حتى يتم تصحيح حقول prompt أو الملفات أو المدة أو الحجم.
401
401
لا تُعِد المحاولة حتى يكون مفتاح API موجودًا وصالحًا.
404
404
تحقق من معرّف المهمة، وBase URL، والمسار، وmodel ID قبل إعادة المحاولة.
413
413
قلّل حجم الرفع قبل إعادة المحاولة.
429
429
أعد المحاولة مع exponential backoff وقلّل التزامن في الإنشاء أو الاستطلاع.
500 or 503
500 or 503
أعد محاولة إنشاء المهمة مع backoff؛ واستمر في استطلاع المهام الحالية ما لم تصل المهمة إلى خطأ نهائي.
التسعير ودليل النماذج
صفحة النماذج
اقرأ كيف يعرض CometAPI معرّفات النماذج في الوثائق.
دليل النماذج
تصفح توفر النماذج وإمكاناتها.
التسعير
تحقق من التسعير قبل استدعاء نموذج.