> ## 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 ドラフトモード

> 低コストの 480p ドラフトで確認し、そのドラフトから 1080p の本番動画を生成する

> [!NOTE]
>
> **中国本土のユーザー向け：** 中国本土のユーザーは `https://toapis.cn` を API エンドポイント（Base URL）としてご利用ください。本ドキュメント内の例では `https://toapis.com` を `https://toapis.cn` に置き換えてください。

ドラフトモードは 1 回の生成を 2 段階に分けます。まず低コストで 480p のドラフトを生成してカメラワークと構図を確認し、その後そのドラフトから 1080p の本番動画を生成します。本番生成では上流がドラフトのプロンプトと素材を再利用するため、2 段階目でこれらを再送する必要はありません。

どちらの段階も同じ `seedance-2-5` モデルで `POST /v1/videos/generations` を呼び出します。

## 2 段階の流れ

1. `draft: true` を付けてドラフトを送信し、応答からドラフトのタスク ID を取得します。
2. ドラフトの完了を待ち、[動画タスクの状態取得](https://docs.toapis.com/docs/ja/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/ja/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/ja/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/ja/api-reference/videos/seedance-2-5/generation.md)と同じように使用できます。

## リクエスト例

以下の 2 つの例は、ドラフトの送信とそのドラフトからの本番生成の完全なリクエストです。順に実行してください。

```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 料金で精算されます。本番の単価はドラフトリクエストに動画入力があったかで決まります。ドラフトに参照動画があった場合は動画入力ありの単価が適用され、入力動画の長さはドラフトの元の入力動画で計算されます（ドラフト動画自体は入力に含まれません）。ドラフトに動画入力がなかった場合は動画入力なしの単価が適用されます。実際の請求額はタスク結果と[料金と実際の費用](https://docs.toapis.com/docs/ja/api-reference/account/pricing.md)を基準とします。


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