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
}

Choose a documented WxH value from the table below for the size field.

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

Use one of these exact values for the model field.

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

Use reference images

For Seedance 2.5 image-to-video requests, upload the reference image through the multipart input_reference field. The example on this page uses one file. Seedance 2.0, Seedance 2.0 Fast, and Seedance 2.0 Mini also accept input_reference. For advanced multi-reference prompts with those 2.0 models, repeat the same multipart field in upload order. One Mini production request with a single input_reference completed at the 720x1280 output size. That check confirmed request completion, but it did not isolate the reference image’s visual effect from the prompt. Seedance 2.0 is sensitive to how the prompt connects each reference image to the scene. Refer to the uploaded files by order, such as [Image 1], [Image 2], and [Image 3], then assign each image a clear role:

Use [Image 1] for the main subject, character, or product.
Use [Image 2] for a secondary subject, prop, or companion.
Use [Image 3] for the background, setting, lighting, or style.

Describe what should stay recognizable, what can change, the action, camera motion, visual style, and scene. A vague prompt can make the generated video look like the reference image was not used, even when the upload was accepted. This prompt structure is more reliable than only listing images:

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.

Duration by model

If you omit seconds, CometAPI requests a 5-second clip. Send seconds as a string when you need a specific duration.

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

The following exact sizes apply to both text-to-video and image-to-video requests with seedance-2-5-260628.

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 table below keeps the exact WxH values in one place. Seedance 2.0 Fast uses only the 480p and 720p values in the fifth 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, not 1080p or 4K. In one production check, a Mini request for 1920x1080 produced 1280x720.

Choose the documented WxH value for the target model. Exact WxH support remains model-dependent, so inspect the completed media before relying on an undocumented size.

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

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

file

Optional reference image uploaded as a multipart file. Seedance 2.5 image-to-video requests use this field; the included example uploads one file. Seedance 2.0, Seedance 2.0 Fast, and Seedance 2.0 Mini also accept this field; for their multi-reference requests, 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.

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 August 7, 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

Duration by model

Size support by model

Seedance 2.5

Earlier Seedance models

Authorizations

Body

Response

​Supported model IDs

​Use reference images

​Duration by model

​Size support by model

​Seedance 2.5

​Earlier Seedance models

Authorizations

Body

Response

Supported model IDs

Use reference images

Duration by model

Size support by model

Seedance 2.5

Earlier Seedance models