الانتقال إلى المحتوى الرئيسي
POST
/
volc
/
v3
/
contents
/
generations
/
tasks
curl --request POST \
  --url https://api.cometapi.com/volc/v3/contents/generations/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedance-1-5-pro-251215",
  "content": [
    {
      "type": "text",
      "text": "A paper boat drifts on a quiet lake at sunrise. --duration 5 --ratio 16:9"
    }
  ]
}
'
{
  "id": "021773297205999example"
}
استخدم هذا endpoint لبدء مهمة فيديو ByteDance Seedance من نص، أو من نص مع صور مرجعية. يعيد الطلب معرّف المهمة فورًا بينما يستمر التصيير بشكل غير متزامن.

​
اختر مسار model الحالي

  • استخدم صفحة Models لمعرفة توفر النماذج الحالية ومعرّفاتها.
  • استخدم doubao-seedance-1-5-pro-251215 كمثال الإنتاج الحالي لهذا المسار.
  • يمكن لـ model الحالي نفسه التعامل مع الطلبات النصية فقط والطلبات الموجّهة بالصور عبر مصفوفة content الموحّدة.

​
تدفّق المهمة

1

أنشئ مصفوفة content

ضع تعليمات النص الرئيسية أولًا، ثم أضف عناصر الصور فقط عندما تحتاج إلى توجيه للإطار الأول أو الإطار الأخير.
2

أرسل المهمة

احفظ معرّف المهمة المُعاد. إذا كنت تريد التسليم عبر push، فاضبط callback_url عند إنشاء المهمة.
3

استعلم حتى يصل الإخراج

استدعِ ByteDance Video Query حتى تنتهي المهمة ويصبح content.video_url موجودًا.

​
سلوك الغلاف المعروف

توثّق Volcengine وSeedance هذه العائلة على أنها سير عمل غير متزامن بنمط الإنشاء ثم الاستعلام. يحافظ CometAPI على نمط المهمة نفسه، لكنه يمنحك عنوان URL أساسيًا واحدًا ومفتاح API واحدًا.
أثناء التحقق المباشر بتاريخ 2026-03-12، كان هذا المسار متاحًا للوصول لكنه ظل يعيد خطأ parse لـ JSON من جهة الخادم لعينة JSON قياسية. تعامل مع أمثلة OpenAPI هنا على أنها المرجع العملي للغلاف، وتحقق من صحة payload مبكرًا أثناء التطوير.

التفويضات

​
Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الجسم

application/json
​
model
string
مطلوب

ByteDance Seedance video model id. Choose a current model from the Models page. A current production example is doubao-seedance-1-5-pro-251215, which supports both text-only and image-guided requests through the same content array.

مثال:

"doubao-seedance-1-5-pro-251215"

​
content
object[]
مطلوب

Ordered input items for the task. Put the main text instruction first. Add image items when you need first-frame or last-frame guidance.

​
callback_url
string

Optional webhook URL for task status notifications.

الاستجابة

200 - application/json

Task accepted.

​
id
string
مطلوب

Task id for later polling.