Skip to main content
استخدم مستندات نماذج الفيديو في CometAPI عبر اختيار سير عمل المزوّد الذي يطابق نوع المهمة لديك. تنشئ معظم نقاط نهاية الفيديو مهامًا غير متزامنة، لذا احفظ معرّف المهمة واستخدم polling لاسترجاع النتائج. أضف callbacks فقط عندما توثّق الصفحة الخاصة بالنموذج دعم callback.

اختر واجهة برمجة تطبيقات فيديو

إنشاء فيديو 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 أو دليل النماذج قبل تشغيل الطلب.
افتح Create a Seedance video وRetrieve a Seedance video لاستخدام ساحات تجريب API ومخططات نقاط النهاية.

أمثلة على الاستجابة

قد تبدو استجابة الإنشاء الناجحة كما يلي. خزّن task ID قبل بدء الاستعلام:
قد تبدو استجابة الاستعلام الناجحة كما يلي. يمكن أن تتضمن الاستجابات المكتملة video_url؛ وتستخدم بعض تنسيقات المزوّد حقول نتائج خاصة بكل model أو مسار محتوى الفيديو عندما يكون ذلك المسار موثقًا:

سجلات نماذج مثال

يوضح هذا المثال لاستجابة فهرس النماذج غلاف /api/models وشكل سجل نموذج فيديو واحد. وهو ليس قائمة نماذج كاملة.
cURL

الأخطاء الشائعة

خزّن المعرّف من استجابة الإنشاء قبل الإرجاع من معالج المهمة الخاص بك.
أضف تأخيرًا وتراجعًا تدريجيًا بين عمليات التحقق من الحالة.
استخدم حقول المدة والدقة الموثقة لنقطة نهاية الفيديو المحددة.
تعامل مع video_url على أنه اختياري، وارجع إلى حقول النتائج الخاصة بالنموذج أو مسار content عند توفره.
استخدم الاستطلاع بوصفه المصدر الموثوق للحقيقة، وتحقق من أن عنوان URL الخاص بـ callback يقبل طلبات POST.

رموز الأخطاء واستراتيجية إعادة المحاولة

لا تُعِد المحاولة حتى يتم تصحيح حقول prompt أو الملفات أو المدة أو الحجم.
لا تُعِد المحاولة حتى يكون مفتاح API موجودًا وصالحًا.
تحقق من معرّف المهمة، وBase URL، والمسار، وmodel ID قبل إعادة المحاولة.
قلّل حجم الرفع قبل إعادة المحاولة.
أعد المحاولة مع exponential backoff وقلّل التزامن في الإنشاء أو الاستطلاع.
أعد محاولة إنشاء المهمة مع backoff؛ واستمر في استطلاع المهام الحالية ما لم تصل المهمة إلى خطأ نهائي.

التسعير ودليل النماذج

صفحة النماذج

اقرأ كيف يعرض CometAPI معرّفات النماذج في الوثائق.

دليل النماذج

تصفح توفر النماذج وإمكاناتها.

التسعير

تحقق من التسعير قبل استدعاء نموذج.
آخر تعديل في ٢٣ يونيو ٢٠٢٦