Seedance 2 Fast
テキスト、開始フレームと終了フレーム、または最大 9 枚の画像・3 本の動画・3 件の音声を参照として使い、Seedance 2.0 より低価格で、480p・720p の 4~15 秒の動画を生成します。
- 非同期です。作成の呼び出しはタスク ID を返し、動画はタスクが成功した時点で得られます(通常は数分です)。
- 入力方法は 4 通りです。テキストのみ、開始フレーム、開始フレームと終了フレーム、または参照画像・参照動画・参照音声の任意の組み合わせです(音声には、画像または動画を少なくとも 1 つ添える必要があります)。
- 480p と 720p のみに対応し、同じ解像度では Seedance 2.0 より低価格です。
- 音声はデフォルトで生成され(
generate_audio)、料金は変わりません。 - 料金は、動画のサイズと長さ、および参照動画の長さに応じて決まります。失敗したタスクには課金されません。
このモデルをテスト画面で開きます。BeatAPI の API キーを入力するとタスクを作成できます。実際に呼び出され、ご自身の残高から課金されます。
モデル ID
4 つの Seedance モデルが、このエンドポイントを共有します。以下の値はゲートウェイの仕様から直接取得したものです。task_type、output_format、seed を受け付けるのは Seedance 2.5 のみです。
エンドポイントと認証
POST https://api.beatapi.io/v1/videos/tasks
Authorization
string
必須
BeatAPI の API キーを Bearer <BEATAPI_API_KEY> の形式で送信します。キーはダッシュボードで作成できます。キーはサーバー側で保管し、ブラウザーやモバイルアプリに含めないでください。
ボディは JSON で送信し、Content-Type: application/json を指定します。Idempotency-Key は任意です。論理的に 1 件のリクエストごとに一意の値(255 文字以内)を送り、まったく同じボディを再試行するときだけ再利用してください。24 時間以内に同じキーと同じボディで再試行すると、最初のレスポンスが Idempotent-Replayed: true 付きで再度返されます。同じキーで異なるボディを送ると 409 idempotency_conflict が返ります。2xx 以外のレスポンスは保存されないため、400 や 402 の後の再試行は改めて実行されます。
リクエストの流れ
タスクを作成する
下記のパラメーターをエンドポイントに POST します。201 が返れば、タスクが受け付けられ、料金が残高から仮確保されたことを意味します。処理はバックグラウンドで実行されます。data.id を保存してください。
完了を待つ
GET /v1/tasks/{task_id} を呼び出し、status が succeeded または failed になるまで、呼び出しの間隔を data.poll_after_seconds(画像は 5 秒、動画は 8 秒)だけ空けてください。あるいは task.succeeded と task.failed のWebhookを登録することもできます。処理タイムアウトで停止したタスクはイベントを送信しないため、フォールバックとしてポーリングも続けてください。
入力モード
リクエストパラメーター
model
string
必須
実行するモデルです。
値:seedance-2-fast
値が正しくない場合
- 指定がない場合:
"model" is required - 画像モデルをこのエンドポイントに送った場合:
"model" nano-banana-2 is served by POST /v1/images/tasks, not this endpoint
prompt
string
必須
動画の中で起きること(被写体、動き、カメラワーク、スタイル、音)です。参照を使う場合は、各入力が何のためのものかを書いてください。
長さ:1–5000 文字
- 長さは文字数で数えます(CJK 文字も 1 文字として数えます)。
- 入力は位置で指し示します。たとえば「1 本目の参照画像」「2 本目の参照動画」のように書きます。
値が正しくない場合
- 指定がない場合:
"prompt" is required - 空、または上限を超える長さの場合:
"prompt" has an unsupported length
images
string[]
任意
開始フレーム、または開始フレームと終了フレームです。
要素数:1–2
各要素は公開されている https:// の URL です。ローカルファイルは先に アップロード(POST /v1/files)し、返された data.url を渡してください。
- リンクが 1 個の場合:動画はその画像から始まります。リンクが 2 個の場合:
images[0]が開始フレーム、images[1]が終了フレームです。 - より多くの画像を使う場合や、フレームではなく動画を導くための画像を使う場合は、代わりに
reference_imagesを使ってください。
値が正しくない場合
- リンクが 3 個以上の場合:
"images" accepts at most 2 items - いずれかの reference_* フィールドと併用した場合:
Cannot combine "images" with reference inputs in one task - https:// のリンクでない場合:
"images[0]" must be a public HTTPS URL
reference_images
string[]
任意
動画の内容、キャラクター、商品、スタイルを導くための画像です。
要素数:1–9
各要素は公開されている https:// の URL です。ローカルファイルは先に アップロード(POST /v1/files)し、返された data.url を渡してください。
- 画像はリストの順に使われます。プロンプトでは位置で指し示してください。
値が正しくない場合
- 最大数を超えた場合:
"reference_images" accepts at most 9 items imagesと併用した場合:Cannot combine "images" with reference inputs in one task
reference_videos
string[]
任意
動き、カメラワーク、内容の参考にする動画です。
要素数:1–3
各要素は公開されている https:// の URL です。ローカルファイルは先に アップロード(POST /v1/files)し、返された data.url を渡してください。
- 各リンクは、MP4 または MOV ファイルを返し、かつホストがバイトレンジリクエストに対応している必要があります。参照動画の秒数は課金対象のため、ゲートウェイはタスクを作成する前にすべてのクリップの長さを読み取ります。
- 各クリップは 1.8~15 秒で、すべてのクリップの合計は 15 秒までです。
参照動画は、再生される秒数ごとに料金に加算されます(課金を参照)。必要な部分だけに切り詰めてください。
値が正しくない場合
- 最大数を超えた場合:
"reference_videos" accepts at most 3 items - クリップを読み取れない場合:
A reference video could not be read: reference_videos[0]: its host does not allow byte-range requests. Send an MP4 or MOV file at a public HTTPS URL whose host allows byte-range requests.
reference_audios
string[]
任意
従わせたい音楽、音声、サウンドです。音声だけを参照にすることはできません。参照画像または参照動画を少なくとも 1 つ添えてください。
要素数:1–3
各要素は公開されている https:// の URL です。ローカルファイルは先に アップロード(POST /v1/files)し、返された data.url を渡してください。
- WAV と MP3 のクリップは下の上限に照らして長さなどが測定されます。それ以外の形式は、測定されずにモデルへそのまま渡されます。
値が正しくない場合
- 最大数を超えた場合:
"reference_audios" accepts at most 3 items - 参照画像も参照動画もなく音声だけを送った場合:
seedance-2-fast audio reference requires at least one reference image or video
duration
integer
任意デフォルト: 5
動画の長さを秒単位の整数で指定します。
デフォルト:5
範囲:4–15
- 省略すると
5が送られます。
値が正しくない場合
- 範囲外、または整数でない場合:
"duration" is outside its supported range
aspect_ratio
string
任意デフォルト: adaptive
動画の形を「幅:高さ」で指定します。adaptive を指定すると、モデルが入力から形を選びます。
指定できる値:adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16
デフォルト:adaptive
adaptiveを指定した場合、仮確保額は選択した解像度の最大のフレームを想定して計算されるため、アスペクト比を固定した場合よりもわずかに高くなることがあります。
値が正しくない場合
- 一覧にない値の場合:
"aspect_ratio" must be one of: [adaptive 21:9 16:9 4:3 1:1 3:4 9:16]
resolution
string
任意デフォルト: 720p
出力の解像度で、480p または 720p です。720p のほうが 1 秒あたりの料金が高くなります。
指定できる値:480p, 720p
デフォルト:720p
- 小文字のみ使えます。1080p と 4K はこのモデルでは使えません(
seedance-2を使ってください)。
値が正しくない場合
- 一覧にない値の場合(たとえば
1080pや720P):"resolution" must be one of: [480p 720p]
generate_audio
boolean
任意デフォルト: true
動画に生成されたサウンドトラックを付けるかどうかです。どちらでも料金は同じです。
デフォルト:true
値が正しくない場合
- true または false でない場合:
"generate_audio" must be a boolean
ゲートウェイはタスク作成前に、次の組み合わせも確認します。
imagesと参照メディアのフィールドは同時に使用できません。
入力メディアの上限
ゲートウェイはタスク作成前にすべての入力を読み取り、次の上限を超えるものは、その入力を示す 400 bad_request で拒否します。課金はされません。
- 参照動画は MP4 または MOV で、ホストがバイトレンジリクエストに応答する公開 HTTPS リンクである必要があります。長さを読み取れないクリップは、その秒数が課金対象のため、常に拒否されます。
- 画像のサイズは、ホストが報告する場合に確認されます。JPEG、PNG、WebP を使ってください。モデルが使えないファイルは、送信後にタスクが
bad_requestで失敗し、返金されます。 - 上限違反は、長さ、辺、アスペクト比、ピクセル数、フレームレート、サイズの順に報告されます。メッセージには、リスト名と位置で入力が示されます。位置はフィールドのエラーと同じく 0 から数えます。たとえば
reference_videos[0] is 1.5 seconds long; this model takes reference video of 1.8 to 15 seconds.のようになります。 - 長さは 0.1 秒の許容誤差で測定されます。サイズは、ホストが報告する場合にのみ確認されます。
- 画像と音声のリンクは、ホストが 4xx エラーを返した場合や空のファイルを返した場合にのみ、作成時に拒否されます。たとえば
images[1] could not be downloaded: the URL returned HTTP 404.のようになります。それ以外の問題は、送信後に表面化します。 - 23.976 FPS のクリップは 24 未満として扱われ、拒否されます。24 FPS 以上で書き出し直してください。
- ローカルファイルは
POST /v1/filesでアップロードし、返されたdata.urlを指定してください。
組み合わせのルール
これらはタスク作成時に、次の順で確認されます。いずれかに違反するリクエストは 400 bad_request で拒否され、課金されません。
このモデルが受け付けないフィールド
次のフィールドを送ると、無視されるのではなく、課金が発生する前に拒否されます。
- 他の動画モデルのフィールド(
seed、task_type、output_format(Seedance 2.5 のみ)、watermark、quality、sound、multi_shots、character_orientationなど) →field "seed" is not supported by model seedance-2-fast(実際に送ったフィールド名が入ります)。 - どの BeatAPI 動画モデルも使っていない名前 →
unknown field: <name>。
価格の見積もり
タスクの動画トークン数は N = W × H × (24 × D + 1 + 24 × R) / 1024 です。W × H は、選択した解像度とアスペクト比でのフレームのピクセル数(16:9 の 720p なら 1280 × 720、16:9 の 480p なら 864 × 496)、D は出力の長さ(秒)、R は参照動画の合計の長さ(秒、ない場合は 0)です。料金は N に動画トークン 100 万あたりの単価を掛けたもので、参照動画なしでは 480p が約 4.757、参照動画ありでは 480p が約 2.829 です。
たとえば、16:9・720p・5 秒で参照動画なしの場合は、1280 × 720 × 121 / 1024 = 108,900 トークンで、約 $0.518 です。参照動画の長さはゲートウェイが自分で測定するため、送信する必要はありません。参照クリップの長さはゲートウェイ自身が測定するため、これを含むボディは未知のフィールドとして拒否されます。これは見積もりです。タスクの usage に、仮確保額と実際の課金額が表示されます。
リクエスト例
テキストから動画
音声付きの、5 秒・720p の横長クリップです。
開始フレーム
動画はその画像から始まります。
開始フレームと終了フレーム
動画は 1 枚目の画像から 2 枚目の画像へ移っていきます。
画像と音声の参照
キャラクター画像と音楽クリップに従ったパフォーマンスです。
画像・動画・音声の参照
動画のリンクを、15 秒以下の自分の MP4 または MOV に置き換えてください。参照動画は 1 秒ごとに課金されます(「課金」を参照)。
レスポンス
タスクの作成(201)
タスクオブジェクトです。タスクが成功するまで output は null です。「実行中」と記載されたフィールドは、タスクの完了後に表示されなくなります。
完了したタスク
GET /v1/tasks/{task_id} は HTTP 200 と status: "succeeded" を返し、結果は data.output に入ります。
出力フィールド
失敗したタスク
失敗したタスクも、GET /v1/tasks/{task_id} では HTTP 200 になります。失敗はボディに示されます。仮確保された金額は全額戻されるため、課金されません。
完全なコード例
タスクを作成し、サーバーが示すポーリング間隔で完了を待ち、結果の URL を出力します。環境変数に BEATAPI_API_KEY を設定し、requests をインストールしてください。
課金
- 料金は、動画のサイズと長さに応じて決まります。秒数が長いほど、解像度が高いほど、フレームが大きいほど、料金は上がります。音声は料金に影響しません。参照画像と参照音声には、追加料金はかかりません。
- 参照動画がない場合、16:9 のクリップは 1 秒あたり約 0.103(720p)です。ほかのアスペクト比では数パーセント異なります。
reference_videosを使うと、リクエスト全体がより低い「動画入力あり」の料金になり、参照動画の 1 秒ごとに出力 1 秒と同じ扱いで加算されます。16:9 の場合、出力と参照を合わせた 1 秒あたり約 0.061(720p)です。- 下の表は 8 秒のクリップの料金です。「動画入力あり」の行には、8 秒の参照動画が含まれています。
- 料金はタスク作成時に仮確保されます。
adaptiveを使う場合、仮確保額はその解像度の最大のフレームを想定して計算されます。支払うのは仮確保額です。ただし、納品された動画の実際の金額がそれを上回る場合は、実際の金額になります。 - 失敗したタスクは、送信後にモデレーションで拒否されたものも含め、全額が返金されます。
現在の定価です。料金ページと同じ金額です。割引を個別に契約しているアカウントでは、より低い金額になります。実際に課金された金額は、タスクの data.usage で確認できます。
よくあるエラー
HTTP エラー早見表
タスクが作られる前のエラーは、2xx 以外のレスポンスで返されます。課金はされません。error.code または error.retryable で処理を分岐してください。message には問題の内容が示されます。全一覧と再試行のルールはエラーにあります。
認証
API キーを Authorization: Bearer <BEATAPI_API_KEY> として送信してください。
ヘッダー
ボディは JSON で送信し、Content-Type: application/json を指定します。Idempotency-Key は任意です。論理的に 1 件のリクエストごとに一意の値(255 文字以内)を送り、まったく同じボディを再試行するときだけ再利用してください。24 時間以内に同じキーと同じボディで再試行すると、最初のレスポンスが Idempotent-Replayed: true 付きで再度返されます。同じキーで異なるボディを送ると 409 idempotency_conflict が返ります。2xx 以外のレスポンスは保存されないため、400 や 402 の後の再試行は改めて実行されます。
リクエスト
実行するモデルです。
値:seedance-2-fast
値が正しくない場合
- 指定がない場合:
"model" is required - 画像モデルをこのエンドポイントに送った場合:
"model" nano-banana-2 is served by POST /v1/images/tasks, not this endpoint
動画の中で起きること(被写体、動き、カメラワーク、スタイル、音)です。参照を使う場合は、各入力が何のためのものかを書いてください。
長さ:1–5000 文字
- 長さは文字数で数えます(CJK 文字も 1 文字として数えます)。
- 入力は位置で指し示します。たとえば「1 本目の参照画像」「2 本目の参照動画」のように書きます。
値が正しくない場合
- 指定がない場合:
"prompt" is required - 空、または上限を超える長さの場合:
"prompt" has an unsupported length
動画の形を「幅:高さ」で指定します。adaptive を指定すると、モデルが入力から形を選びます。
指定できる値:adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16
デフォルト:adaptive
adaptiveを指定した場合、仮確保額は選択した解像度の最大のフレームを想定して計算されるため、アスペクト比を固定した場合よりもわずかに高くなることがあります。
値が正しくない場合
- 一覧にない値の場合:
"aspect_ratio" must be one of: [adaptive 21:9 16:9 4:3 1:1 3:4 9:16]
動画の長さを秒単位の整数で指定します。
デフォルト:5
範囲:4–15
- 省略すると
5が送られます。
値が正しくない場合
- 範囲外、または整数でない場合:
"duration" is outside its supported range
動画に生成されたサウンドトラックを付けるかどうかです。どちらでも料金は同じです。
デフォルト:true
値が正しくない場合
- true または false でない場合:
"generate_audio" must be a boolean
開始フレーム、または開始フレームと終了フレームです。
要素数:1–2
各要素は公開されている https:// の URL です。ローカルファイルは先に アップロード(POST /v1/files)し、返された data.url を渡してください。
- リンクが 1 個の場合:動画はその画像から始まります。リンクが 2 個の場合:
images[0]が開始フレーム、images[1]が終了フレームです。 - より多くの画像を使う場合や、フレームではなく動画を導くための画像を使う場合は、代わりに
reference_imagesを使ってください。
値が正しくない場合
- リンクが 3 個以上の場合:
"images" accepts at most 2 items - いずれかの reference_* フィールドと併用した場合:
Cannot combine "images" with reference inputs in one task - https:// のリンクでない場合:
"images[0]" must be a public HTTPS URL
従わせたい音楽、音声、サウンドです。音声だけを参照にすることはできません。参照画像または参照動画を少なくとも 1 つ添えてください。
要素数:1–3
各要素は公開されている https:// の URL です。ローカルファイルは先に アップロード(POST /v1/files)し、返された data.url を渡してください。
- WAV と MP3 のクリップは下の上限に照らして長さなどが測定されます。それ以外の形式は、測定されずにモデルへそのまま渡されます。
値が正しくない場合
- 最大数を超えた場合:
"reference_audios" accepts at most 3 items - 参照画像も参照動画もなく音声だけを送った場合:
seedance-2-fast audio reference requires at least one reference image or video
動画の内容、キャラクター、商品、スタイルを導くための画像です。
要素数:1–9
各要素は公開されている https:// の URL です。ローカルファイルは先に アップロード(POST /v1/files)し、返された data.url を渡してください。
- 画像はリストの順に使われます。プロンプトでは位置で指し示してください。
値が正しくない場合
- 最大数を超えた場合:
"reference_images" accepts at most 9 items imagesと併用した場合:Cannot combine "images" with reference inputs in one task
動き、カメラワーク、内容の参考にする動画です。
要素数:1–3
各要素は公開されている https:// の URL です。ローカルファイルは先に アップロード(POST /v1/files)し、返された data.url を渡してください。
- 各リンクは、MP4 または MOV ファイルを返し、かつホストがバイトレンジリクエストに対応している必要があります。参照動画の秒数は課金対象のため、ゲートウェイはタスクを作成する前にすべてのクリップの長さを読み取ります。
- 各クリップは 1.8~15 秒で、すべてのクリップの合計は 15 秒までです。
備考:参照動画は、再生される秒数ごとに料金に加算されます(課金を参照)。必要な部分だけに切り詰めてください。
値が正しくない場合
- 最大数を超えた場合:
"reference_videos" accepts at most 3 items - クリップを読み取れない場合:
A reference video could not be read: reference_videos[0]: its host does not allow byte-range requests. Send an MP4 or MOV file at a public HTTPS URL whose host allows byte-range requests.
出力の解像度で、480p または 720p です。720p のほうが 1 秒あたりの料金が高くなります。
指定できる値:480p, 720p
デフォルト:720p
- 小文字のみ使えます。1080p と 4K はこのモデルでは使えません(
seedance-2を使ってください)。
値が正しくない場合
- 一覧にない値の場合(たとえば
1080pや720P):"resolution" must be one of: [480p 720p]
レスポンス
タスクオブジェクトです。タスクが成功するまで output は null です。「実行中」と記載されたフィールドは、タスクの完了後に表示されなくなります。

