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
}
seedance-2-5
seedance-2.5 样片模式
先用低成本样片确认效果,再用样片任务生成 1080p 成稿
POST
/
v1
/
videos
/
generations
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
}
国内用户请注意: 中国大陆用户请使用
https://toapis.cn 作为接口地址(Base URL)。文档示例中的 https://toapis.com 请替换为 https://toapis.cn。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 天内 |
| 计费 | 按样片价结算 | 把样片作为视频输入,按含视频输入的费率结算 |
成稿必须与样片使用相同的
model,且样片所在渠道的样片能力仍然可用。样片任务未成功完成、创建已超过 7 天、模型不一致或渠道能力已关闭时,成稿会以 invalid_draft_task 失败,需要重新生成样片。Body
boolean
默认值:false
设为
true 提交样片请求。样片按 480p 生成,其余参数与普通生成一致。仅支持 seedance-2-5;用于其他模型时返回 draft mode is only supported for Seedance 2.5。string
成稿请求必填,填入样片请求返回的任务 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。string
样片固定
480p,成稿固定 1080p。可以省略,省略时按对应阶段的固定值生成;显式传入其他值会被拒绝。string
默认值:"mp4"
仅成稿请求可指定,支持
mp4 和 mov。boolean
默认值: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
}