seedance-2.5 样片模式 | ToAPIs Documentation

POST

/v1/videos/generations

国内用户请注意： 中国大陆用户请使用 https://toapis.cn 作为接口地址（Base URL）。文档示例中的 https://toapis.com 请替换为 https://toapis.cn。

样片模式把一次生成拆成两个阶段：先按较低成本生成 480p 样片，确认运镜和画面后，再用该样片生成 1080p 成稿。成稿由上游复用样片的提示词和素材，因此第二阶段不需要重复提交这些内容。

两个阶段都调用 POST /v1/videos/generations，并使用同一个 seedance-2-5 模型。

两阶段流程

提交样片请求，带上 draft: true，从响应中拿到样片任务 ID。
等待样片完成，通过获取视频任务状态确认 status 为 completed。
提交成稿请求，带上 draft_task_id 并填入第 1 步的样片任务 ID，不要重复传提示词或素材。

阶段对照

项目	样片（`draft: true`）	成稿（`draft_task_id`）
支持的模型	仅 `seedance-2-5`	仅 `seedance-2-5`
`resolution`	固定 `480p`	固定 `1080p`
`output_format`	`mp4`	`mp4` 或 `mov`
提示词与素材	与普通生成一致	不接受，必须省略
样片任务状态要求	-	必须已成功完成
样片任务有效期	-	自样片创建起 7 天内
计费	按 480p 档费率结算	按 1080p 档费率结算；单价取决于样片请求是否包含输入视频

成稿必须与样片使用相同的 model，且样片所在渠道的样片能力仍然可用。样片任务未成功完成、创建已超过 7 天、模型不一致或渠道能力已关闭时，成稿会以 invalid_draft_task 失败，需要重新生成样片。

Body

draftboolean请求体默认值: false

设为 true 提交样片请求。样片按 480p 生成，其余参数与普通生成一致。

仅支持 seedance-2-5；用于其他模型时返回 draft mode is only supported for Seedance 2.5。

draft_task_idstring请求体

成稿请求必填，填入样片请求返回的任务 ID（tsk_vid_...）。

不能与 draft: true 同时使用。传入 draft_task_id 后不得再传 prompt、image_urls、image_with_roles、video_with_roles 或 audio_with_roles，否则返回 draft requests cannot include prompt or media。

resolutionstring请求体

样片固定 480p，成稿固定 1080p。可以省略，省略时按对应阶段的固定值生成；显式传入其他值会被拒绝。

output_formatstring请求体默认值: mp4

仅成稿请求可指定，支持 mp4 和 mov。

return_last_frameboolean请求体默认值: false

成稿不会自动继承样片的尾帧设置。成稿也需要返回尾帧时，请在成稿请求中重新传入 true。

prompt、duration、aspect_ratio、generate_audio、参考素材等其余参数在样片阶段的使用方式与普通生成一致，详见Seedance 2.5 视频生成。

请求示例

下面两个示例分别是提交样片和用样片生成成稿的完整请求，可以依次执行。

请求示例

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2-5",
    "draft": true,
    "prompt": "电影感产品特写，镜头缓慢推进，保留自然室内声音。",
    "duration": 4,
    "resolution": "480p",
    "return_last_frame": true
  }'

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2-5",
    "draft_task_id": "tsk_vid_xxx",
    "resolution": "1080p",
    "output_format": "mp4",
    "return_last_frame": true
  }'

响应示例

{
  "id": "tsk_vid_xxx",
  "object": "generation.task",
  "model": "seedance-2-5",
  "status": "in_progress",
  "progress": 10,
  "created_at": 1781577600
}

计费

样片和成稿分别计费，各自在任务完成时按上游实际 token 用量结算。样片按 480p 档费率结算；成稿按 1080p 档费率结算，其 token 单价取决于样片请求是否包含输入视频：样片请求带了参考视频时，成稿按含视频输入单价结算，输入视频时长按样片的原始输入视频计算，样片视频本身不计入；样片请求没有输入视频时，成稿按不含视频输入单价结算。实际扣费以任务结果和价格与实际费用为准。