SeeDance 2.0 Usage Examples¶
Create Video¶
curl --location --request POST 'https://api-cs-al.naci-tech.com/v1/video/generations' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"model": "sd2.0",
"content": [
{
"type": "text",
"text": "A Christmas bunny flying in the sky"
}
],
"generate_audio": true,
"ratio": "16:9",
"duration": 11,
"watermark": false
}'
Success Response¶
{
"id": "cgt-20260330164007-wnc8k",
"task_id": "cgt-20260330164007-wnc8k",
"object": "video",
"model": "doubao-seedance-2-0-260128",
"status": "queued",
"progress": 0,
"created_at": 1774860007
}
References¶
- Volcengine Ark SeeDance 2.0 Tutorial: https://www.volcengine.com/docs/82379/2291680?lang=zh
- Volcengine Ark Video Generation API Reference: https://www.volcengine.com/docs/82379/1520757?lang=zh
Query Video Generation Result¶
Query task status and output by task ID.
Path Parameters¶
| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | Yes | Task ID returned when creating a video task. |
Query Parameters¶
| Parameter | Type | Required | Description |
|---|---|---|---|
| raw | boolean | No | Whether to return the upstream raw response directly. If true, you get fuller upstream task details for troubleshooting. |
| show_raw | boolean | No | Whether to include raw task data in the wrapped response. If true, additional data.data is returned. |
| show_usage | boolean | No | Whether to include usage in the query response. If true and task is completed successfully, additional data.usage is returned. |
Request Example¶
curl --location --request GET 'https://api-cs-al.naci-tech.com/v1/video/generations/cgt-20260330164007-wnc8k' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Content-Type: application/json'
To get both raw task data and usage details:
curl --location --request GET 'https://api-cs-al.naci-tech.com/v1/video/generations/cgt-20260330164007-wnc8k?show_raw=true&show_usage=true' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Content-Type: application/json'
Query Success Response¶
When show_raw=true&show_usage=true, the API returns a wrapped task query response with both raw task data and usage details in data, for example:
{
"code": "success",
"data": {
"task_id": "cgt-20260330164007-wnc8k",
"action": "generate",
"status": "SUCCESS",
"fail_reason": "",
"submit_time": 1774860007,
"start_time": 1774860010,
"finish_time": 1774860088,
"progress": "100%",
"data": {
"id": "cgt-20260330164007-wnc8k",
"model": "doubao-seedance-2-0-260128",
"status": "succeeded",
"content": {
"video_url": "https://example.com/generated-video.mp4",
"last_frame_url": "https://example.com/last-frame.png"
},
"seed": 1345,
"resolution": "720p",
"ratio": "16:9",
"duration": 11,
"framespersecond": 30,
"usage": {
"completion_tokens": 13987,
"total_tokens": 15000
},
"created_at": 1774860007,
"updated_at": 1774860088
},
"usage": {
"completion_details": {
"video_durations": 11,
"video_tokens": 15000
},
"ratio": "16:9",
"watermark": false,
"generate_audio": true
}
}
}
{
"id": "cgt-20260330164007-wnc8k",
"task_id": "cgt-20260330164007-wnc8k",
"object": "video",
"model": "doubao-seedance-2-0-260128",
"status": "completed",
"progress": 100,
"created_at": 1774860007,
"completed_at": 1774860088,
"metadata": {
"url": "https://example.com/generated-video.mp4"
}
}
When raw=true, the response may include upstream original fields like:
{
"id": "cgt-20260330164007-wnc8k",
"model": "doubao-seedance-2-0-260128",
"status": "succeeded",
"content": {
"video_url": "https://example.com/generated-video.mp4",
"last_frame_url": "https://example.com/last-frame.png"
},
"seed": 1345,
"resolution": "720p",
"ratio": "16:9",
"duration": 11,
"framespersecond": 30,
"usage": {
"completion_tokens": 13987,
"total_tokens": 15000
},
"created_at": 1774860007,
"updated_at": 1774860088
}