ByteDance

Seedance 2.0

seedance-2.0

ByteDanceのマルチモーダル動画生成モデル。テキストからの生成、画像からの生成、参照からの生成に対応し、ネイティブ音声が同期されたマルチショットのシネマティックな短編映像を出力できる

ルート

default ext

seedance-2.0 seedance-2.0-fast seedance-2.0-mini

seedance-2.0 を試す

入力

作品ギャラリー

すべての作品を見る

出力

video

パラメータを入力して生成すると、結果がここに表示されます。

料金

seedance-2.0 per second

仕様	480P	720P	1080P	4K
Without Reference Videos	$0.136	$0.293	$0.729	$1.486
With Reference Videos	$0.082	$0.179	$0.443	$0.915

位置づけの概要

Seedance 2.0 は ByteDance が発表したマルチモーダル動画生成モデルで、テキスト、画像、参照動画、参照音声の組み合わせ入力に対応し、1 回の生成で 4～15 秒、最大 4K のネイティブ音声付き動画を出力します。モデルはマルチショットのナラティブとキャラクターの一貫性を重視し、先頭フレームと末尾フレーム、参照素材によって画面の展開を制約できます。広告ショート動画、ソーシャル向け短尺動画、ナラティブなプリビズを素早く制作したい開発者に適しており、HiAPI.ai の統一インターフェースを通じて出力秒数に応じた課金で呼び出せます。

主なハイライト

マルチモーダル素材による生成——テキスト、最大 9 枚の参照画像、3 本の参照動画、3 本の参照音声を混合でき、実際の素材で画風、動き、音声を制約できます。
先頭・末尾フレームによるカメラの開始と終了の制御——先頭フレームと末尾フレームの画像を指定すると、生成動画が指定画面から始まり指定画面で終わるため、ショットの接続や正確なトランジションが容易になります。
ネイティブ音声の同時生成——デフォルトで映像に同期した音声を生成し、参照音声を重ねて音色やリズムを誘導できるため、後工程での音画同期の作業を削減できます。
最大 4K と適応アスペクト比——解像度は 480p から 4k まで、アスペクト比は 1:1 から 21:9 およびソース画像の比率に追従する adaptive に対応し、1 回の呼び出しで多様な配信先に適応できます。

機能説明

3 種類の生成方式：テキストからの動画生成、画像からの動画生成、参照素材からの動画生成に対応し、同一インターフェースで素材の組み合わせに応じて切り替えられるため、1 つのワークフローで構想から完成品までのニーズをカバーできます。

複数参照素材による制約：参照画像、参照動画、参照音声を同時に渡すことができ、参照画像と先頭・末尾フレームの合計は 9 個以内、参照動画と参照音声はそれぞれ 3 本以内、各合計時間は 15 秒以内です。

長さと解像度の制御：長さは 4～15 秒の間で指定でき、解像度は 480p、720p、1080p、4k から選択可能で、出力秒数に応じて課金されるため、配信仕様に合わせてコストを管理できます。

末尾フレームの返却：return_last_frame を有効にすると、生成動画の最終フレームが返され、そのまま次のセグメントの先頭フレーム入力として利用でき、複数セグメントの生成をつなげられます。

Web 検索による拡張：web_search スイッチで生成時に Web 検索を有効にし、プロンプトに最新の情報を補足できます。現在の出来事やニュースに依存するクリエイティブなコンテンツに適しています。

適用シーン

広告・ブランドチーム：テキスト脚本と参照画像——マルチショットのブランド短編を素早く生成し、音声付きの 1080p または 4k 動画を出力して、ソーシャル配信や公式サイトの素材に活用できます。
ナラティブな短尺動画クリエイター：先頭・末尾フレームとキャラクター参照画像——先頭・末尾フレームでカメラの開始と終了を固定し、参照画像でキャラクターの一貫性を保ち、連続性のある絵コンテ断片を制作して、ショートドラマやストーリー系コンテンツに利用できます。
クリエイティブなプリビズ：参照動画と参照音声——既存の映像とナレーションでスタイルとリズムを誘導し、動的なプリビズ動画を生成して、本制作前に監督やクライアントが方向性を確認できます。
開発者向け統合：秒単位課金での一括出力——HiAPI.ai の統一インターフェースを通じて生成タスクを一括投入し、出力秒数で予算を管理してコンテンツ制作パイプラインに組み込めます。

制限と選定のアドバイス

1 回の生成時間の上限は 15 秒のため、長い動画は分割生成してからつなぐ必要があります。参照素材の数には制限があり、参照画像と先頭・末尾フレームの合計は 9 個以内、参照動画と参照音声はそれぞれ 3 本以内かつ各合計時間は 15 秒以内のため、複雑なプロジェクトは分割が必要です。末尾フレームの返却にはスイッチを有効にする必要があり、末尾フレームは先頭フレームを同時に提供することが前提です。超長尺の連続ショットやフレーム単位で正確に制御する従来のポストプロダクション工程が求められる場合は、専用の編集・合成ソリューションを検討すべきです。より長い完成品が必要な場合は、分割生成した後に編集するのが適切です。

よくある質問

よくある質問を見る →

Seedance 2.0 はどのような種類の動画モデルですか？

Prompt を中心とし、先頭と末尾のフレームや参照用の画像・動画・音声を追加することもできます。各種の制御方法は、現在のパラメータ契約に従って組み合わせる必要があります。
Seedance 2.0 はどのような出力仕様に対応していますか？

4～15秒に対応し、解像度は480p、720p、1080p、4k、アスペクト比は1:1、4:3、3:4、16:9、9:16、21:9、adaptiveに対応しています。
音声を生成したり、音声リファレンスを使用したりできますか？

画像・動画・音声のリファレンスを選択可能。音声生成にも対応
Seedance 2.0 の課金方法は？

出力時間とリアルタイムプランに基づいて課金されます。解像度、モード、音声オプションによる差異は、ページ上の価格とタスク記録に準じます。

生成タスクの作成

POST https://api.hiapi.ai/v1/tasks

ヘッダー

Authorizationstring必須

アカウントの API キー。すべてのリクエストで必須です。例：Bearer YOUR_HIAPI_API_KEY。API キーを取得

Content-Typestring任意

リクエストボディは常に JSON として解析されます。送信する場合は application/json（charset 付き可）のみ受け付け、他の値は 415 を返します。例：application/json。

Idempotency-Keystring任意

冪等キー。最大 255 バイト。同じアカウントで同じキーの再試行はタスクを 1 つだけ作成し、リプレイは最初の taskId を返します。

冪等キー

ネットワークタイムアウトやクライアントの自動再試行時、同じキーではタスクを 1 回だけ作成し、二重課金は発生しません（適用範囲 = API キーのアカウント）。業務側の一意識別子（例："order-42"）をキーに使うことを推奨します。同じキーのリプレイは最初の taskId を返し、キーは初回送信から 24 時間で失効します。詳細なシナリオ表は統一非同期 API の紹介ページをご覧ください。

ボディ

modelstring必須

現在の固定値：seedance-2.0

routestring任意

現在の固定値：default

inputobject必須

seedance-2.0 とルート default の業務パラメータオブジェクト。下のパラメータ表を参照してください。

promptstring必須minLength 3maxLength 20000

動画生成用のテキストプロンプト。生成されるコンテンツの画面とスタイルの記述を決定します。

durationinteger任意デフォルト: 5min 4max 15

生成動画の長さ（秒単位）。デフォルトは 5 秒です。

resolutionstring任意デフォルト: "720p"

生成動画の解像度。デフォルトは 720p、4k では超高精細なディテールを出力できます。

オプション：480p720p1080p4k

web_searchboolean任意

生成過程で情報を補完するためにウェブ検索を有効にするかどうか。

aspect_ratiostring必須デフォルト: "16:9"

生成動画のアスペクト比。デフォルトは 16:9。値が adaptive の場合、画像から動画を生成する際は元画像の比率に従い、テキストから動画を生成する際はデフォルト比率にフォールバックします。

オプション：1:14:33:416:99:1621:9adaptive

generate_audioboolean任意デフォルト: true

モデルが対応している場合に音声を同時生成するかどうか。デフォルトは有効（true）です。

last_frame_urlstring任意

最終フレーム画像の URL または asset:// リソース ID。動画の終了画面を指定するために使用します。

first_frame_urlstring任意

最初のフレーム画像の URL または asset:// リソース ID。last_frame_url を指定する場合、このパラメータは必須です。

return_last_frameboolean任意デフォルト: false

生成動画の最終フレームを返すかどうか。デフォルトは false です。

reference_audio_urlsarray任意maxItems 3

参照音声アドレスの配列。要素は音声 URL または asset:// リソース ID です。最大 3 件、合計時間は 15 秒以内です。

Array [ string ]

reference_image_urlsarray任意maxItems 9

参照画像アドレスの配列。要素は画像 URL または asset:// リソース ID です。最初のフレーム・最終フレーム画像と合わせて 9 枚を超えてはなりません。

Array [ string ]

reference_video_urlsarray任意maxItems 3

参照動画アドレスの配列。要素は動画 URL または asset:// リソース ID です。最大 3 件、各動画の長さは 2～15 秒、合計時間は 15 秒以内です。

Array [ string ]

callbackobject任意

終了状態の通知設定。省略した場合はコールバックされず、呼び出し側でポーリングします。

コールバック（Webhook）

作成時に callback.url を指定すると、タスク終了時に HiAPI があなたのサービスへ POST し、ポーリングが不要になります。コールバックのリクエストボディはタスク詳細と同構造です。署名検証・再送・冪等の詳細は統一非同期 API 紹介ページのコールバック説明を参照してください。

urlstring必須

callback を指定する場合は必須。タスク終了後にこの URL へ POST します。有効な http(s) URL である必要があります。

whenstring任意デフォルト: "final"

現在は final のみ対応（success / fail の両方で通知）。

オプション：final

storagestring任意デフォルト: "temp"

成果物の保存期間：temp（デフォルト・約 7 日）または persistent（長期保存・サイズ課金）。残高不足や保存上限超過の場合は temp に自動降格します。実際に適用された段階はタスク詳細レスポンスで確認できます。

オプション：temppersistent

modelstring必須

現在の固定値：seedance-2.0

routestring任意

現在の固定値：ext

inputobject必須

seedance-2.0 とルート ext の業務パラメータオブジェクト。下のパラメータ表を参照してください。

promptstring必須minLength 3maxLength 20000

Text prompt used for video generation.

durationinteger任意デフォルト: 5min 4max 15

Video duration in seconds.

resolutionstring任意デフォルト: "720p"

Video resolution on the ext route: 720p, 1080p, or 4k.

オプション：720p1080p4k

web_searchboolean任意

Whether to enable web search for generation.

aspect_ratiostring必須デフォルト: "16:9"

Video aspect ratio. adaptive follows the source image ratio (image-to-video); for text-to-video it falls back to the default.

オプション：1:14:33:416:99:1621:9adaptive

generate_audioboolean任意デフォルト: true

Whether to generate synchronized audio when supported.

last_frame_urlstring任意

Last-frame image URL or asset:// asset id.

first_frame_urlstring任意

First-frame image URL or asset:// asset id.

return_last_frameboolean任意デフォルト: false

Whether to return the last frame of the generated video.

reference_audio_urlsarray任意maxItems 3

Reference audio URLs or asset:// asset ids. Up to 3 audio clips, total duration no more than 15 seconds.

Array [ string ]

reference_image_urlsarray任意maxItems 9

Reference image URLs or asset:// asset ids. Combined count with first/last frame images should not exceed 9.

Array [ string ]

callbackobject任意

終了状態の通知設定。省略した場合はコールバックされず、呼び出し側でポーリングします。

コールバック（Webhook）

urlstring必須

callback を指定する場合は必須。タスク終了後にこの URL へ POST します。有効な http(s) URL である必要があります。

whenstring任意デフォルト: "final"

現在は final のみ対応（success / fail の両方で通知）。

オプション：final

storagestring任意デフォルト: "temp"

オプション：temppersistent

リクエスト例

# 非同期タスクを送信。成功すると即座に taskId を返します（生成完了は待ちません）
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-2.0",
  "input": {
    "prompt": "…",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true,
    "return_last_frame": false
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "seedance-2.0",
    input: {
      "prompt": "…",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "generate_audio": true,
      "return_last_frame": false
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "seedance-2.0",
        "input": {
          "prompt": "…",
          "duration": 5,
          "resolution": "720p",
          "aspect_ratio": "16:9",
          "generate_audio": True,
          "return_last_frame": False
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

# 非同期タスクを送信。成功すると即座に taskId を返します（生成完了は待ちません）
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-2.0@ext",
  "input": {
    "prompt": "…",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true,
    "return_last_frame": false
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "seedance-2.0@ext",
    input: {
      "prompt": "…",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "generate_audio": true,
      "return_last_frame": false
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "seedance-2.0@ext",
        "input": {
          "prompt": "…",
          "duration": 5,
          "resolution": "720p",
          "aspect_ratio": "16:9",
          "generate_audio": True,
          "return_last_frame": False
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

タスク詳細の取得

GET https://api.hiapi.ai/v1/tasks/:id

レスポンスフィールド

taskIdstring必須

タスク ID。先頭は固定で tk-hiapi-。

modelstring必須

解決済みのモデル完全名。route パラメータで送信したタスクは base@route（例：gpt-image-2/text-to-image@ext）を返し、それ以外は送信時のモデル名と同一です。

routestring任意

route パラメータを明示して送信したタスクでのみ出現し、送信時の値をエコーします。

statusstring必須

タスク状態。

ステータス値

queued キュー投入済み、未開始。 handling 処理中。 archiving 処理完了、成果物準備中。 success 終端：完了。成果物利用可能（output を返却）。 fail 終端：失敗（error を返却）。送信後は status で判断します：success と fail が終端、それ以外は非終端です。1〜3 秒間隔で終端までポーリングすることを推奨します。成功したら output[].url から成果物をダウンロードし、expireAt までに保存先へ転送してください。長期保存が必要な場合は作成時に storage: "persistent" を指定します。

creatednumber必須

タスク作成時刻（Unix 秒）。

completednumber必須

終了状態になった Unix 秒。非終端では 0 固定。

outputarray任意

status == success のときのみ出現。成果物リスト — 常に配列で、1 タスクで複数の type を同時に返すことがあります（例：video + first_frame）。

Array [ object ]

配列要素

urlstring必須

成果物の URL。直接ダウンロードできます。

typestring必須

現在の候補値：video、image、audio、first_frame、last_frame、thumbnail。今後拡張される可能性があります。

expireAtnumber必須

成果物にアクセスできる期限（Unix 秒）。期限までにダウンロードまたは転送してください。

errorobject任意

status == fail のときのみ出現。

codestring必須

業務エラーコード。

messagestring必須

エラーの説明。

レスポンス例

成功

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

処理中（非終端）

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

失敗

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}