> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toapis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# seedance-2.5 样片模式

> 先用低成本样片确认效果，再用样片任务生成 1080p 成稿

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

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

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

## 两阶段流程

1. 提交样片请求，带上 `draft: true`，从响应中拿到样片任务 ID。
2. 等待样片完成，通过[获取视频任务状态](https://docs.toapis.com/docs/cn/api-reference/tasks/video-status.md)确认 `status` 为 `completed`。
3. 提交成稿请求，带上 `draft_task_id` 并填入第 1 步的样片任务 ID，不要重复传提示词或素材。

## 阶段对照

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

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

## Body

**draft** `boolean` (default: false)

设为 `true` 提交样片请求。样片按 `480p` 生成，其余参数与[普通生成](https://docs.toapis.com/docs/cn/api-reference/videos/seedance-2-5/generation.md)一致。

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

**draft\_task\_id** `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`。

**resolution** `string`

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

**output\_format** `string` (default: mp4)

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

**return\_last\_frame** `boolean` (default: false)

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

`prompt`、`duration`、`aspect_ratio`、`generate_audio`、参考素材等其余参数在样片阶段的使用方式与普通生成一致，详见[Seedance 2.5 视频生成](https://docs.toapis.com/docs/cn/api-reference/videos/seedance-2-5/generation.md)。

## 请求示例

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

```bash cURL（提交样片） theme={null}
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
  }'
```

```bash cURL（用样片生成成稿） theme={null}
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
  }'
```

```json 200 theme={null}
{
  "id": "tsk_vid_xxx",
  "object": "generation.task",
  "model": "seedance-2-5",
  "status": "in_progress",
  "progress": 10,
  "created_at": 1781577600
}
```

## 计费

样片和成稿分别计费，各自在任务完成时按上游实际 token 用量结算。样片按 480p 档费率结算；成稿按 1080p 档费率结算，其 token 单价取决于样片请求是否包含输入视频：样片请求带了参考视频时，成稿按含视频输入单价结算，输入视频时长按样片的原始输入视频计算，样片视频本身不计入；样片请求没有输入视频时，成稿按不含视频输入单价结算。实际扣费以任务结果和[价格与实际费用](https://docs.toapis.com/docs/cn/api-reference/account/pricing.md)为准。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.