Doubao Seedance Video Model

2026.09.21 This site now supports video models
Official documentation: https://docs.volcengine.com/docs/ark/create-video-generation-task-api

Doubao Seedance API

2026.09.21 This site now supports video models
Official documentation: https://docs.volcengine.com/docs/ark/create-video-generation-task-api
Replace the official baseurl https://ark.cn-beijing.volces.com with https://api.openai-hk.com/doubao

1. Create Task

post https://api.openai-hk.com/doubao/api/v3/contents/generations/tasks

shell

curl --request POST \
  --url https://api.openai-hk.com/doubao/api/v3/contents/generations/tasks \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-2-0-mini-260615",
    "content": [
        {
            "type": "text",
            "text": "Bright and colorful advertising style, with fruit cookies as the protagonist, including four flavors: strawberry, apple, grape, and orange. The strawberry flavor references @Image1. Cookies and corresponding fruits are arranged in a geometric array with strong sense of order. The overall picture is clean, premium, and rhythmic. The opening features fruits quickly establishing visual focus, referencing the composition of @Video1, with music beats cutting in. Then different flavored cookies are neatly arranged, cutting to close-ups, referencing the dynamics and camera movement of @Video2. Then quickly return to fast-paced editing. The ending features English text 'One bite of crispness, a heart full of delight' with rapid word segmentation switching, accompanied by strong rhythmic text movement and product freeze frame."
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://arkdocs.tos-cn-beijing.volces.com/images/video-generation/seedance2.5_reference1.png"
            },
            "role": "reference_image"
        },
        {
            "type": "video_url",
            "video_url": {
                "url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference2.mp4"
            },
            "role": "reference_video"
        },
        {
            "type": "video_url",
            "video_url": {
                "url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference3.mp4"
            },
            "role": "reference_video"
        }
    ],
    "generate_audio": true,
    "ratio": "16:9",
    "duration": 15,
    "resolution": "480p",
    "omni_reference_task_type": "reference"
}
'

curl --request POST \
  --url https://api.openai-hk.com/doubao/api/v3/contents/generations/tasks \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-2-0-mini-260615",
    "content": [
        {
            "type": "text",
            "text": "Bright and colorful advertising style, with fruit cookies as the protagonist, including four flavors: strawberry, apple, grape, and orange. The strawberry flavor references @Image1. Cookies and corresponding fruits are arranged in a geometric array with strong sense of order. The overall picture is clean, premium, and rhythmic. The opening features fruits quickly establishing visual focus, referencing the composition of @Video1, with music beats cutting in. Then different flavored cookies are neatly arranged, cutting to close-ups, referencing the dynamics and camera movement of @Video2. Then quickly return to fast-paced editing. The ending features English text 'One bite of crispness, a heart full of delight' with rapid word segmentation switching, accompanied by strong rhythmic text movement and product freeze frame."
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://arkdocs.tos-cn-beijing.volces.com/images/video-generation/seedance2.5_reference1.png"
            },
            "role": "reference_image"
        },
        {
            "type": "video_url",
            "video_url": {
                "url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference2.mp4"
            },
            "role": "reference_video"
        },
        {
            "type": "video_url",
            "video_url": {
                "url": "https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/seedance2.5_reference3.mp4"
            },
            "role": "reference_video"
        }
    ],
    "generate_audio": true,
    "ratio": "16:9",
    "duration": 15,
    "resolution": "480p",
    "omni_reference_task_type": "reference"
}
'

Returns the task_id

json

{
  "id": "task_6esMYNTJqw6h763PeafCp8N92fVY9Jic"
}

{
  "id": "task_6esMYNTJqw6h763PeafCp8N92fVY9Jic"
}

2. Main Request Parameters

Field	Required	Description
`model`	Yes	Model name from table above
`content`	Yes	Prompt + reference materials array, see below
`duration`	No	Duration (seconds)
`resolution`	No	Resolution, e.g., `480p` / `720p`
`ratio`	No	Aspect ratio, e.g., `16:9` (alias `aspect_ratio`)
`generate_audio`	No	Whether to generate audio

content array elements:

`type`	Material Field	`role`	Description
`text`	`text`	—	Prompt. Takes the first non-empty text
`image_url`	`image_url.url`	`reference_image` (default)	Reference image, corresponds to `@Image1`, `@Image2`…
`image_url`	`image_url.url`	`first_frame` / `last_frame`	First/last frame image, doesn't count in `@ImageN` numbering
`video_url`	`video_url.url`	`reference_video`	Reference video, corresponds to `@Video1`, `@Video2`…
`audio_url`	`audio_url.url`	`reference_audio`	Reference audio

Numbering rule: order is semantic. @Image1 is always the first reference image in the array, @Video1 is the first reference video—numbered separately by role starting from 1. Wrong order won't error, it will just render a video different from your description and still charge you.

3. Query Task

get https://api.openai-hk.com/doubao/api/v3/contents/generations/tasks/{taskId}

shell

curl --request GET \
  --url https://api.openai-hk.com/doubao/api/v3/contents/generations/tasks/task_6esMYNTJqw6h763PeafCp8N92fVY9Jic \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json'

curl --request GET \
  --url https://api.openai-hk.com/doubao/api/v3/contents/generations/tasks/task_6esMYNTJqw6h763PeafCp8N92fVY9Jic \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json'

Success response

json

{
  "content": {
    "video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0-mini/02178996062422000000000000000000000ffffac1446bb35c08d.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20260921%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20260921T031836Z&X-Tos-Expires=86400&X-Tos-Signature=601f68beb9da380599efea3817ce91612be94beabb085848281fa1ba9047b66c&X-Tos-SignedHeaders=host"
  },
  "created_at": 1789960624,
  "draft": false,
  "duration": 4,
  "execution_expires_after": 172800,
  "framespersecond": 24,
  "generate_audio": true,
  "id": "task_6esMYNTJqw6h763PeafCp8N92fVY9Jic",
  "model": "doubao-seedance-2-0-mini-260615-max",
  "origin_id": "cgt-20260921111703-hsk6d",
  "output_format": "mp4",
  "priority": 0,
  "ratio": "16:9",
  "resolution": "480p",
  "seed": 47550,
  "service_tier": "default",
  "status": "succeeded",
  "updated_at": 1789960725,
  "usage": {
    "completion_tokens": 40594,
    "total_tokens": 40594
  }
}

{
  "content": {
    "video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0-mini/02178996062422000000000000000000000ffffac1446bb35c08d.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20260921%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20260921T031836Z&X-Tos-Expires=86400&X-Tos-Signature=601f68beb9da380599efea3817ce91612be94beabb085848281fa1ba9047b66c&X-Tos-SignedHeaders=host"
  },
  "created_at": 1789960624,
  "draft": false,
  "duration": 4,
  "execution_expires_after": 172800,
  "framespersecond": 24,
  "generate_audio": true,
  "id": "task_6esMYNTJqw6h763PeafCp8N92fVY9Jic",
  "model": "doubao-seedance-2-0-mini-260615-max",
  "origin_id": "cgt-20260921111703-hsk6d",
  "output_format": "mp4",
  "priority": 0,
  "ratio": "16:9",
  "resolution": "480p",
  "seed": 47550,
  "service_tier": "default",
  "status": "succeeded",
  "updated_at": 1789960725,
  "usage": {
    "completion_tokens": 40594,
    "total_tokens": 40594
  }
}

Error response

json

{
  "error": {
    "code": "invalid_request",
    "message": "Upstream submit failed (400): {\"code\":\"fail_to_fetch_task\",\"message\":\"{\\\"error\\\":{\\\"code\\\":\\\"InvalidParameter\\\",\\\"message\\\":\\\"The parameter `output_format` specified in the request is not valid: the specified model does not support this output_format"
  },
  "id": "task_6CyBKW7HUIRQGEB45CQ8r1a0gQwugHDF",
  "model": "doubao-seedance-2-0-mini-260615-max",
  "status": "failed"
}

{
  "error": {
    "code": "invalid_request",
    "message": "Upstream submit failed (400): {\"code\":\"fail_to_fetch_task\",\"message\":\"{\\\"error\\\":{\\\"code\\\":\\\"InvalidParameter\\\",\\\"message\\\":\\\"The parameter `output_format` specified in the request is not valid: the specified model does not support this output_format"
  },
  "id": "task_6CyBKW7HUIRQGEB45CQ8r1a0gQwugHDF",
  "model": "doubao-seedance-2-0-mini-260615-max",
  "status": "failed"
}

4. Response Parameters

Field	Type	Description
id	string	`task_id`
model	string	Model name
content.video_url	string	Video URL result
usage	object	Usage information for billing
status	string	Status: `queued` `running` `succeeded` `failed`
error	string	Error message

Billing

Billed based on usage.total_tokens
Price depends on whether reference video is included, resolution, model
Price unit: CNY per million tokens
Price calculation formula: usage.total_tokens × price
With video unit price < without video, but with video has higher usage.total_tokens, so total price with video is higher

Model	With Video	Without Video
doubao-seedance-2-0-mini-260615 all resolutions	14	23
doubao-seedance-2-0-fast-260128 all resolutions	22	37
doubao-seedance-2-0-260128 480P/720P	28	46
doubao-seedance-2-0-260128 1080P	31	51
doubao-seedance-2-0-260128 4K	16	26
doubao-seedance-2-5-260628 480P/720P	42	70
doubao-seedance-2-5-260628 1080P	46	77

Doubao Seedance Video Model ​

Doubao Seedance API ​

1. Create Task ​

2. Main Request Parameters ​

3. Query Task ​

4. Response Parameters ​

Billing ​

Doubao Seedance Video Model

Doubao Seedance API

1. Create Task

2. Main Request Parameters

3. Query Task

4. Response Parameters

Billing