الانتقال إلى المحتوى الرئيسي
POST
/
v1
/
videos
curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer <COMETAPI_KEY>" \
  -F 'prompt="A slow cinematic camera push across a coastal landscape at sunrise"' \
  -F 'model="doubao-seedance-2-0-fast"' \
  -F 'seconds="5"' \
  -F 'size="16:9"' \
  -F 'resolution="720p"'
{
  "id": "task_abc123",
  "task_id": "task_abc123",
  "object": "video",
  "model": "doubao-seedance-2-0-fast",
  "status": "SUBMITTED",
  "progress": 0,
  "created_at": 1776681149
}
استخدم نقطة النهاية هذه لبدء مهمة فيديو ByteDance Seedance. تشترك جميع فئات نموذج Seedance في نفس شكل الطلب؛ وتختار النموذج من خلال تعيين الحقل model. يعيد الاستدعاء معرّف مهمة فورًا وتستمر عملية التصيير في الخلفية.

​
اختر نموذجًا

Model idالفئةملاحظات
doubao-seedance-2-02.0أعلى جودة إخراج ضمن عائلة 2.0.
doubao-seedance-2-0-fast2.0إصدار أسرع من 2.0 للتكرار السريع والمعاينات.
doubao-seedance-1-5-pro1.5 Proيدعم 1080p. للنص إلى فيديو فقط.
doubao-seedance-1-0-pro1.0 Proيدعم 1080p ومقاطع أقصر بدءًا من ثانيتين. للنص إلى فيديو فقط.
راجع صفحة النماذج لمعرفة التوفّر المباشر.

​
نطاقات المعلمات

الحقلالنوعمطلوبالافتراضيالقيم المسموح بها
promptstringنعم—أي نص
modelstringنعم—doubao-seedance-2-0, doubao-seedance-2-0-fast, doubao-seedance-1-5-pro, doubao-seedance-1-0-pro
secondsintegerلا5يعتمد على النموذج (انظر أدناه)
sizestringلا16:921:9, 16:9, 4:3, 1:1, 3:4, 9:16
resolutionstringلا720p480p, 720p لنماذج 2.0؛ و480p, 720p, 1080p لـ 1.5 Pro و1.0 Pro
input_referencefileلا—JPEG أو PNG أو WebP. مقبول فقط في نماذج 2.0.

​
نطاق المدة حسب النموذج

النموذجنطاق seconds
doubao-seedance-2-0, doubao-seedance-2-0-fastمن 4 إلى 15
doubao-seedance-1-5-proمن 4 إلى 12
doubao-seedance-1-0-proمن 2 إلى 10
يؤدي إرسال قيمة خارج نطاق النموذج إلى إرجاع HTTP 400 مع code: "InvalidParameter" ورسالة حول duration.

​
دعم الصورة إلى فيديو

تقبل نماذج 2.0 فقط ملف input_reference. يؤدي إرسال input_reference مع doubao-seedance-1-5-pro أو doubao-seedance-1-0-pro إلى إرجاع HTTP 400 مع رسالة بالشكل the specified task_type r2v does not support model seedance-1-5-pro. استخدم هذه النماذج للنص إلى فيديو فقط.

​
رفع صورة مرجعية

نص الطلب هو multipart/form-data. لتشغيل الصورة إلى فيديو على نموذج 2.0، أرفق الصورة كجزء input_reference في الطلب نفسه: 
curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer <COMETAPI_KEY>" \
  -F 'prompt="A slow cinematic camera push across a coastal landscape at sunrise."' \
  -F 'model="doubao-seedance-2-0"' \
  -F 'seconds="5"' \
  -F 'size="16:9"' \
  -F 'resolution="720p"' \
  -F 'input_reference=@/path/to/reference.jpg'
استبدل /path/to/reference.jpg بالمسار المطلق أو النسبي للصورة التي تريد استخدامها كمرجع للإطار الأول. التنسيقات المدعومة هي JPEG وPNG وWebP.

​
تدفق المهمة

1

إرسال المهمة

أرسل طلب POST يتضمن على الأقل prompt وmodel. احفظ id المعاد للخطوة التالية.
2

الاستعلام عن المهمة

استدعِ استرجاع فيديو Seedance كل 10 إلى 20 ثانية.
3

تنزيل الإخراج

عندما تصبح status هي SUCCESS، نزّل الملف الموجود على video_url وأعِد استضافته إذا كنت بحاجة إلى وصول طويل الأمد. عنوان URL موقّع وتنتهي صلاحيته بعد مدة محدودة.

​
استجابات الخطأ

تعيد نقطة النهاية HTTP 400 عندما يكون حقل مطلوب مفقودًا، أو تقع قيمة خارج النطاق المقبول، أو يتم إرسال input_reference إلى نموذج لا يدعم الصورة إلى فيديو. وتعيد HTTP 401 عندما يكون bearer token مفقودًا أو غير صالح. يستخدم نص الخطأ أحد شكلين؛ راجع أمثلة 400 و401 في ساحة الاختبار لمعرفة الحقول الدقيقة.

التفويضات

​
Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الجسم

multipart/form-data
​
prompt
string
مطلوب

Text prompt that describes the video. Required.

مثال:

"A slow cinematic camera push across a coastal landscape at sunrise."

​
model
enum<string>
مطلوب

Seedance model id. Choose doubao-seedance-2-0 for the highest quality 2.0 output, doubao-seedance-2-0-fast for quick iteration on 2.0, doubao-seedance-1-5-pro for the 1.5 Pro tier, or doubao-seedance-1-0-pro for the 1.0 Pro tier. Only the two 2.0 models accept input_reference.

الخيارات المتاحة:
doubao-seedance-2-0,
doubao-seedance-2-0-fast,
doubao-seedance-1-5-pro,
doubao-seedance-1-0-pro
مثال:

"doubao-seedance-2-0-fast"

​
seconds
integer
افتراضي:5

Video duration in seconds. The accepted range depends on the model: doubao-seedance-2-0 and doubao-seedance-2-0-fast accept 4 to 15, doubao-seedance-1-5-pro accepts 4 to 12, and doubao-seedance-1-0-pro accepts 2 to 10. The default is 5 for every model.

النطاق المطلوب: 2 <= x <= 15
مثال:

5

​
size
enum<string>
افتراضي:16:9

Output aspect ratio. All Seedance models accept the same set of values.

الخيارات المتاحة:
21:9,
16:9,
4:3,
1:1,
3:4,
9:16
مثال:

"16:9"

​
resolution
enum<string>
افتراضي:720p

Output resolution. 480p and 720p are accepted by every model; 1080p is supported only by doubao-seedance-1-5-pro and doubao-seedance-1-0-pro.

الخيارات المتاحة:
480p,
720p,
1080p
مثال:

"720p"

​
input_reference
file

Optional reference image. When included, the job runs in image-to-video mode and uses the image as the visual anchor. Only doubao-seedance-2-0 and doubao-seedance-2-0-fast accept this field; sending it with a 1.0 Pro or 1.5 Pro model returns HTTP 400.

الاستجابة

Task created. Save the returned id and poll GET /v1/videos/{id}.

​
id
string
مطلوب

Task id. Use it as the path parameter for GET /v1/videos/{id}.

​
object
string
مطلوب

Object type, always video.

​
model
string
مطلوب

Echo of the requested model id.

​
status
enum<string>
مطلوب

Initial task status. A newly created task is returned as SUBMITTED.

الخيارات المتاحة:
SUBMITTED,
IN_PROGRESS,
SUCCESS,
FAILED,
ERROR
​
progress
integer
مطلوب

Completion percentage. 0 at creation.

النطاق المطلوب: 0 <= x <= 100
​
created_at
integer
مطلوب

Task creation time as a Unix timestamp in seconds.

​
task_id
string

Alias of id returned for compatibility. The value matches id.