إنشاء فيديو Seedance

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'prompt="A matte red cube rotates slowly on a clean white studio floor. The camera remains fixed. Soft daylight and a short shadow."' \
  -F 'model="doubao-seedance-2-0-mini"' \
  -F 'seconds="15"' \
  -F 'size="1280x720"'

{
  "id": "task_abc123",
  "task_id": "task_abc123",
  "object": "video",
  "model": "doubao-seedance-2-0-mini",
  "status": "queued",
  "progress": 0,
  "created_at": 1776681149
}

اختر قيمة WxH موثقة من الجدول أدناه للحقل size.

استخدم doubao-seedance-2-0-mini بالضبط لـ Seedance 2.0 Mini. قيمة seedance-mini المختصرة ليست معرّف نموذج صالحًا.

معرّفات النماذج المدعومة

استخدم إحدى هذه القيم الدقيقة للحقل model.

النموذج	معرّف النموذج الدقيق	الأوضاع ومستويات الدقة	المدعوم `seconds`
Seedance 2.0	`doubao-seedance-2-0`	تحويل النص إلى فيديو، وتحويل الصورة إلى فيديو؛ `480p`, `720p`, `1080p`, `4K`	`4`-`15`
Seedance 2.0 Fast	`doubao-seedance-2-0-fast`	تحويل النص إلى فيديو، وتحويل الصورة إلى فيديو؛ `480p`, `720p`	`4`-`15`
Seedance 2.0 Mini	`doubao-seedance-2-0-mini`	تحويل النص إلى فيديو، وتحويل الصورة إلى فيديو؛ `480p`, `720p`	`4`-`15`
Seedance 1.5 Pro	`doubao-seedance-1-5-pro`	تحويل النص إلى فيديو؛ `480p`, `720p`, `1080p`	`4`-`12`
Seedance 1.0 Pro	`doubao-seedance-1-0-pro`	تحويل النص إلى فيديو؛ `480p`, `720p`, `1080p`	`2`-`10`

استخدام الصور المرجعية

تقبل Seedance 2.0 وSeedance 2.0 Fast وSeedance 2.0 Mini input_reference . بالنسبة إلى مطالبات المراجع المتعددة المتقدمة على مسار يدعمها، كرر حقل multipart نفسه بترتيب الرفع. اكتمل طلب إنتاج Mini واحد باستخدام input_reference في 720x1280 . أكد ذلك الفحص اكتمال الطلب، لكنه لم يعزل التأثير المرئي لـ الصورة المرجعية عن المطالبة. يتأثر Seedance 2.0 بكيفية ربط المطالبة لكل صورة مرجعية بالمشهد. أشر إلى الملفات المرفوعة حسب الترتيب، مثل [Image 1] و[Image 2] و[Image 3]، ثم عيّن لكل صورة دورًا واضحًا:

استخدم [Image 1] للموضوع الرئيسي أو الشخصية أو المنتج.
استخدم [Image 2] لموضوع ثانوي أو دعامة أو رفيق.
استخدم [Image 3] للخلفية أو البيئة أو الإضاءة أو النمط.

صف ما ينبغي أن يظل قابلًا للتعرّف، وما يمكن تغييره، والحركة، وحركة الكاميرا، والنمط المرئي، والمشهد. قد تجعل المطالبة الغامضة الفيديو المُنشأ يبدو كما لو أن الصورة المرجعية لم تُستخدم، حتى عند قبول الرفع. بنية المطالبة هذه أكثر موثوقية من مجرد سرد الصور:

Use the uploaded images in order: keep the boy wearing glasses and a blue T-shirt from [Image 1], add the corgi puppy from [Image 2], and use the lawn from [Image 3] as the setting. Create a 4-second 3D cartoon video with the boy and puppy sitting together, a slow camera push-in, soft daylight, and no extra characters.

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

إذا حذفت seconds، يطلب CometAPI مقطعًا مدته 5 ثوانٍ. أرسل seconds بوصفه سلسلة نصية عندما تحتاج إلى مدة محددة.

عائلة النموذج	المدعوم `seconds`	الافتراضي	سلوك الحدود
Seedance 2.0 وSeedance 2.0 Fast وSeedance 2.0 Mini	`4`-`15`	`5`	استخدم ثوانٍ صحيحة ضمن النطاق.
Seedance 1.5 Pro	`4`-`12`	`5`	استخدم ثوانٍ صحيحة ضمن النطاق.
Seedance 1.0 Pro	`2`-`10`	`5`	استخدم ثوانٍ صحيحة ضمن النطاق.

دعم الأحجام حسب الطراز

يجمع الجدول أدناه قيم WxH الدقيقة في مكان واحد. يستخدم Seedance 2.0 Fast فقط القيمتين 480p و720p في العمود الخامس. أما قيم 1080p في ذلك العمود فتنطبق على Seedance 1.5 Pro وstandard Seedance 2.0. أما قيم 4K فتنطبق فقط على standard Seedance 2.0. في عمود Mini، تعني — أن الدقة غير مدعومة.

فئة الدقة	نسبة العرض إلى الارتفاع	Seedance 2.0 Mini	سلسلة Seedance 1.0	Seedance 1.5 Pro / standard Seedance 2.0 / Fast
`480p`	`16:9`	`864x496`	`864x480`	`864x496`
	`4:3`	`752x560`	`736x544`	`752x560`
	`1:1`	`640x640`	`640x640`	`640x640`
	`3:4`	`560x752`	`544x736`	`560x752`
	`9:16`	`496x864`	`480x864`	`496x864`
	`21:9`	`992x432`	`960x416`	`992x432`
`720p`	`16:9`	`1280x720`	`1248x704`	`1280x720`
	`4:3`	`1112x834`	`1120x832`	`1112x834`
	`1:1`	`960x960`	`960x960`	`960x960`
	`3:4`	`834x1112`	`832x1120`	`834x1112`
	`9:16`	`720x1280`	`704x1248`	`720x1280`
	`21:9`	`1470x630`	`1504x640`	`1470x630`
`1080p`	`16:9`	—	`1920x1088`	`1920x1080`
	`4:3`	—	`1664x1248`	`1664x1248`
	`1:1`	—	`1440x1440`	`1440x1440`
	`3:4`	—	`1248x1664`	`1248x1664`
	`9:16`	—	`1088x1920`	`1080x1920`
	`21:9`	—	`2176x928`	`2206x946`
`4K`	`16:9`	—	—	`3840x2160` (Seedance 2.0 فقط)
	`4:3`	—	—	`3326x2494` (Seedance 2.0 فقط)
	`1:1`	—	—	`2880x2880` (Seedance 2.0 فقط)
	`3:4`	—	—	`2494x3326` (Seedance 2.0 فقط)
	`9:16`	—	—	`2160x3840` (Seedance 2.0 فقط)
	`21:9`	—	—	`4398x1886` (Seedance 2.0 فقط)

يدعم Seedance 2.0 Mini القيمتين 480p و720p، وليس 1080p أو 4K. في أحد اختبارات الإنتاج، أسفر طلب Mini للقيمة 1920x1080 عن 1280x720.

اختر قيمة WxH الموثقة للطراز المستهدف. يظل دعم WxH الدقيق معتمدًا على الطراز، لذا افحص الوسائط المكتملة قبل الاعتماد على حجم غير موثق.

التفويضات

Authorization

string

header

مطلوب

Bearer token authentication. Use your CometAPI key.

الجسم

multipart/form-data

prompt

string

مطلوب

Text prompt that describes the video. Required. When using reference images, describe what each uploaded image should control, such as the subject from [Image 1], the secondary object from [Image 2], and the background or style from [Image 3]. Also state the action, camera motion, visual style, and scene.

مثال:

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

model

enum<string>

مطلوب

Seedance model ID. Use one of the exact values below. Aliases such as seedance-mini are not accepted.

الخيارات المتاحة:

doubao-seedance-2-0,

doubao-seedance-2-0-fast,

doubao-seedance-2-0-mini,

doubao-seedance-1-5-pro,

doubao-seedance-1-0-pro

مثال:

"doubao-seedance-2-0-mini"

seconds

integer

افتراضي:5

Video duration in seconds. Seedance 2.0, Seedance 2.0 Fast, and Seedance 2.0 Mini accept 4 to 15. Seedance 1.5 Pro accepts 4 to 12, and Seedance 1.0 Pro accepts 2 to 10. The default is 5.

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

مثال:

5

size

string

Output size as an exact WxH value. For Seedance 2.0 Mini, use 864x496, 752x560, 640x640, 560x752, 496x864, or 992x432 for 480p; use 1280x720, 1112x834, 960x960, 834x1112, 720x1280, or 1470x630 for 720p. Mini does not support 1080p or 4K. A Mini request for 1920x1080 produced 1280x720 in one production check. The standard Seedance 2.0 model also accepts its documented 4K values.

Pattern: ^[1-9]\d{2,3}x[1-9]\d{2,3}$

أمثلة:

"864x496"

"752x560"

"640x640"

"560x752"

"496x864"

"992x432"

"1280x720"

"1112x834"

"960x960"

"834x1112"

"720x1280"

"1470x630"

"1920x1080"

"1080x1920"

"3840x2160"

"3326x2494"

"2880x2880"

"2494x3326"

"2160x3840"

"4398x1886"

input_reference

file

Optional reference image uploaded as a multipart file. Seedance 2.0, Seedance 2.0 Fast, and Seedance 2.0 Mini accept this field. On routes that support multiple reference images, repeat the field and reference the files in upload order as [Image 1], [Image 2], and so on. Seedance 1.0 Pro and 1.5 Pro do not accept it.

الاستجابة

Task created. Save the returned id and poll GET /v1/videos/{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. Newly created tasks are returned as queued.

الخيارات المتاحة:

queued,

in_progress,

completed,

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.

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

استرجاع فيديو Seedance

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'prompt="A matte red cube rotates slowly on a clean white studio floor. The camera remains fixed. Soft daylight and a short shadow."' \
  -F 'model="doubao-seedance-2-0-mini"' \
  -F 'seconds="15"' \
  -F 'size="1280x720"'

{
  "id": "task_abc123",
  "task_id": "task_abc123",
  "object": "video",
  "model": "doubao-seedance-2-0-mini",
  "status": "queued",
  "progress": 0,
  "created_at": 1776681149
}

الإشراف على المحتوى

مفاتيح API

معرّفات النماذج المدعومة

استخدام الصور المرجعية

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

دعم الأحجام حسب الطراز

التفويضات

الجسم

الاستجابة

​معرّفات النماذج المدعومة

​استخدام الصور المرجعية

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

​دعم الأحجام حسب الطراز

التفويضات

الجسم

الاستجابة

معرّفات النماذج المدعومة

استخدام الصور المرجعية

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

دعم الأحجام حسب الطراز