seedance-2-5
Seedance 2.5 flash 動画生成
seedance-2-5-flash モデルで動画を生成する
中国本土のユーザー向け: 中国本土のユーザーは https://toapis.cn を API エンドポイント(Base URL)としてご利用ください。本ドキュメント内の例では https://toapis.com を https://toapis.cn に置き換えてください。
Seedance 2.5 flash は Seedance 2.5 の高速・低コスト版です。公開モデル名は seedance-2-5-flash です。
- テキストからの動画生成、先頭フレーム/先頭・末尾フレーム、動画編集、動画延長、マルチモーダル参照に対応します。
- 画像・動画・音声参照と音声のみの参照に対応します。
- 非同期タスクです。送信後に
generation.taskが返り、完成動画はタスク状態 API から取得します。
Seedance 2.5 と比べて、生成速度は約2倍で価格が低く、出力は 480p と 720p のみ、参照素材は合計20個(画像10、動画5、音声5)までで、ドラフトモードには対応していません。
Authorizations
Authorizationstringヘッダー必須すべてのリクエストで Bearer Token を使用します。API Key 管理 からキーを取得し、
Authorization: Bearer YOUR_API_KEY を設定してください。Body
modelstringボディ必須デフォルト: seedance-2-5-flashToAPIs の公開モデル名。
seedance-2-5-flash を使用します。promptstringボディシーン、カメラワーク、被写体の動き、スタイル、音声の雰囲気を説明します。参照素材は「画像1」「動画1」「音声1」のように指定します。
video_operationstringボディデフォルト: generate動画操作:
generate、edit、extend。編集と延長には video_with_roles が少なくとも 1 件必要で、編集は duration=-1、延長は 4–30 または -1 を使用します。3 つの操作は同じエンドポイントを使用します。client_business_idstringボディ注文番号や内部ジョブ ID。
GET /v1/videos/generations/{client_business_id} で後から検索できます。durationintegerボディ出力動画の長さ(秒)。範囲は
4–30、-1 はモデルが自動で選択します。編集は -1 のみで、出力長は入力動画とほぼ同じになります。延長は 4–30 または -1 を使用し、延長後の出力全体の長さを指定します。aspect_ratiostringボディ21:9、16:9、4:3、1:1、3:4、9:16、adaptive。編集・延長・先頭/末尾フレームでは上流仕様に従い adaptive を使用します。image_urlsstring[]ボディ互換用の画像 URL 配列。新規連携では用途を明示できる
image_with_roles を推奨します。両方は同時に送信できません。image_with_rolesarrayボディurl と role を持つ画像配列。role は first_frame、last_frame、reference_image。最大 10 枚で、フレームモードと参照画像モードは併用できません。video_with_rolesarrayボディ参照動画配列。role は
reference_video、最大 5 本です。audio_with_rolesarrayボディ参照音声配列。role は
reference_audio、最大 5 個です。音声のみの参照にも対応します。resolutionstringボディ解像度:
480p または 720p。Seedance 2.5 flash は 1080p と 4k に対応していません。output_formatstringボディデフォルト: mp4mp4 と mov に対応します。generate_audiobooleanボディデフォルト: true同期音声を生成するかどうか。
return_last_framebooleanボディデフォルト: false完了結果に最後のフレーム画像を含めるかどうか。
toolsarrayボディ使用できるツールは
[{ "type": "web_search" }]。テキストのみの動画生成で利用でき、メディア入力とは併用できません。callback_urlstringボディToAPIs タスク完了コールバック。タスク Webhook を参照してください。
trace_idstringボディ呼び出し側のトレース ID。
disable_nsfwbooleanボディデフォルト: trueデフォルトで NSFW コンテンツの生成は禁止されています。許可するには
false を設定してください。参照素材の制限
合計 20 個まで(画像 10、動画 5、音声 5)です。明示的な role を使ってください。
不正な組み合わせは失敗します。編集と延長では上流のタスク種別を明示するため、制限に合わない場合は送信時に即座にエラーが返ります。それ以外は素材とプロンプトからタスク種別を判断し、制限に合わない場合は非同期で
InvalidParameter.TaskTypeConstraint が返ります。編集・延長・先頭/末尾フレームでは aspect_ratio=adaptive を指定してください。素材審査
画像, 動画, 音声を含むリクエストでは, 一部のチャネルが生成の送信前に素材を自動で審査します. 追加のパラメーターは不要で, 従来のメディアフィールドに素材 URL を指定するだけです.
- 受理されたリクエストはすぐに動画タスクを返します. 審査が必要な場合, タスクは
queuedのままとなり, リクエスト内の全素材が通過してから生成を送信します. 初回の審査には数分かかることがあります. 同じユーザーが同じチャネルで同じ URL を再利用すると審査結果も再利用されます. - 素材準備は 1 ラウンドあたり既定で最長 20 分です. 審査拒否または準備タイムアウトの場合, タスクは
failedで終了し, 理由はerror.messageで確認できます. 審査を通過しなかった場合, 動画生成料金は発生しません. - 素材は公開 HTTP(S) URL で指定してください. Base64 とローカルパスは使えません. 画像は 30 MB 以内, 動画と音声は 100 MiB 以内です. 各モデル本来の形式制限は変わりません.
- 審査を行うチャネルは受理時に素材を検証します. URL に認証情報が含まれる, 2048 バイトを超える, 同じ URL を異なる種別で使う, 1 リクエストの素材参照が 64 個を超える場合は, HTTP 400 (
error.codeはinvalid_private_assets) を返します. - 素材は URL で識別されます. ファイル内容を変更した場合は新しい URL を使ってください.
- 旧
asset://参照は廃止され, HTTP 400 を返します.
完了結果は動画タスクの照会で取得します. 元の URL の配信が有効な場合は result.data[].url を優先し, アクセスできない場合のみ任意の fallback_url を使用します. 最終フレームは last_frame_url と fallback_last_frame_url に対応します. 代替フィールドはコピーが利用可能な場合のみ返されます.
Response
idstring状態取得に使うタスク ID。
client_business_idstringリクエストに指定した場合に返されます。
objectstringgeneration.task 固定。modelstring使用したモデル名。
statusstringqueued、in_progress、completed、failed。progressinteger0–100 の進捗率。created_atinteger作成時刻の 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-flash","prompt":"映画的な製品クローズアップ。","duration":10,"aspect_ratio":"16:9","resolution":"720p","generate_audio":true}'{
"model": "seedance-2-5-flash",
"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-flash","status":"in_progress","progress":10,"created_at":1781577600}