Seedance 视频生成
本文说明火山 Seedance 视频生成模型的异步任务调用方式，包括文生视频、图生视频和任务查询。
一、Seedance 视频生成
适用模型：
Seedance 使用异步任务接口。
POST https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/api/v3/contents/generations/tasks
文生视频
curl -X POST https\://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/api/v3/contents/generations/tasks \
-H "Content-Type: application/json" \\
-H "Authorization: Bearer $API\_KEY" \\
-d '{
"model": "volcengine/doubao-seedance-2-0",
"content": [
{
"type": "text",
"text": "A cat walking on the beach, cinematic lighting."
}
],
"ratio": "16:9",
"duration": 5,
"watermark": false
}'
图生视频
curl -X POST https\://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/api/v3/contents/generations/tasks \
-H "Content-Type: application/json" \\
-H "Authorization: Bearer $API\_KEY" \\
-d '{
"model": "volcengine/doubao-seedance-2-0",
"content": [
{
"type": "image_url",
"text": "A cat walking on the beach, cinematic lighting."
}
],
"ratio": "16:9",
"duration": 5,
"watermark": false
}'
视频生成请求字段
| 字段 | 类型 | 必填 | 说明 |
|---|
model
model | string | 是 | Seedance 模型名称。 |
content
content | array | 是 | 多模态输入数组，常见元素包括文本和图片。 |
content[].type
content[].type | string | 是 | 内容类型，例如 text
text 、image_url
image_url 。Seedance 2.0 可能支持更多模态，取决于模型详情页。 |
content[].text
content[].text | string | 条件必填 | 文本提示词。 |
content[].image_url.url
content[].image_url.url | string | 条件必填 | 图片 URL。 |
ratio
ratio | string | 否 | 画面比例，例如 16:9
16:9 、9:16
9:16 、1:1
1:1 、4:3
4:3 、3:4
3:4 、21:9
21:9 、adaptive
adaptive 。 |
duration
duration | integer | 否 | 视频时长，单位秒。支持范围取决于模型版本。 |
resolution
resolution | string | 否 | 分辨率，例如 480p
480p 、720p
720p 、1080p
1080p 。 |
seed
seed | integer | 否 | 随机种子。 |
watermark
watermark | boolean | 否 | 是否添加水印。 |
generate_audio
generate_audio | boolean | 否 | 是否生成音频。是否支持取决于模型版本。 |
camera_fixed
camera_fixed | boolean | 否 | 是否固定镜头。是否支持取决于模型版本。 |
return_last_frame
return_last_frame | boolean | 否 | 是否返回最后一帧。是否支持取决于模型版本。 |
callback_url
callback_url | string | 否 | 任务完成后的回调地址。是否支持取决于接入点能力。 |
创建任务响应
{
"id": "cgt-xxxxxxxxxxxxxxxx",
"model": "volcengine/doubao-seedance-2-0",
"status": "queued",
"created_at": 1710000000
}
字段说明：
| 字段 | 说明 |
|---|
id
id | 视频生成任务 ID。 |
status
status | 任务状态。 |
created_at
created_at | 创建时间。 |
查询任务结果
curl -X GET https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/api/v3/contents/generations/tasks/{id} \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API\_KEY"
常见任务状态：
| 状态 | 说明 |
|---|
queued
queued / PENDING
PENDING | 排队中 |
running
running / RUNNING
RUNNING | 处理中 |
succeeded
succeeded / SUCCEEDED
SUCCEEDED | 成功 |
failed
failed / FAILED
FAILED | 失败 |
cancelled
cancelled / CANCELED
CANCELED | 已取消 |
expired
expired | 已过期 |
成功响应通常包含视频 URL：
{
"id": "cgt-xxxxxxxxxxxxxxxx",
"status": "succeeded",
"content": {
"video_url": "https://example.com/generated.mp4"
},
"usage": {
"duration": 5
}
}
注意：
- 火山官方视频任务通常仅支持查询最近 7 天的任务记录。
- 视频 URL 通常有有效期，常见为 24 小时，请生成成功后及时下载或转存。
- 轮询间隔建议 5 到 15 秒，避免高频查询。
- 创建任务前建议做幂等控制，避免用户重复点击导致重复计费。
