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
}'
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
}'
{
"id": "tsk_vid_xxx",
"object": "generation.task",
"model": "seedance-2-5",
"status": "in_progress",
"progress": 10,
"created_at": 1781577600
}
seedance-2-5
Seedance 2.5 ドラフトモード
低コストの 480p ドラフトで確認し、そのドラフトから 1080p の本番動画を生成する
POST
/
v1
/
videos
/
generations
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
}'
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
}'
{
"id": "tsk_vid_xxx",
"object": "generation.task",
"model": "seedance-2-5",
"status": "in_progress",
"progress": 10,
"created_at": 1781577600
}
中国本土のユーザー向け： 中国本土のユーザーは
https://toapis.cn を API エンドポイント（Base URL）としてご利用ください。本ドキュメント内の例では https://toapis.com を https://toapis.cn に置き換えてください。seedance-2-5 モデルで POST /v1/videos/generations を呼び出します。
2 段階の流れ
draft: trueを付けてドラフトを送信し、応答からドラフトのタスク ID を取得します。- ドラフトの完了を待ち、動画タスクの状態取得で
statusがcompletedであることを確認します。 draft_task_idに手順 1 のタスク ID を指定して本番リクエストを送信します。プロンプトと素材は再送しないでください。
段階ごとの比較
| 項目 | ドラフト（draft: true） | 本番（draft_task_id） |
|---|---|---|
| 対応モデル | seedance-2-5 のみ | seedance-2-5 のみ |
resolution | 常に 480p | 常に 1080p |
output_format | mp4 | mp4 または mov |
| プロンプトと素材 | 通常の生成と同じ | 受け付けないため省略必須 |
| ドラフトの状態 | - | 正常に完了していること |
| ドラフトの有効期間 | - | 作成から 7 日以内 |
| 課金 | ドラフト料金 | ドラフトを動画入力として扱い、動画入力ありの料金 |
本番リクエストはドラフトと同じ
model を使い、ドラフトのチャネルでドラフト機能が有効である必要があります。ドラフトが正常に完了していない、作成から 7 日を超えている、モデルが一致しない、またはチャネルの機能が無効になっている場合、本番リクエストは invalid_draft_task で失敗し、ドラフトの再生成が必要です。Body
boolean
デフォルト:false
true でドラフトを送信します。ドラフトは 480p で生成され、その他のパラメータは通常の生成と同じです。seedance-2-5 のみ対応します。他のモデルでは draft mode is only supported for Seedance 2.5 を返します。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 を返します。string
ドラフトは
480p、本番は 1080p に固定されます。省略可能で、省略した場合は各段階の固定値が使われます。それ以外の値を明示すると拒否されます。string
デフォルト:"mp4"
本番リクエストでのみ指定できます。
mp4 と mov に対応します。boolean
デフォルト:false
本番リクエストはドラフトのラストフレーム設定を引き継ぎません。本番でもラストフレームが必要な場合は、本番リクエストで改めて
true を指定してください。prompt、duration、aspect_ratio、generate_audio、参照素材など）は、ドラフト段階でもSeedance 2.5 の動画生成と同じように使用できます。
リクエスト例
以下の 2 つの例は、ドラフトの送信とそのドラフトからの本番生成の完全なリクエストです。順に実行してください。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
}'
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
}'
{
"id": "tsk_vid_xxx",
"object": "generation.task",
"model": "seedance-2-5",
"status": "in_progress",
"progress": 10,
"created_at": 1781577600
}