curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{"model":"seedance-2-5","prompt":"映画的な製品クローズアップ。","duration":10,"aspect_ratio":"16:9","resolution":"720p","generate_audio":true}'
{
"model": "seedance-2-5",
"prompt": "動画1を後方に延長し、カメラを押し込みながら窓の外の街並みを見せる。",
"video_operation": "extend",
"duration": 11,
"aspect_ratio": "adaptive",
"output_format": "mov",
"video_with_roles": [{"url": "https://example.com/source.mov", "role": "reference_video"}]
}
{"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 動画生成
seedance-2-5 モデルで動画を生成する
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","prompt":"映画的な製品クローズアップ。","duration":10,"aspect_ratio":"16:9","resolution":"720p","generate_audio":true}'
{
"model": "seedance-2-5",
"prompt": "動画1を後方に延長し、カメラを押し込みながら窓の外の街並みを見せる。",
"video_operation": "extend",
"duration": 11,
"aspect_ratio": "adaptive",
"output_format": "mov",
"video_with_roles": [{"url": "https://example.com/source.mov", "role": "reference_video"}]
}
{"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、Volcengine の上流モデル ID は doubao-seedance-2-5-260628 です。
- テキストからの動画生成、先頭フレーム/先頭・末尾フレーム、動画編集、動画延長、マルチモーダル参照に対応します。
- 画像・動画・音声参照と音声のみの参照に対応します。
- 非同期タスクです。送信後に
generation.taskが返り、完成動画はタスク状態 API から取得します。
Authorizations
string
必須
すべてのリクエストで Bearer Token を使用します。API Key 管理 からキーを取得し、
Authorization: Bearer YOUR_API_KEY を設定してください。Body
string
デフォルト:"seedance-2-5"
必須
ToAPIs の公開モデル名。
seedance-2-5 を使用します。boolean
デフォルト:false
省略可能、既定値は
false。true にすると、選択されたチャネルの対応状況に応じて素材を準備して審査します。プライベート素材ライブラリ非対応のチャネルでは審査を省略し、従来の生成処理を行います。次のフィールドにメディアを含む非同期生成リクエストで使用できます：image_urls、image_with_roles、video_with_roles、audio_with_roles。テキストのみ、またはmetadataのみに素材を指定する場合は省略するか false にしてください。独立した remix または extend API には適用されません。true の場合は asset:// を拒否します。モデルのメディア形式と数量制限は変わりません。詳細はオンデマンド素材審査を参照してください。この API の video_operation=edit または video_operation=extend でも使用できます。各操作の素材と動画の長さに関する要件は引き続き適用されます。string
シーン、カメラワーク、被写体の動き、スタイル、音声の雰囲気を説明します。参照素材は「画像1」「動画1」「音声1」のように指定します。
string
デフォルト:"generate"
動画操作：
generate、edit、extend。編集と延長には video_with_roles が少なくとも 1 件必要で、編集は duration=-1、延長は 4–30 または -1 を使用します。3 つの操作は同じエンドポイントを使用します。string
注文番号や内部ジョブ ID。
GET /v1/videos/generations/{client_business_id} で後から検索できます。integer
出力動画の長さ（秒）。範囲は
4–30、-1 はモデルが自動で選択します。編集は -1 のみで、出力長は入力動画とほぼ同じになります。延長は 4–30 または -1 を使用し、延長後の出力全体の長さを指定します。string
21:9、16:9、4:3、1:1、3:4、9:16、adaptive。編集・延長・先頭/末尾フレームでは上流仕様に従い adaptive を使用します。string[]
互換用の画像 URL 配列。新規連携では用途を明示できる
image_with_roles を推奨します。両方は同時に送信できません。array
url と role を持つ画像配列。role は first_frame、last_frame、reference_image。最大 30 枚で、フレームモードと参照画像モードは併用できません。array
参照動画配列。role は
reference_video、最大 10 本です。array
参照音声配列。role は
reference_audio、最大 10 個です。音声のみの参照にも対応します。string
解像度：
480p、720p、または 1080p。string
デフォルト:"mp4"
mp4 と mov に対応します。boolean
デフォルト:true
同期音声を生成するかどうか。
boolean
デフォルト:false
完了結果に最後のフレーム画像を含めるかどうか。
array
使用できるツールは
[{ "type": "web_search" }]。テキストのみの動画生成で利用でき、メディア入力とは併用できません。string
ToAPIs タスク完了コールバック。タスク Webhook を参照してください。
string
呼び出し側のトレース ID。
参照素材の制限
合計 50 個まで（画像 30、動画 10、音声 10）です。明示的な role を使ってください。不正な組み合わせは失敗します。編集と延長では上流のタスク種別を明示するため、制限に合わない場合は送信時に即座にエラーが返ります。それ以外は素材とプロンプトからタスク種別を判断し、制限に合わない場合は非同期で
InvalidParameter.TaskTypeConstraint が返ります。編集・延長・先頭/末尾フレームでは aspect_ratio=adaptive を指定してください。Response
string
状態取得に使うタスク ID。
string
リクエストに指定した場合に返されます。
string
generation.task 固定。string
使用したモデル名。
string
queued、in_progress、completed、failed。integer
0–100 の進捗率。integer
作成時刻の Unix タイムスタンプ。
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{"model":"seedance-2-5","prompt":"映画的な製品クローズアップ。","duration":10,"aspect_ratio":"16:9","resolution":"720p","generate_audio":true}'
{
"model": "seedance-2-5",
"prompt": "動画1を後方に延長し、カメラを押し込みながら窓の外の街並みを見せる。",
"video_operation": "extend",
"duration": 11,
"aspect_ratio": "adaptive",
"output_format": "mov",
"video_with_roles": [{"url": "https://example.com/source.mov", "role": "reference_video"}]
}
{"id":"tsk_vid_xxx","object":"generation.task","model":"seedance-2-5","status":"in_progress","progress":10,"created_at":1781577600}