> ## 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`。
</Note>

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

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

## 两阶段流程

1. 提交样片请求，带上 `draft: true`，从响应中拿到样片任务 ID。
2. 等待样片完成，通过[获取视频任务状态](/docs/cn/api-reference/tasks/video-status)确认 `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` |
| 提示词与素材 | 与[普通生成](./generation)一致 | 不接受，必须省略 |
| 样片任务状态要求 | - | 必须已成功完成 |
| 样片任务有效期 | - | 自样片创建起 7 天内 |
| 计费 | 按样片价结算 | 把样片作为视频输入，按含视频输入的费率结算 |

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

## Body

<ParamField body="draft" type="boolean" default={false}>
  设为 `true` 提交样片请求。样片按 `480p` 生成，其余参数与[普通生成](./generation)一致。

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

<ParamField body="draft_task_id" type="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`。
</ParamField>

<ParamField body="resolution" type="string">
  样片固定 `480p`，成稿固定 `1080p`。可以省略，省略时按对应阶段的固定值生成；显式传入其他值会被拒绝。
</ParamField>

<ParamField body="output_format" type="string" default="mp4">
  仅成稿请求可指定，支持 `mp4` 和 `mov`。
</ParamField>

<ParamField body="return_last_frame" type="boolean" default={false}>
  成稿不会自动继承样片的尾帧设置。成稿也需要返回尾帧时，请在成稿请求中重新传入 `true`。
</ParamField>

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

## 请求示例

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

<RequestExample>
  ```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
    }'
  ```
</RequestExample>

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

## 计费

样片和成稿分别计费，各自在任务完成时结算。样片按样片价结算；成稿把样片视频作为视频输入，按含视频输入的费率结算，因此单价高于样片。实际扣费以任务结果和[价格与实际费用](/docs/cn/api-reference/account/pricing)为准。


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