Seedance 2.5 Draft 样片生成指南
先生成 480p 样片确认效果，再通过 Draft 任务 ID 生成 1080p 正式视频。
Draft 样片模式适合先确认场景、运镜和主体动作，再生成正式视频。整个流程使用现有创建、查询接口：先创建一份 480p 样片，确认效果后引用样片任务 ID，再创建一份 1080p 正式视频。
调用流程
选择一种格式完成以下四步。请将 MODEL_ID 替换为当前 API Key 可用的 Seedance 2.5 模型，并将 Key 与任务 ID 占位符替换为自己的值。两次创建须使用同一模型和账户。
创建 Draft 样片
通过平台创建接口传入提示词或参考素材，设置 draft: true 和 resolution: "480p"。保存返回的 task_id（与 id 含义一致），记为 PLATFORM_DRAFT_TASK_ID，用于查询样片。
curl 'https://api.agtcloud.cn/v1/video/generations' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"model": "MODEL_ID",
"content": [
{"type": "text", "text": "一只白色小兔子乘着纸飞机穿过云层，镜头平稳推进"}
],
"draft": true,
"resolution": "480p",
"duration": 5,
"ratio": "16:9"
}'查询并确认样片
使用平台任务 ID 查询，并通过 raw=true 读取原生任务。status 为 queued/running 时等待后再次查询；成功后打开 content.video_url 预览，将原生响应的 id 保存为 DRAFT_TASK_ID。
curl 'https://api.agtcloud.cn/v1/video/generations/PLATFORM_DRAFT_TASK_ID?raw=true' \
-H 'Authorization: Bearer your-api-key'第二阶段使用的是原生样片 ID DRAFT_TASK_ID，不要把平台查询用的 ID 直接混作原生样片 ID。任务失败、取消或过期时停止轮询，读取错误信息；只有 succeeded 的样片才能继续。
基于样片创建正式视频
确认样片符合预期后，使用相同 MODEL_ID，通过 content.draft_task.id 引用原生样片 ID。分辨率必须为 1080p，不重复传入样片的提示词、素材、时长等自动继承参数。
curl 'https://api.agtcloud.cn/v1/video/generations' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"model": "MODEL_ID",
"content": [
{"type": "draft_task", "draft_task": {"id": "DRAFT_TASK_ID"}}
],
"resolution": "1080p"
}'保存本次返回的新平台任务 ID，记为 PLATFORM_FINAL_TASK_ID。它与样片任务 ID 是两份不同任务的标识。
查询并保存正式视频
使用新任务 ID 查询；成功后，从原生响应的 content.video_url 下载正式视频。draft 为 false，draft_task_id 关联本次使用的样片。
curl 'https://api.agtcloud.cn/v1/video/generations/PLATFORM_FINAL_TASK_ID?raw=true' \
-H 'Authorization: Bearer your-api-key'如果使用默认平台包装而不传 raw=true，请按平台格式查询接口读取 data.status 和结果地址；不要直接套用原生响应的字段路径。
正式生成时的参数规则
| 参数类别 | 字段 | 正式生成时的处理 |
|---|---|---|
| 固定要求 | model、content.draft_task.id、resolution、draft | 使用相同模型和已成功的原生样片 ID；分辨率为 1080p；draft 省略或为 false |
| 自动继承 | 提示词、图片/视频/音频素材、duration、ratio、seed、generate_audio、omni_reference_task_type | 不要重复传入，即使值与样片阶段相同也会报错 |
| 可以重新设置 | return_last_frame、output_format、watermark、service_tier、execution_expires_after、priority、callback_url、safety_identifier | 按正式视频需求设置；省略时使用本次请求的默认值，不保证沿用样片配置 |
有效期与计费
- Draft 任务 ID 自
created_at起七天有效，过期后不能再用于生成正式视频。 - 样片和正式视频是两次生成任务，分别计费。样片按 480p 生成计费，正式视频按目标分辨率及输入条件计费。
- 结果视频地址有效期为 24 小时，最多下载 100 次，请及时下载或转存。
- 本指南适用于 Seedance 2.5，不适用于 Seedance 2.0。