はじめに
Seedance 2.5 参照から動画 は、見た目、動き、サウンドトラックを導く素材から新しいシーケンスを作ります。キャラクター画像、ロケーション、カメラの参照、音声トラックが、それぞれブリーフの別の部分を担うときに選ぶモードです。
ByteDance は 2026 年 7 月 31 日の発表記事 で Seedance 2.5 を紹介し、柔軟な参照ベースの制作を中心的な機能に位置づけました。このエンドポイントはそうした指示を新しい動画にまとめるためのもので、渡した写真を最初のフレームとして固定するためのものではありません。
Seedance 2.5 のシーケンスの出発点を選ぶ
| 開始素材 | モード |
|---|---|
| 台本やシーンの説明 | Seedance 2.5 テキストから動画 |
| 確定済みの開始画像 | Seedance 2.5 画像から動画 |
| 見た目・動き・音声を分けた参照素材 | Seedance 2.5 参照から動画 |
主な機能とハイライト
1 回の生成で長めのストーリー
Seedance 2.5 は最長 30 秒のクリップに対応し、導入、展開、結末までを 1 つのシーケンスに収める余裕があります。物語表現の機能には、1 つの動作を引き延ばすだけでなく、ショットのつながりやシーンの転換も含まれます。
柔軟なマルチモーダル参照
画像、映像、音声が、同じ作品の異なる要素をそれぞれ導けます。拡張された参照ワークフローは、見た目と動き、音を切り分けながら、より複雑なキャスト、舞台、ショット構成に対応します。
クレイレンダーと絵コンテによるガイド
簡易な 3D のプランニング映像で空間構造、立ち位置、カメラの動きを伝え、仕上がりの見た目は画像の参照で示せます。絵コンテや順番を付けたキーフレームも、シーケンスを伝える手段になります。
より細かな映像と音の演出
モデルの開発では、素材感、ライティング、肌や目のディテール、音と動きの連動が重視されています。プロンプトではセリフ、効果音、環境音を分けて指定でき、秒単位のタイムスタンプで出来事を整理できます。
部分的な編集と続きの生成
このモデルシリーズには、時間を指定した動画の編集、背景の差し替え、既存映像の続きの生成が含まれます。これらは動画を入力する別のワークフローで、利用できるかどうかや設定は、テキストから動画や画像から動画のリクエストではなく、選んだタスクによって決まります。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 必須で、ここでは配役も担います。参照は送った順に引用されるので、どの画像がどのキャラクターか、各クリップが何を寄与するのか、音声が何のためかを名指ししてください。 |
reference_image_urls | いいえ | 参照画像を最大 30 枚。キャラクター、作風、セットを保つために使います。 30 件以内 |
reference_video_urls | いいえ | 動き、テンポ、カメラの語彙を供給する参照クリップを最大 10 本。各 2〜30 秒、合計 30 秒までです。 10 件以内 |
reference_audio_urls | いいえ | 参照音声を最大 10 ファイル、各 2〜30 秒、合計 30 秒まで（前世代は 3 ファイル・合計 15 秒でした）。語り口、テンポ、楽句といった音の拠り所をモデルに与え、動きとカット点がそこへ揃います。 10 件以内 |
aspect_ratio | いいえ | 既定は |
resolution | いいえ | 480p、720p、1080p、既定は 720p で、課金される数量に直接効きます。出力の段を決めるだけで、低解像度の参照を鮮明にはしません。 |
duration_seconds | いいえ | 4〜30 秒、既定 5。これと参照クリップの長さは、課金される数量への 2 つの独立した寄与である点に注意してください。 |
generate_audio | いいえ | 既定でオン。映像に同期したネイティブのサウンドトラックを作ります。 デフォルト値: |
output_format | いいえ | 返される動画のコンテナで、mp4（既定）か mov を選べます。映像はどちらも同じです。 |
enable_web_search | いいえ | 既定はオフです。オンにすると、モデルは描画の前にプロンプトに関連する情報をウェブで検索することがあります。 デフォルト値: |
seed | いいえ | 整数の seed。省くと毎回それぞれの乱数になります。 |
return_last_frame | いいえ | 動画と一緒に、クリップの最終フレームを別の画像として返します。次の先頭フレームとして image-to-video に渡せば、自分で静止画を書き出さずにショットをつなげられます。 デフォルト値: |
watermark | いいえ | モデル自身のドキュメントにあるとおり、AI 生成であることを示す透かしを動画に入れるよう指示します。既定ではオフです。 デフォルト値: |
料金
参照クリップの長さも課金対象の秒数に加算されます。実行前にクリップの長さを計測できないため、まず上限の30秒分を仮押さえし、精算時に未使用分を即座に解放します。実際に使用された秒数のみが課金されます。
| 解像度 | With video: はい | With video: いいえ |
|---|---|---|
| $0.0738 / 秒 | $0.1234 / 秒 |
| $0.1659 / 秒 | $0.2773 / 秒 |
| $0.4082 / 秒 | $0.6823 / 秒 |
ユースケース
キャラクター、セット、カメラ計画を組み合わせる
許諾を得た人物の画像、環境の参照、求める動きを示す短いクリップを用意します。人物の同一性、配置、カメラのふるまいという 3 つの寄与を別々に評価してください。
簡易なカメラリハーサルをスタイルのあるシーンへ
動きには簡単なプランニング映像を、素材感と光にはルックの参照を使います。プランニング映像のどの部分を無視するかを説明し、生成された形状が正確だと決めつけずに空間の関係を確認してください。
許諾済みの音声トラックに映像を付ける
音の参照をアップロードし、それに合わせる映像、雰囲気、動作を書きます。音楽や話し声のきっかけと映像の関係を確認してください。拍に完全に合った編集が保証されるわけではありません。
プロンプトガイドと実践のヒント
Seedance 2.5 で複数の参照を割り当てる方法
ストーリーの前に、素材の対応表をはっきり書きます。アップロードした画像、クリップ、トラックのそれぞれを文章で役割に結び付けてください。参照画像の中に名前が書かれているだけでは対応付けになりません。
- 映像素材と音声素材を意図した順番でアップロードします。
- エンドポイントのラベル
@Image1、@Video1、@Audio1を使います。 - 各素材から何を借りるかを正確に書きます。
- 対応表のあとに、シーンの要約とショットの順番またはタイムスタンプを書きます。
リュックの画像、キャンプ場の画像、カメラが弧を描くクリップがあるなら、12 秒を選びます。
@Image1 supplies the backpack's design, straps and color.
@Image2 supplies the campsite and morning light.
Use only the camera arc from @Video1, not its subjects or background.
A backpack stands upright on a flat rock at the campsite.
0-4s: Establish the bag from the side; a loose strap moves gently in the breeze.
4-9s: Follow the reference camera arc toward the front of the bag.
9-12s: Stop the camera and hold on the front view.
Preserve the bag design while matching it to the campsite's light.
Sound: soft wind and distant birds, without music, dialogue or captions.
簡易な 3D カメラリハーサルの使い方
クレイレンダーのクリップを動画の参照としてアップロードします。カメラの軌道、被写体の動き、立ち位置、ライティングのどれを借りるかを書いてください。仕上がりの被写体を画像で渡すなら、それをリハーサル内の対応する物体に明示的に結び付けます。
クリップからは、エディターのオーバーレイ、座標軸、カメラのガイドなど見えている要素を取り除きます。参照の役割だけでなく完成したシーンも書き、求める動作をリハーサルと矛盾しないようにします。
絵コンテか個別のキーフレームかを選ぶ
絵コンテのグリッドはショット全体の順番を、個別の画像は各キーフレームの構図を伝えられます。グリッドを使うならコマをはっきりさせ、足りない動きや音はプロンプトで補います。個別のキーフレームを使うなら順番を明記し、そのあとでトランジションを書きます。
声と動作をあいまいさなく割り当てる
複数のキャラクターがいるなら、それぞれに固定の名前を付け、見た目と声を別々に割り当てます。音声トラックがシーケンスを導くなら、@Audio1 が声、リズム、環境音のどれを担うかを書いてください。正確な動きの参照を、それと矛盾する手順に書き直さないでください。参照の役割を示し、足りない情報だけを加えます。
コンテンツの範囲
Seedance 2.5 · 参照から動画 — 無検閲。 SpicyAPI はプラットフォーム側のコンテンツフィルターを加えません。モデル自体の制限は引き続き適用され、結果は保証されません。当社のコンテンツポリシーの遵守はお客様の責任です。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedance-2.5/reference-to-video",
"input": {
"aspect_ratio": "adaptive",
"duration_seconds": 5,
"generate_audio": true,
"output_format": "mp4",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"reference_image_urls": [
"https://example.com/reference.png"
]
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。
