ToAPIsToAPIs
seedance-2-5

Seedance 2.5 flash 動画生成

seedance-2-5-flash モデルで動画を生成する

POST
/v1/videos/generations

中国本土のユーザー向け: 中国本土のユーザーは 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-flash
ToAPIs の公開モデル名。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ボディデフォルト: mp4
mp4 と 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
リクエストに指定した場合に返されます。
objectstring
generation.task 固定。
modelstring
使用したモデル名。
statusstring
queued、in_progress、completed、failed。
progressinteger
0–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}