Video Generation API

视频生成采用异步任务模式。

创建视频生成任务

POST /api/v3/contents/generations/tasks

认证： Authorization: Bearer <API_KEY>

请求体

{
  "model": "volcengine/doubao-seedance-1.5-pro",
  "content": [
    {"type": "text", "text": "一只金毛犬在海滩上奔跑"}
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "generate_audio": true,
  "draft": false
}
字段 类型 必填 说明
model string 是 模型 ID 或别名
content array 是 输入内容。支持 text、image_url、video_url 类型
resolution string 否 480p / 720p / 1080p，默认因模型而异
ratio string 否 16:9 / 9:16 / 4:3 / 3:4 / 1:1 / 21:9，默认 16:9
duration integer 否 时长（秒），默认 5。设为 -1 使用最大时长（15秒）
frames integer 否 帧数，与 duration 二选一
generate_audio boolean 否 是否生成音频，默认 true（仅部分模型支持）
draft boolean 否 草稿模式，生成更快质量略低（仅 1.5-pro 支持）

响应 (200)

{
  "id": "VTK-01JXXXXXXXXXXXXXX",
  "model": "volcengine/doubao-seedance-1-5-pro-251215",
  "status": "queued",
  "created_at": "2026-03-31T12:00:00Z"
}

查询视频生成任务

GET /api/v3/contents/generations/tasks/:id

认证： Authorization: Bearer <API_KEY>

响应 (200)

{
  "id": "VTK-01JXXXXXXXXXXXXXX",
  "model": "volcengine/doubao-seedance-1-5-pro-251215",
  "status": "succeed",
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "frames": 120,
  "draft": false,
  "created_at": "2026-03-31T12:00:00Z",
  "updated_at": "2026-03-31T12:02:30Z",
  "result": {
    "video_url": "https://..."
  }
}

任务状态枚举

值 说明
queued 排队中
running 生成中
succeed 成功
failed 失败
cancelled 已取消
expired 已过期

取消视频生成任务

DELETE /api/v3/contents/generations/tasks/:id

认证： Authorization: Bearer <API_KEY>

仅 queued 状态的任务可取消。

响应 (200)

{
  "id": "VTK-01JXXXXXXXXXXXXXX",
  "status": "cancelled"
}

错误响应

状态码 错误码 说明
404 NOT_FOUND 任务不存在
409 INVALID_STATE 任务不在 queued 状态
502 UPSTREAM_CANCEL_FAILED 上游取消失败

可用模型

模型 ID 别名 系列 需要权限
goldsaucer/advanced-video-generation-2-0 goldsaucer/avg-2.0 2.0 AVG_V2
goldsaucer/advanced-video-generation-2-0-fast goldsaucer/avg-2.0-fast 2.0 AVG_V2
volcengine/doubao-seedance-1-5-pro-251215 volcengine/doubao-seedance-1.5-pro 1.5 Pro -
volcengine/doubao-seedance-1-0-pro-250528 volcengine/doubao-seedance-1.0-pro 1.0 Pro -
volcengine/doubao-seedance-1-0-pro-fast-251015 volcengine/doubao-seedance-1.0-pro-fast 1.0 Pro -
volcengine/doubao-seedance-1-0-lite-i2v-250428 volcengine/doubao-seedance-1.0-lite-i2v 1.0 Lite -
volcengine/doubao-seedance-1-0-lite-t2v-250428 volcengine/doubao-seedance-1.0-lite-t2v 1.0 Lite -