> ## 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 動画生成
> seedance-2-5 モデルで動画を生成する
Seedance 2.5 の公開モデル名は `seedance-2-5`、Volcengine の上流モデル ID は `doubao-seedance-2-5-260628` です。
* テキストからの動画生成、先頭フレーム/先頭・末尾フレーム、動画編集、動画延長、マルチモーダル参照に対応します。
* 画像・動画・音声参照と音声のみの参照に対応します。
* 非同期タスクです。送信後に `generation.task` が返り、完成動画はタスク状態 API から取得します。
## Authorizations
すべてのリクエストで Bearer Token を使用します。[API Key 管理](https://toapis.com/console/token) からキーを取得し、`Authorization: Bearer YOUR_API_KEY` を設定してください。
## Body
ToAPIs の公開モデル名。`seedance-2-5` を使用します。
シーン、カメラワーク、被写体の動き、スタイル、音声の雰囲気を説明します。参照素材は「画像1」「動画1」「音声1」のように指定します。
動画操作：`generate`、`edit`、`extend`。編集と延長には `video_with_roles` が少なくとも 1 件必要で、延長には正の `duration` が必要です。3 つの操作は同じエンドポイントを使用します。
注文番号や内部ジョブ ID。`GET /v1/videos/generations/{client_business_id}` で後から検索できます。
秒単位の長さ。公式範囲は `4`–`30`、`-1` は自動長です。編集・延長・上流が指定する先頭/末尾フレームでは `-1` を使用します。
`21:9`、`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`adaptive`。編集・延長・先頭/末尾フレームでは上流仕様に従い `adaptive` を使用します。
互換用の画像 URL 配列。新規連携では用途を明示できる `image_with_roles` を推奨します。両方は同時に送信できません。
`url` と `role` を持つ画像配列。role は `first_frame`、`last_frame`、`reference_image`。最大 30 枚で、フレームモードと参照画像モードは併用できません。
参照動画配列。role は `reference_video`、最大 10 本です。
参照音声配列。role は `reference_audio`、最大 10 個です。音声のみの参照にも対応します。
解像度：`480p` または `720p`。
`mp4` と `mov` に対応します。
同期音声を生成するかどうか。
完了結果に最後のフレーム画像を含めるかどうか。
使用できるツールは `[{ "type": "web_search" }]`。テキストのみの動画生成で利用でき、メディア入力とは併用できません。
ToAPIs タスク完了コールバック。[タスク Webhook](/docs/ja/api-reference/webhooks/task-webhooks) を参照してください。
呼び出し側のトレース ID。
## 参照素材の制限
合計 50 個まで（画像 30、動画 10、音声 10）です。明示的な role を使ってください。
不正な組み合わせは非同期処理中に `InvalidParameter.TaskTypeConstraint` で失敗することがあります。編集・延長・先頭/末尾フレームでは `aspect_ratio=adaptive` を指定してください。
## Response
状態取得に使うタスク ID。
リクエストに指定した場合に返されます。
`generation.task` 固定。
使用したモデル名。
`queued`、`in_progress`、`completed`、`failed`。
`0`–`100` の進捗率。
作成時刻の Unix タイムスタンプ。
```bash cURL theme={null}
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data '{"model":"seedance-2-5","prompt":"映画的な製品クローズアップ。","duration":10,"aspect_ratio":"16:9","resolution":"720p","generate_audio":true}'
```
```json 200 theme={null}
{"id":"tsk_vid_xxx","object":"generation.task","model":"seedance-2-5","status":"in_progress","progress":10,"created_at":1781577600}
```