ByteDance

Seedance 2.5

seedance-2.5/reference-to-video

Byte Seedの音声・映像同時生成モデル。最長30秒、最高4Kの連続クリップに対応し、マルチモーダル参照とタイムスタンプ単位の編集による精密な画面制御が可能

seedance-2.5/image-to-video seedance-2.5/reference-to-video seedance-2.5/text-to-video

seedance-2.5/reference-to-video を試す

入力

作品ギャラリー

すべての作品を見る

出力

video

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

料金

seedance-2.5/reference-to-video per second

仕様	単価
480P	$0.1215
720P	$0.2715
1080P	$0.680

位置づけの概要

Seedance 2.5 の参照動画生成ラインです。素材によって画面の一貫性を制約する必要がある動画生成タスクに向けられています。開発者はプロンプトと少なくとも1本の参照動画を提出し、画像と音声の参照を同時に追加できます。モデルは @image1、@video1、@audio1 の順序で素材を参照し、4〜30秒、480p〜1080p の完成動画を生成します。広告、ショートドラマ、ブランドコンテンツのチームがシリーズ制作でキャラクター、製品、シーンの外観を固定する用途に適し、効果音とセリフを同期させる必要があるナラティブ映像の制作にも適しています。

主なハイライト

マルチモーダル素材による画面の共同制約——最大30枚の画像、10本の動画、10本の音声を同時に参照として使用でき、製品、キャラクター、シーンの外観を固定します。
プロンプトで素材を順序どおりに参照——prompt 内で @image1、@video1、@audio1 の順序で参照項目を指定し、素材と画面目標を明確に対応付けます。
長さとアスペクト比を制御可能——出力の長さは4〜30秒から選択可能、またはモデルに自動決定させられます。アスペクト比は 16:9、9:16、21:9 のほか、素材に追従する自動適応に対応します。
映像と音声の同期生成——デフォルトで画面に同期したセリフ、効果音、背景音声を生成し、オフにすると映像のみの出力が得られます。

機能説明

参照動画による生成：少なくとも1本の参照動画を入力すると、モデルはそれに基づいて新しいクリップを生成します（元動画の延長や編集ではありません）。既存のカメラワークや画質感を再利用する必要がある制作に適しています。

画像と動画の混合参照：画像は最大30枚、動画は最大10本で、両者を組み合わせて提出でき、キャラクター、製品、シーンをそれぞれ制約してシリーズコンテンツの外観の揺れを抑えます。

音声参照と音声生成：最大10本の wav または mp3 音声参照を追加でき（少なくとも1本の参照動画と同時に提出する必要があります）、同期したセリフ、効果音、背景音を生成するかどうかを選択できます。

解像度と出力形式のオプション：出力は 480p、720p、1080p の3段階に対応し、形式は mp4 またはプロ向けポストプロダクション向けの mov を選択でき、出力秒数に応じて課金されます。

Web検索による情報補完：web_search を有効にすると、モデルが生成前にプロンプトに含まれる時事情報を検索でき、現在の事実を引用する必要があるコンテンツに適しています。

適用シーン

広告・ブランドチームの製品ショート動画——製品画像と実写参照動画で外観を制約し、4〜30秒の広告クリップを生成して、配信素材やソーシャルメディア配信に利用します。
ショートドラマチームのキャラクター一貫性維持——キャラクター画像と既存クリップを参照し、同一キャラクターの連続ショットを一括生成して、絵コンテのつなぎ合わせと編集に供します。
ポストプロダクションチームのショット案プレビズ——シーン参照動画と構図画像を提出し、完成品に近い質感のプレビズクリップを素早く得て、クライアント確認や撮影前の打ち合わせに使います。
コンテンツチームの映像・音声同期クリップ——吹き替えや音楽の参照を提供して音声生成を有効にし、同期したセリフと効果音付きの完成品を出力して、そのまま完成品やさらなるミキシングに利用します。

制限と選定のヒント

1回の生成クリップは最長30秒で、より長いナラティブは複数のクリップに分割して個別に生成し、後でつなぎ合わせる必要があります。参照素材には明確な制約があります。動画は2〜30秒で合計時間は30秒以内、音声の合計時間も同様に30秒以内で、単一ファイルのサイズと画素数にも下限と上限があり、素材が規定に合わない場合は直接失敗します。このラインは参照によって導かれる生成用であり、動画編集や元動画の延長には対応しません。複数素材の参照はプロンプト作成とパラメータ調整のコストが高くなることも意味します。軽量で単一ショット、一貫性の要件がないニーズでは、同シリーズのテキスト-to-動画ラインを検討できます。

よくある質問

よくある質問を見る →

Seedance 2.5の画像から動画生成では、最初のフレームと最後のフレームの両方をアップロードする必要がありますか？

必要ありません。最初のフレーム/最初と最後のフレームモードでは、first_frame_url のみをアップロードすると、モデルは最初のフレームから後続の画面を自然に展開します。カメラの終了状態を制御する必要がある場合は、last_frame_url も同時に提供してください。最後のフレームは単独では使用できません。また、端点フレームを渡さずに、reference_image_urls や reference_audio_urls を参照モードとして使用することもできます。
最初のフレーム、最初と最後のフレーム、複数の参照素材を1回のリクエストで混在させることはできますか？

現在の HiAPI Playground では、これらは2つの入力方式として扱われます：最初のフレーム/最初と最後のフレームモード、または reference_image_urls、reference_audio_urls の参照モードです。制御信号の衝突を避けるため、毎回1つの方式のみを使用してください。参照動画で動作やカメラワークを誘導する必要がある場合は、独立した seedance-2.5/reference-to-video を使用してください。
Seedance 2.5 の画像から動画生成はどのような長さと解像度に対応していますか？

現在のリクエスト契約では 4～30 秒の整数の長さ、および 720p、1080p に対応しています。出力の aspect_ratio は adaptive に固定され、先頭フレームのアスペクト比に従います。ページ上の 4 つの事例はいずれも 720p で、そのうち 3 つが 4 秒、1 つが 5 秒です。30 秒は API の対応範囲内ですが、ページ上には該当する事例はまだありません。
Seedance 2.5 の画像から動画生成の課金方法は？

出力時間と解像度に基づいて課金され、720p と 1080p では1秒あたりの料金体系が異なります。具体的な金額はモデルページのリアルタイム価格とタスク記録に基づきます。

生成タスクの作成

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.5/reference-to-video

routestring任意

現在の固定値：default

inputobject必須

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

promptstring必須

生成指示。参考素材の使用方法を説明するものです。参考項目は @image1、@video1、@audio1 の形式で順番に参照します。このモデルは参照ガイド付き生成に使用され、動画編集や続き生成には対応していません。

durationinteger任意デフォルト: 5

出力動画の長さ（秒単位）。-1 を渡すと自動时长、4 から 30 までの整数を渡すこともできます。デフォルトは 5。

オプション：-145678910

すべて表示（20 件）

1112131415161718192021222324252627282930

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

出力動画の解像度。480p、720p、1080p に対応。デフォルトは 480p。

オプション：480p720p1080p

web_searchboolean任意デフォルト: false

モデルがプロンプトで言及されたリアルタイム情報をインターネット検索できるかどうか。デフォルトは false。

aspect_ratiostring任意デフォルト: "adaptive"

出力画面のアスペクト比。adaptive はモデルが参考素材の比率に合わせることを意味します。デフォルトは adaptive。

オプション：16:94:31:13:49:1621:9adaptive

output_formatstring任意デフォルト: "mp4"

出力動画のコンテナ形式。mp4 は互換性に優れたデフォルト形式、mov はプロフェッショナルなポストプロダクション向けです。デフォルトは mp4。

オプション：mp4mov

generate_audioboolean任意デフォルト: true

セリフ、効果音、背景音声を同時に生成するかどうか。デフォルトは true。

reference_audio_urlsarray任意maxItems 10

参考音声 URL の配列。最大 10 件。各音声は wav または mp3 で、サイズは 15 MB 以下、長さは 2 から 30 秒、音声の合計時間は 30 秒を超えてはなりません。参考音声を提供する場合は、少なくとも 1 つの参考動画も同時に提供する必要があります。

Array [ string ]

reference_image_urlsarray任意maxItems 30

参考画像 URL の配列。最大 30 枚。jpeg、png、webp、bmp、tiff、gif に対応。1 枚あたり 30 MB 以下、各辺 300 から 6000 ピクセル、アスペクト比 0.4 から 2.5。SVG、HEIC、HEIF には対応していません。

Array [ string ]

reference_video_urlsarray必須minItems 1maxItems 10

参考動画 URL の配列。最大 10 件。各動画は mp4 または mov で、総ピクセル数は 409600 以上（例：854x480 以上）、フレームレートは 24 から 60 fps、サイズは 200 MB 以下、長さは 2 から 30 秒、各辺 300 から 6000 ピクセル、アスペクト比 0.4 から 2.5、動画の合計時間は 30 秒を超えてはなりません。

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

リクエスト例

# 非同期タスクを送信。成功すると即座に 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.5/reference-to-video",
  "input": {
    "prompt": "…",
    "duration": 5,
    "resolution": "480p",
    "web_search": false,
    "aspect_ratio": "adaptive",
    "output_format": "mp4",
    "generate_audio": true,
    "reference_video_urls": "…"
  }
}'

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.5/reference-to-video",
    input: {
      "prompt": "…",
      "duration": 5,
      "resolution": "480p",
      "web_search": false,
      "aspect_ratio": "adaptive",
      "output_format": "mp4",
      "generate_audio": true,
      "reference_video_urls": "…"
    }
  }),
});
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.5/reference-to-video",
        "input": {
          "prompt": "…",
          "duration": 5,
          "resolution": "480p",
          "web_search": False,
          "aspect_ratio": "adaptive",
          "output_format": "mp4",
          "generate_audio": True,
          "reference_video_urls": "…"
        }
    },
)
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"
    }
  }
}