创建 Seedance 视频

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'prompt="A matte magenta cube rotates slowly above a cyan studio floor while a small yellow sphere circles it."' \
  -F 'model="seedance-2-5"' \
  -F 'seconds="4"' \
  -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
}

将 size 设置为适用于您的模型的尺寸表中的 WxH 值。

对于 Seedance 2.0 Mini，请严格使用 doubao-seedance-2-0-mini。缩写的 seedance-mini 值不是有效的模型 ID。

支持的模型 ID

根据您的输入模式和分辨率选择模型，然后在 model 字段中发送其准确 ID。

模型	准确的模型 ID	模式和分辨率级别	支持情况 `seconds`
Seedance 2.5	`seedance-2-5`	文本生成视频、参考媒体； `480p`, `720p`	`4`-`30`
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`

使用参考图片

将 POST /v1/videos 作为 multipart/form-data 发送，并在 input_reference 中提供参考图片。对于多张图片，请按图片顺序重复该字段，每个字段中包含一个可公开访问的 HTTPS 图片 URL 或一个已上传的图片文件。在此字段中仅使用 URL 或仅使用文件。请分别发送每个 URL，而不要用逗号连接 URL。将每张上传图片的大小保持在 20 MiB（20 × 1024 × 1024 字节）或以下). Seedance 1.0 Pro 和 1.5 Pro 使用一张参考图片。Seedance 2.0、Fast 和 Mini 最多接受 9 张参考图片。 Seedance 2.5 最多接受 30 张参考图片。这些数量限制同时适用于 URL 和上传的文件。在 Prompt 中，为每张图片指定角色，例如主体、场景或视觉风格。描述需要保留的外观、动作和镜头运动。本页顶部的请求示例展示了图片 URL 输入，以及单图片或多图片上传。

发送参考图片 URL

使用两个图片 URL 来引导主体外观和场景：

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=doubao-seedance-2-0' \
  --form-string 'prompt=Use the subject in @Image1 and the setting in @Image2. Use a slow camera push-in and natural motion.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720' \
  --form-string 'input_reference=https://your-image-host/subject.png' \
  --form-string 'input_reference=https://your-image-host/setting.png'

使用参考视频和音频

Seedance 2.0、Fast、Mini 和 2.5 支持 reference_videos 和 reference_audios。视频参考请使用 MP4 文件，音频参考请使用 MP3 文件。将每个参考作为可公开访问的 HTTPS URL 或上传文件发送。使用参考音频时，至少搭配一张图片或一个视频。在 Prompt 中，使用 @Image1、@Video1 和 @Audio1 为参考素材分配角色。按各媒体类型中的顺序为参考素材编号。您可以在不同字段中组合使用 URL 和上传文件。在 input_reference、reference_videos 和 reference_audios 中，每个字段只能全部使用 URL 或全部使用文件。对于多个输入，每个输入重复一次该字段，而不要用逗号连接 URL。

模型系列	参考图片	参考视频	参考音频	参考输入总数
Seedance 2.0、Fast 和 Mini	最多 9 个 URL 或文件，使用 `input_reference`	最多 3 个	最多 3 个	最多 12 个
Seedance 2.5	最多 30 个 URL 或文件，使用 `input_reference`	最多 10 个 URL 或 5 个文件	最多 10 个 URL 或 5 个文件	最多 50 个

每个上传视频不得超过 50 MiB，每个上传音频文件不得超过 15 MiB。一个 MiB 等于 1024 × 1024 字节。标准版 Seedance 2.0（doubao-seedance-2-0）对 URL 和上传文件均有额外的媒体限制。对于参考视频，合计时长应介于 2 至 15 秒之间，总大小应小于 50 MB。参考视频的分辨率应约为 480p (640x640) 至 720p (834x1112). 对于参考音频，合计时长不得超过 15 秒，每个文件不得超过 15 MB。上传的媒体还必须满足上述单个文件的上传限制。

发送参考视频 URL

使用参考视频引导镜头运动和动作：

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=doubao-seedance-2-0' \
  --form-string 'prompt=Follow the camera movement and action in @Video1. Preserve the direction and pace of the motion.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720' \
  --form-string 'reference_videos=https://your-media-host/reference.mp4'

将图片 URL 与音频搭配使用

让参考主体随参考音频的节奏动起来：

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=doubao-seedance-2-0' \
  --form-string 'prompt=Animate the subject in @Image1 to the rhythm of @Audio1. Preserve the subject appearance and use a fixed camera.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720' \
  --form-string 'input_reference=https://your-image-host/subject.png' \
  --form-string 'reference_audios=https://your-media-host/reference.mp3'

使用 Seedance 2.5 上传参考媒体

在一个请求中上传两张图片、一个 MP4 视频和一个 MP3 音频文件：

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=seedance-2-5' \
  --form-string 'prompt=Use the subject in @Image1 and the setting in @Image2. Follow the motion in @Video1 and the rhythm of @Audio1.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720' \
  --form 'input_reference=@/path/to/subject.png;type=image/png' \
  --form 'input_reference=@/path/to/setting.png;type=image/png' \
  --form 'reference_videos=@/path/to/reference.mp4;type=video/mp4' \
  --form 'reference_audios=@/path/to/reference.mp3;type=audio/mpeg'

按模型划分的时长

将 seconds 设置为模型支持范围内的整数值。若省略该参数，CometAPI 会请求一个 5 秒的视频片段。

模型系列	支持范围 `seconds`	默认值	边界行为
Seedance 2.5	`4`-`30`	`5`	使用范围内的整数秒数。
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`	使用范围内的整数秒数。

按模型划分的尺寸支持

Seedance 2.5

对于 Seedance 2.5，这些 WxH 值同时适用于文本 Prompt 和参考媒体。

分辨率类别	`16:9`	`4:3`	`1:1`	`3:4`	`9:16`	`21:9`
`480p`	`854x480`	`752x560`	`640x640`	`560x752`	`480x854`	`992x432`
`720p`	`1280x720`	`1112x834`	`960x960`	`834x1112`	`720x1280`	`1470x630`

较早版本的 Seedance 模型

最后一列汇总了适用于 Seedance 1.5 Pro、标准版 Seedance 2.0 和 Fast 的精确 WxH 值。 Seedance 2.0 Fast 仅使用该列中的 480p 和 720p 值。该列中的 1080p 值适用于 Seedance 1.5 Pro 和标准版 Seedance 2.0。 4K 值仅适用于标准版 Seedance 2.0。在 Mini 列中，— 表示不支持该分辨率。

分辨率类别	宽高比	Seedance 2.0 Mini	Seedance 1.0 系列	Seedance 1.5 Pro / 标准版 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。将 size 设置为 Mini 列中的 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 image should control, such as the subject from @Image1, the secondary object from @Image2, and the background or style from @Image3. 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.

可用选项:

seedance-2-5,

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.5 accepts 4 to 30. 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 <= 30

示例:

5

size

string

Output size as an exact WxH value. For Seedance 2.5 text-to-video and image-to-video, use 854x480, 752x560, 640x640, 560x752, 480x854, or 992x432 for 480p; use 1280x720, 1112x834, 960x960, 834x1112, 720x1280, or 1470x630 for 720p. For Seedance 2.0 Mini, use 864x496, 752x560, 640x640, 560x752, 496x864, or 992x432 for 480p; use the same documented 720p values. The standard Seedance 2.0 model also accepts its documented 4K values.

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

示例:

"854x480"

"480x854"

"864x496"

"752x560"

"640x640"

"560x752"

"496x864"

"992x432"

"1280x720"

"1112x834"

"960x960"

"834x1112"

"720x1280"

"1470x630"

"1920x1080"

"1080x1920"

"3840x2160"

"3326x2494"

"2880x2880"

"2494x3326"

"2160x3840"

"4398x1886"

input_reference

Reference images: repeat input_reference with one publicly accessible HTTPS image URL or one uploaded image file per field. Use only URLs or only files within this field; do not join URLs with commas. Keep each uploaded image at or below 20 MiB. Seedance 2.0, Fast, and Mini allow up to nine image URLs or files and 12 reference inputs in total. Seedance 2.5 allows up to 30 image URLs or files and 50 reference inputs in total. For Seedance 1.0 Pro and 1.5 Pro, send one URL or one file. Submit images in the order you want to reference them in the prompt.

Pattern: ^https://

reference_videos

(string<uri> | file)[]

Reference video inputs for Seedance 2.0, Fast, Mini, and 2.5. Repeat reference_videos with a publicly accessible HTTPS MP4 URL or an uploaded MP4 file. Use only URLs or only files within this field. Each file can be up to 50 MiB. Seedance 2.0, Fast, and Mini allow up to three video inputs and 12 reference inputs in total. Seedance 2.5 allows up to ten video URLs or five uploaded video files, with 50 reference inputs in total. For standard Seedance 2.0 (doubao-seedance-2-0), URL and uploaded references must have a combined video duration of 2 to 15 seconds and a total video size under 50 MB. Each reference video must have a resolution of approximately 480p (640x640) to 720p (834x1112). These media limits apply in addition to the 50 MiB per-file upload limit.

Required array length: 1 - 10 elements

Pattern: ^https://

示例:

"https://your-media-host/reference.mp4"

reference_audios

(string<uri> | file)[]

Reference audio inputs for Seedance 2.0, Fast, Mini, and 2.5. Repeat reference_audios with a publicly accessible HTTPS MP3 URL or an uploaded MP3 file. Use only URLs or only files within this field. Each file can be up to 15 MiB. Seedance 2.0, Fast, and Mini allow up to three audio inputs and 12 reference inputs in total. Seedance 2.5 allows up to ten audio URLs or five uploaded audio files, with 50 reference inputs in total. Pair audio with at least one reference image or video. For standard Seedance 2.0 (doubao-seedance-2-0), URL and uploaded audio references must have a combined duration at or below 15 seconds, with each audio file at or below 15 MB. These media limits apply in addition to the 15 MiB per-file upload limit.

Required array length: 1 - 10 elements

Pattern: ^https://

示例:

"https://your-media-host/reference.mp3"

响应

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.

最后修改于 2026年9月9日

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'prompt="A matte magenta cube rotates slowly above a cyan studio floor while a small yellow sphere circles it."' \
  -F 'model="seedance-2-5"' \
  -F 'seconds="4"' \
  -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 密钥

支持的模型 ID

使用参考图片

发送参考图片 URL

使用参考视频和音频

发送参考视频 URL

将图片 URL 与音频搭配使用

使用 Seedance 2.5 上传参考媒体

按模型划分的时长

按模型划分的尺寸支持

Seedance 2.5

较早版本的 Seedance 模型

授权

请求体

响应

​支持的模型 ID

​使用参考图片

​发送参考图片 URL

​使用参考视频和音频

​发送参考视频 URL

​将图片 URL 与音频搭配使用

​使用 Seedance 2.5 上传参考媒体

​按模型划分的时长

​按模型划分的尺寸支持

​Seedance 2.5

​较早版本的 Seedance 模型

授权

请求体

响应

支持的模型 ID

使用参考图片

发送参考图片 URL

使用参考视频和音频

发送参考视频 URL

将图片 URL 与音频搭配使用

使用 Seedance 2.5 上传参考媒体

按模型划分的时长

按模型划分的尺寸支持

Seedance 2.5

较早版本的 Seedance 模型