Seedance 2.5 · 動画生成

エンドポイント	メソッド	パス
タスク送信	POST	/v1/videos/generations
結果照会	GET	/v1/videos/generations/{id}

リクエストパラメータ

Authorization

Header に Authorization を追加し、値は Bearer の後に API キーを続けます。

Authorization: Bearer ****************

Header パラメータ

Content-Typestring任意

application/json

Acceptstring任意

application/json

Body パラメータapplication/json必須

modelstring必須

モデル ID。`dreamina-seedance-2.5` に固定

contentarray[object]必須

BytePlus ネイティブ入力配列（推奨メイン用法）、下記 5 種類の type を組み合わせて使用。role は type と同じ階層（content item の外側）に置き、image_url/video_url の子オブジェクト内には入れないこと。role の値：画像 first_frame/last_frame/reference_image；動画 reference_video。

callback_urlstring任意

タスク状態変更時のコールバック通知先（任意）

return_last_frameboolean任意

動画の最終フレーム画像を返すか（既定 false）

resolutionstring任意

480p / 720p / 1080p / 4k動画解像度（既定 720p；4k は Seedance 2.0 のみ）

ratiostring任意

16:9 / 4:3 / 1:1 / 9:16 / 21:9 / adaptive生成動画のアスペクト比（既定 adaptive）

durationinteger任意

動画の長さ（秒）、既定 5

seedinteger任意

乱数シード、既定 -1（ランダム）；範囲 [-1, 2^32-1]

camera_fixedboolean任意

カメラを固定するか（既定 false）

watermarkboolean任意

透かしを追加するか（既定 false）

service_tierstring任意

default / flexサービス階層：default（オンライン推論）/ flex（オフライン、半額；Seedance 2.0 系列は非対応）

execution_expires_afterinteger任意

タスクのタイムアウト（秒）、created_at 起算；既定 172800（48h）、範囲 [3600, 259200]

generate_audioboolean任意

出力に同期音声を含めるか（既定 true；Seedance 2.0 系列 / 1.5 Pro のみ）

draftboolean任意

下書きモードを有効化（既定 false；Seedance 1.5 Pro のみ；下書きは 480p 固定）

safety_identifierstring任意

プラットフォームのリスク検知用のエンドユーザー一意識別子

例

{
  "model": "dreamina-seedance-2.5",
  "content": [
    {
      "type": "text",
      "text": "岩に打ち寄せる波のスローモーション、夕暮れの暖色トーン"
    }
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "seed": 11,
  "camera_fixed": false,
  "watermark": false
}

{  "model": "dreamina-seedance-2.5",  "content": [    {      "type": "text",      "text": "岩に打ち寄せる波のスローモーション、夕暮れの暖色トーン"    }  ],  "resolution": "720p",  "ratio": "16:9",  "duration": 5,  "seed": 11,  "camera_fixed": false,  "watermark": false}

リクエストコード例

curl https://api.hotrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2.5",
    "content": [
      {
        "type": "text",
        "text": "岩に打ち寄せる波のスローモーション、夕暮れの暖色トーン"
      }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "seed": 11,
    "camera_fixed": false,
    "watermark": false
  }'

curl https://api.hotrouter.ai/v1/videos/generations \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "dreamina-seedance-2.5",    "content": [      {        "type": "text",        "text": "岩に打ち寄せる波のスローモーション、夕暮れの暖色トーン"      }    ],    "resolution": "720p",    "ratio": "16:9",    "duration": 5,    "seed": 11,    "camera_fixed": false,    "watermark": false  }'

レスポンス

タスク送信

{
  "id": "cgt-xxxxxxxx",
  "status": "queued"
}

{  "id": "cgt-xxxxxxxx",  "status": "queued"}

結果照会

{
  "id": "cgt-xxxxxxxx",
  "status": "succeeded",
  "content": {
    "video_url": "https://.../video.mp4"
  },
  "usage": {
    "completion_tokens": 0
  }
}

{  "id": "cgt-xxxxxxxx",  "status": "succeeded",  "content": {    "video_url": "https://.../video.mp4"  },  "usage": {    "completion_tokens": 0  }}

Seedance 2.5 · 動画生成

リクエストパラメータ

リクエストコード例

レスポンス

On this page