豆包 Seedance 2.5 草稿样片与正片 API 接口文档

doubao-seedance-2-5-260628、doubao-seedance-2.5 支持草稿样片（draft）→ 正片两阶段工作流：先以低分辨率（480p）快速预览效果，满意后再以同一任务 ID 升级生成正片（1080p）。这样可以在确认构图、动作和时序后再消耗正片算力，降低试错成本。令牌分组选择sd2-asset分组

接口地址

POST {BASE_URL}/v1/video/generations      # 提交任务（草稿样片 / 正片）
GET  {BASE_URL}/v1/video/generations/{task_id}  # 查询任务状态

第一阶段：生成草稿样片

请求示例

关键参数说明

参数	类型	必填	说明
`model`	string	是	固定为`doubao-seedance-2-5-260628`或 `doubao-seedance-2.5`
`prompt`	string	是	顶层占位字段，实际提示词写在`metadata.content` 的 `text` 条目里
`metadata.content`	object[]	是	输入内容数组，见下方 content 说明
`metadata.draft`	boolean	否	设为`true` 生成草稿样片（480p 低分辨率）；省略或 `false` 直接生成正片
`metadata.resolution`	string	否	草稿阶段建议传`"480p"`；Seedance 2.5 支持 `480p`、`720p`，不支持 1080p、4k
`metadata.duration`	integer	否	时长（秒），范围`4`~`30`，或 `-1` 由模型智能决定，默认 `5`
`metadata.ratio`	string	否	宽高比，如`"16:9"`、`"9:16"`、`"1:1"`、`"adaptive"`
`metadata.generate_audio`	boolean	否	是否生成配音，默认`true`

content 条目类型

type	字段	role	说明
`text`	`text`	—	文本提示词
`image_url`	`image_url.url`	`reference_image` / `first_frame` / `last_frame`	参考图片、首帧、尾帧
`video_url`	`video_url.url`	`reference_video`	参考视频（视频编辑 / 延长）
`audio_url`	`audio_url.url`	`reference_audio`	参考音频（2.5 支持纯音频生成）

草稿样片提交响应

{
  "task_id": "cgt-20260930102030-abcde"
}

查询草稿样片状态

响应结构说明

取视频地址两种等价方式：data.result_url，或 data.data.data.content.video_url。

草稿样片成功响应示例

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "cgt-20260930102030-abcde",
    "action": "generate",
    "status": "SUCCESS",
    "fail_reason": "",
    "result_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/.../cgt-xxx.mp4?...",
    "submit_time": 1790899230,
    "start_time": 1790899240,
    "finish_time": 1790899520,
    "progress": "100%",
    "data": {
      "code": "success",
      "message": "",
      "data": {
        "id": "cgt-20260930102030-abcde",
        "model": "doubao-seedance-2-5-260628",
        "status": "succeeded",
        "ratio": "16:9",
        "duration": 5,
        "resolution": "480p",
        "output_format": "mp4",
        "generate_audio": true,
        "draft": true,
        "framespersecond": 24,
        "seed": 12345,
        "content": {
          "video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/.../cgt-xxx.mp4?..."
        },
        "usage": {
          "total_tokens": 40000,
          "prompt_tokens": 0,
          "completion_tokens": 40000
        },
        "created_at": 1790899231,
        "updated_at": 1790899519
      }
    }
  }
}

查看 data.status='success' 或 data.data.data.draft 为 true 可确认这是草稿样片结果。

第二阶段：草稿转正片

样片审核通过后，在 metadata.content 中以 draft_task 类型引用草稿任务 ID，发起正片生成请求，drafk_task.id为草稿阶段视频任务ID。

请求示例

正片阶段关键说明

说明	详情
`content[0].type`	必须为`"draft_task"`
`content[0].draft_task.id`	填写草稿样片的`task_id`
`resolution`	固定为 1080p，不可指定其他值，也无需手动传入（平台自动补充）；若传入非 1080p 值会立即报错
其他参数	`duration`、`ratio`、`generate_audio` 等均由上游从草稿自动复用，禁止在正片请求中重复传入，否则上游返回 `InvalidParameter`

正片阶段平台会自动清除草稿复用的参数（duration、ratio 等），且resolution仅支持1080p

正片提交响应

{
  "task_id": "cgt-20260930103500-fghij"
}

正片生成时间通常比草稿更长（约 5~8 分钟），查询方式与草稿相同。

任务状态说明

状态（第 1 层，大写）	状态（第 3 层，小写）	说明
`NOT_START`	`queued`	已提交，等待开始
`IN_PROGRESS`	`running`	生成中
`SUCCESS`	`succeeded`	生成成功，可获取视频 URL
`FAILURE`	`failed`	生成失败，查看`fail_reason`

完整流程示例（Python）

计费说明

阶段	计费规则
草稿样片（480p）	按实际用量计费，档位为 480p（同 720p 默认档）
正片（1080p）	按实际用量计费，1080p 档位单价更高

草稿和正片各自独立计费，生成失败不扣费。

常见错误

HTTP 状态码	错误信息	说明
400	`draft_task 正片阶段 resolution 只能为 1080p`	正片请求中手动传了非 1080p 的 resolution
400	`InvalidParameter`	正片请求中重复传入了 duration、ratio 等草稿复用参数
400	请求体不是合法 JSON	请求体格式错误
401	未提供令牌	缺少 Authorization 头
403	未找到可用渠道	账号所在分组无 Seedance 2.5 可用渠道

豆包 Seedance 2.5 草稿样片与正片 API 接口文档

接口地址#

第一阶段：生成草稿样片#

请求示例#

关键参数说明#

content 条目类型#

草稿样片提交响应#

查询草稿样片状态#

响应结构说明#

草稿样片成功响应示例#

第二阶段：草稿转正片#

请求示例#

正片阶段关键说明#

正片提交响应#

任务状态说明#

完整流程示例（Python）#

计费说明#

常见错误#

接口地址

第一阶段：生成草稿样片

请求示例

关键参数说明

content 条目类型

草稿样片提交响应

查询草稿样片状态

响应结构说明

草稿样片成功响应示例

第二阶段：草稿转正片

请求示例

正片阶段关键说明

正片提交响应

任务状态说明

完整流程示例（Python）

计费说明

常见错误