Create a Seedance video

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
}

Set size to a WxH value from the size table for your model.

Use doubao-seedance-2-0-mini exactly for Seedance 2.0 Mini. The shortened seedance-mini value is not a valid model ID.

Supported model IDs

Choose a model for your input mode and resolution, then send its exact ID in the model field.

Model	Exact model ID	Modes and resolution tiers	Supported `seconds`
Seedance 2.5	`seedance-2-5`	Text-to-video, reference media; `480p`, `720p`	`4`-`30`
Seedance 2.0	`doubao-seedance-2-0`	Text-to-video, reference media; `480p`, `720p`, `1080p`, `4K`	`4`-`15`
Seedance 2.0 Fast	`doubao-seedance-2-0-fast`	Text-to-video, reference media; `480p`, `720p`	`4`-`15`
Seedance 2.0 Mini	`doubao-seedance-2-0-mini`	Text-to-video, reference media; `480p`, `720p`	`4`-`15`
Seedance 1.5 Pro	`doubao-seedance-1-5-pro`	Text-to-video, image-to-video; `480p`, `720p`, `1080p`	`4`-`12`
Seedance 1.0 Pro	`doubao-seedance-1-0-pro`	Text-to-video, image-to-video; `480p`, `720p`, `1080p`	`2`-`10`

Use reference images

Send POST /v1/videos as multipart/form-data, with reference images in input_reference. For multiple images, repeat the field in image order, with one publicly accessible HTTPS image URL or one uploaded image file per field. Use only URLs or only files within this field. Send each URL separately rather than joining URLs with commas. Keep each uploaded image at or below 20 MiB (20 × 1024 × 1024 bytes). Seedance 1.0 Pro and 1.5 Pro use one reference image. Seedance 2.0, Fast, and Mini accept up to 9 reference images. Seedance 2.5 accepts up to 30 reference images. These counts apply to both URLs and uploaded files. In the prompt, assign each image a role, such as the subject, setting, or visual style. Describe the appearance to preserve, the action, and the camera motion. The request samples at the top of this page show image URL inputs and single-image or multiple-image uploads.

Send reference image URLs

Use two image URLs to guide the subject appearance and setting:

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'

Use reference video and audio

Seedance 2.0, Fast, Mini, and 2.5 accept reference_videos and reference_audios. Use MP4 files for video references and MP3 files for audio references. Send each as a publicly accessible HTTPS URL or an uploaded file. Pair reference audio with at least one image or video. In the prompt, use @Image1, @Video1, and @Audio1 to assign roles to your references. Number references by their order within each media type. You can combine URLs and uploads across different fields. Within each of input_reference, reference_videos, and reference_audios, use either all URLs or all files. For multiple inputs, repeat the field once per input rather than joining URLs with commas.

Model family	Reference images	Reference videos	Reference audio	Total reference inputs
Seedance 2.0, Fast, and Mini	Up to 9 URLs or files in `input_reference`	Up to 3	Up to 3	Up to 12
Seedance 2.5	Up to 30 URLs or files in `input_reference`	Up to 10 URLs or 5 files	Up to 10 URLs or 5 files	Up to 50

Keep each uploaded video at or below 50 MiB and each uploaded audio file at or below 15 MiB. One MiB is 1024 × 1024 bytes. Standard Seedance 2.0 (doubao-seedance-2-0) has additional media limits for both URLs and uploaded files. For reference videos, keep the combined duration between 2 and 15 seconds and the total size under 50 MB. Use reference video resolution of approximately 480p (640x640) to 720p (834x1112). For reference audio, keep the combined duration at or below 15 seconds and each file at or below 15 MB. Uploaded media must also meet the per-file upload limits above.

Send a reference video URL

Use the reference video to guide the camera movement and action:

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'

Pair an image URL with audio

Animate the reference subject to the rhythm of the reference audio:

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'

Upload reference media with Seedance 2.5

Upload two images, an MP4 video, and an MP3 audio file in one request:

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'

Duration by model

Set seconds to an integer form value within your model’s range. If you omit it, CometAPI requests a 5-second clip.

Model family	Supported `seconds`	Default	Boundary behavior
Seedance 2.5	`4`-`30`	`5`	Use integer seconds in range.
Seedance 2.0, Seedance 2.0 Fast, and Seedance 2.0 Mini	`4`-`15`	`5`	Use integer seconds in range.
Seedance 1.5 Pro	`4`-`12`	`5`	Use integer seconds in range.
Seedance 1.0 Pro	`2`-`10`	`5`	Use integer seconds in range.

Size support by model

Seedance 2.5

For Seedance 2.5, these WxH values apply to both text prompts and reference media.

Resolution class	`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`

Earlier Seedance models

The final column groups exact WxH values for Seedance 1.5 Pro, standard Seedance 2.0, and Fast. Seedance 2.0 Fast uses only the 480p and 720p values in that column. The 1080p values in that column apply to Seedance 1.5 Pro and standard Seedance 2.0. The 4K values apply only to standard Seedance 2.0. In the Mini column, — means the resolution is not supported.

Resolution class	Aspect ratio	Seedance 2.0 Mini	Seedance 1.0 series	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 only)
	`4:3`	—	—	`3326x2494` (Seedance 2.0 only)
	`1:1`	—	—	`2880x2880` (Seedance 2.0 only)
	`3:4`	—	—	`2494x3326` (Seedance 2.0 only)
	`9:16`	—	—	`2160x3840` (Seedance 2.0 only)
	`21:9`	—	—	`4398x1886` (Seedance 2.0 only)

Seedance 2.0 Mini supports 480p and 720p. Set size to a WxH value from the Mini column.

Authorizations

Authorization

string

header

required

Bearer token authentication. Use your CometAPI key.

Body

multipart/form-data

prompt

string

required

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.

Example:

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

model

enum<string>

required

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

Available options:

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

Example:

"doubao-seedance-2-0-mini"

seconds

integer

default: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.

Required range: 2 <= x <= 30

Example:

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}$

Examples:

"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://

Example:

"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://

Example:

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

Response

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

string

required

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

object

string

required

Object type, always video.

model

string

required

Echo of the requested model id.

status

enum<string>

required

Initial task status. Newly created tasks are returned as queued.

Available options:

queued,

in_progress,

completed,

failed,

error

progress

integer

required

Completion percentage. 0 at creation.

Required range: 0 <= x <= 100

created_at

integer

required

Task creation time as a Unix timestamp in seconds.

task_id

string

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

Last modified on September 9, 2026

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
}

Content moderation

API keys

Supported model IDs

Use reference images

Send reference image URLs

Use reference video and audio

Send a reference video URL

Pair an image URL with audio

Upload reference media with Seedance 2.5

Duration by model

Size support by model

Seedance 2.5

Earlier Seedance models

Authorizations

Body

Response

​Supported model IDs

​Use reference images

​Send reference image URLs

​Use reference video and audio

​Send a reference video URL

​Pair an image URL with audio

​Upload reference media with Seedance 2.5

​Duration by model

​Size support by model

​Seedance 2.5

​Earlier Seedance models

Authorizations

Body

Response

Supported model IDs

Use reference images

Send reference image URLs

Use reference video and audio

Send a reference video URL

Pair an image URL with audio

Upload reference media with Seedance 2.5

Duration by model

Size support by model

Seedance 2.5

Earlier Seedance models