Seedance 2.5

POST https://api.beatapi.io/v1/videos/tasks

テキスト、開始・終了フレーム、またはより多くのマルチモーダル参照素材から、4～30 秒の動画を生成します。480p・720p・1080p に対応しています。

対応する生成モード

開始・終了フレーム： images に開始フレーム、または開始・終了フレームを指定すると、動画は最初の画像のアスペクト比を引き継ぎます。aspect_ratio は適用されません。

参照動画： reference_videos は実際の長さに対して、出力動画と同じ秒単価で課金されます。タスク作成時に長さを読み取り、その分の料金が仮確保されます。読み取れない場合は上限の長さで仮確保し、タスク完了時に未使用分を返還します。参照動画を含むリクエストには、出力 1 秒あたりの最低料金があります。480p は $0.15、720p は$0.405、1080p は $0.825 です。出力と参照動画の長さに基づく合計額と、出力秒数に上記の最低秒単価を掛けた額を比較し、高い方が適用されます。

動画の編集： Seedance 2.5 はプロンプトから、reference_videos の動画を編集するのか（例：「動画内の商品を別の商品に置き換える」「ジャケットを赤くする」）、それを参照して新しい動画を生成するのかを判断します。編集では、指定した duration や aspect_ratio ではなく、元動画の長さとアスペクト比を引き継ぐ場合があります。元動画の長さは 4～30 秒にしてください。実際に生成された長さと参照動画に対して課金されます。実際の課金対象の長さは、完了したタスクの usage.billable_duration_seconds で確認できます。

非同期処理の流れ： タスクを作成して data.id を保存し、GET /v1/tasks/{task_id} でステータスをポーリングします。succeeded の場合は data.output.media から結果を取得します。failed の場合は data.error_code と data.error_message を確認し、エラーと再試行の方針に従って対処してください。

ローカルファイルを使う場合： 先に入力ファイルをアップロードし、返された data.url を指定してください。

認証

Authorization   string   必須

BeatAPI の API キーを Bearer トークンとして送信します。API キーはダッシュボードで作成できます。

Authorization: Bearer <BEATAPI_API_KEY>

通常の API キーは、信頼できるサーバーで管理してください。リクエストボディには Content-Type: application/json が必要です。対応するエンドポイントでは Idempotency-Key は任意ですが、同一のリクエストボディで安全に再試行するために指定を推奨します。

リクエストボディ

model   string   必須

seedance-2.5 を指定してください。

固定値: seedance-2.5

prompt   string   必須

動画生成の指示です。

文字数: 1 – 5000 文字

images   string[]   任意

開始フレーム 1 枚、または開始・終了フレームの画像を公開 HTTPS URL で指定します。

要素数: 1 – 2 件

reference_images   string[]   任意

マルチモーダル生成で参照する、公開 HTTPS 画像 URL です。

要素数: 1 – 30 件

reference_videos   string[]   任意

マルチモーダル生成で参照する、公開 HTTPS 動画 URL です。

要素数: 1 – 10 件

reference_audios   string[]   任意

公開 HTTPS 音声 URL です。音声だけを参照する生成にも対応しています。

要素数: 1 – 10 件

duration   integer   任意

出力動画の長さを秒単位で指定します。

デフォルト値: 5
範囲: 4 – 30

aspect_ratio   enum<string>   任意

出力動画のアスペクト比です。

選択肢: adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16
デフォルト値: "adaptive"

resolution   enum<string>   任意

出力解像度の区分です。480p と 1080p にはそれぞれ別の料金が適用されます。料金ページを確認してください。

選択肢: 480p, 720p, 1080p
デフォルト値: "720p"

generate_audio   boolean   任意

動画と同期した音声を生成します。

デフォルト値: true

seed   integer   任意

再現性のための seed です。ランダムな seed を使う場合は -1 を指定します。

デフォルト値: -1
範囲: -1 – 4294967295

リクエスト例

テキストから動画を生成

curl --request POST \
  --url https://api.beatapi.io/v1/videos/tasks \
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "seedance-2.5",
  "prompt": "A cinematic tracking shot through a rain-lit night market.",
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "generate_audio": true,
  "seed": -1
}'

開始フレームを指定

curl --request POST \
  --url https://api.beatapi.io/v1/videos/tasks \
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "seedance-2.5",
  "prompt": "Animate the performer with a dramatic push-in and synchronized ambient sound.",
  "images": [
    "https://media.beatapi.io/samples/neon-singer.png"
  ],
  "duration": 5,
  "resolution": "720p",
  "generate_audio": true,
  "seed": -1
}'

画像・動画・音声を参照

curl --request POST \
  --url https://api.beatapi.io/v1/videos/tasks \
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "seedance-2.5",
  "prompt": "Build a coherent performance from the supplied visual and audio references.",
  "reference_images": [
    "https://media.beatapi.io/samples/neon-singer.png"
  ],
  "reference_audios": [
    "https://media.beatapi.io/samples/neon-singer-preview.mp3"
  ],
  "duration": 8,
  "resolution": "720p",
  "generate_audio": true,
  "seed": -1
}'

レスポンス

リクエストが成功すると、HTTP 201 が返されます。

{
  "data": {
    "id": "task_8K2qA",
    "object": "task",
    "task_kind": "video",
    "capability_id": "seedance-2.5",
    "capability_version": null,
    "media_type": "video",
    "model": "seedance-2.5",
    "status": "queued",
    "stage": "queued",
    "created_at": 1782210000,
    "updated_at": 1782210000,
    "completed_at": null,
    "output": null,
    "usage": {
      "credits_reserved": 1.35,
      "credits_charged": 1.35,
      "billable_duration_seconds": 5,
      "credits_settled": 0,
      "credits_refunded": 0
    },
    "request_id": "req_abc123",
    "error_code": null,
    "error_message": null
  }
}

エラー