Skip to main content
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"' \
  -F 'seconds="4"' \
  -F 'size="16:9"'
{
  "id": "task_abc123",
  "task_id": "task_abc123",
  "object": "video",
  "model": "doubao-seedance-2-0",
  "status": "queued",
  "progress": 0,
  "created_at": 1776681149
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

The size field accepts exact WxH values and ratio preset labels. Ratio preset labels map to the model-specific default WxH values in the table below. If you need a specific 720p or 1080p output, pass the exact WxH value instead of only a ratio preset. Exact WxH support remains model-dependent, so use a documented size entry for the target model when the rendered resolution must stay fixed.

​
Size support by model

The table below follows the official Seedance resolution mapping and keeps the published size values in one place. For 1080p, the rightmost column lists the documented Seedance 1.5 Pro and Seedance 2.0 values. Seedance 2.0 Fast is not listed in that official 1080p table.
ResolutionAspect ratioPixel values for Seedance 1.0 seriesPixel values for Seedance 1.5 Pro / Seedance 2.0 / Seedance 2.0 Fast
480p16:9864×480864×496
4:3736×544752×560
1:1640×640640×640
3:4544×736560×752
9:16480×864496×864
21:9960×416992×432
720p16:91248×7041280×720
4:31120×8321112×834
1:1960×960960×960
3:4832×1120834×1112
9:16704×1248720×1280
21:91504×6401470×630
1080p16:91920×10881920×1080
4:31664×12481664×1248
1:11440×14401440×1440
3:41248×16641248×1664
9:161088×19201080×1920
21:92176×9282206×946

​
How ratio presets differ from exact WxH

Use a ratio preset when the model-specific default output size is acceptable. For the doubao-seedance-1-5-pro family, ratio-only requests use the 720p row from the table above:
Ratio presetDefault rendered size
16:91280x720
4:31112x834
1:1960x960
3:4834x1112
9:16720x1280
21:91470x630
Use exact WxH when the rendered resolution must stay fixed. For example, doubao-seedance-1-5-pro can render 1920x1080 and 1080x1920 as requested. Exact WxH remains model-dependent. doubao-seedance-2-0 can accept 1920x1080 and still render 1280x720.

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.

Example:

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

​
model
enum<string>
required

Seedance model id. Only the two 2.0 models accept input_reference.

Available options:
doubao-seedance-2-0,
doubao-seedance-2-0-fast,
doubao-seedance-1-5-pro,
doubao-seedance-1-0-pro
Example:

"doubao-seedance-2-0"

​
seconds
integer
default: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.

Required range: 2 <= x <= 15
Example:

5

​
size
string

Output size. Use either a ratio preset label such as 16:9, 4:3, 1:1, 3:4, 9:16, or 21:9, or an exact WxH value such as 1280x720. Ratio preset labels map to model-specific default render sizes. If you need a fixed 720p or 1080p output, pass the exact WxH value instead of only a ratio preset. Exact WxH support remains model-dependent, and an undocumented or unsupported raw WxH value can normalize to another size or fail.

Pattern: ^(16:9|4:3|1:1|3:4|9:16|21:9|[1-9]\d{2,3}x[1-9]\d{2,3})$
Examples:

"16:9"

"1280x720"

"1920x1080"

"4:3"

"1112x834"

"1:1"

"960x960"

"3:4"

"834x1112"

"9:16"

"720x1280"

"1080x1920"

"21:9"

"1470x630"

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

Response

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

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