HiAPI
ブログ

使用ガイド

Seedance 2.5 リファレンス動画生成:TikTok・Reels 向けショート動画クリップ

3つの実クリップ、3つのリファレンスモード、そして縦型ショート動画出力の鍵となるフィールド

Aug 15, 2026
Seedance 2.5 リファレンス動画生成:TikTok・Reels 向けショート動画クリップ
モデル
seedance-2.5

seedance-2.5/reference-to-video は白紙のプロンプトから出発するのではなく、既存の素材から新しいクリップを生成します。参照動画を指定すれば、そのクリップのカメラワーク、テンポ、動きを保ちながら、被写体の差し替え、スタイルの変更、参照音声トラックの重ね合わせが可能です。ショート動画制作においては、これは TikTok や Reels のアイデアを撮り直すのか、それとも良い素材1本を複数本にミックスするのかを決める要素になります。以下では、この方法で生成した3つの実クリップ(完全なプロンプト付き)と、縦型・短尺出力で本当に重要なフィールドを紹介します。

なぜこれが特にショート動画のミックスに適しているのか

TikTok/Reels 制作と非常に相性が良い点が3つあります:

  • aspect_ratio: "9:16" は実際に設定できるフィールドであり、後からのクロップではありません——モデルが直接縦型でレンダリングします。
  • reference_video_urls がカメラワークの構成を担います。テンポ、編集、構図がすでに要件を満たす素材があれば、被写体やスタイルを変えるためにカメラワークを再設計する必要はありません。
  • 尺は設計上とても短いです。duration の上限は30秒で、入力した参照動画の長さに連動します——このモデルはクリップ向けに作られており、長尺出力向けではありません。

例1:被写体を差し替え、カメラワークの経路を保つ

元の参照はトレイルランニングシューズの広告です。プロンプトはカメラの押し込み順序を保ち、製品を全面的に差し替えています:

@video1 をカメラの押し込み、製品の回転、カメラワークの経路、テンポ、マクロクローズアップ、ライティングのトランジションの参照として厳密に使用する。靴を @image1 の香水瓶に完全に置き換える。各ショットで瓶の正確な輪郭、琥珀色のガラスの色味、キャップの比率、ラベルの位置、高級素材の外観を保つ。暗い黒曜石の台座に置かれた高級香水広告として、温かい琥珀色のリムライト、制御された反射、繊細な環境霧、精密なマクロディテールで表現する。@video1 の視覚的リズムとカメラワークの構成に従いながら、最初から最後まで同じ香水瓶を保つ。靴紐、靴底、生地の質感、靴の形状の幾何学を瓶に転写してはならない。追加の製品、読み取れるブランド文字、ロゴ、手、人物を勝手に追加してはならない。

@video1 と @image1 はプロンプト本文中の参照マーカーです——どのアップロードファイルがどの役割を担うかをモデルに伝えます。ここでは @video1(靴のクリップ、reference_video_urls 経由で渡す)が動作とカメラワークを提供し、@image1(香水瓶、reference_image_urls 経由で渡す)が被写体のアイデンティティを提供します。末尾のネガティブ指示(「靴紐を転写してはならない……」)はポジティブな記述と同じくらい重要です——明示的に除外しない限り、リファレンス動画生成は元のクリップの余計なディテールも持ち込んでしまいます。これは 480p、9:16、4秒でレンダリングされ、音声はモデルがネイティブに生成して同期しています(このクリップには個別の音声参照はありません)。

例2:動きだけを移し、それ以外はすべてスタイルを変える

これは reference_video_urls のみを使用し——画像や音声の参照はなし——動きをまったく異なるビジュアルスタイルに持ち込みます:

@video1 を唯一の視覚参照として使用する。コーギーの識別可能な模様、走るリズム、歩幅のタイミング、体の向き、前進の勢い、低い位置からの横向き追従カメラワークを保つ。シーン全体をフェルト、ウール、ミニチュアの草地、手描きの紙のセットで作られた手作りストップモーションアニメーションとして再想像する。温かい夕日の逆光と途切れない追走のリズムを保ち、繊細な手作り感と自然な被写界深度を加える。ショット全体を通して同一の一貫したコーギー、解剖学的に安定した脚、滑らかな前進動作、連続したカメラワーク経路を保つ。追加の動物、文字、ロゴ、唐突なカット、無関係な物体を導入してはならない。

これが最も分かりやすいモードです:参照動画1本と、何を保ち(リズム、カメラワーク経路)、何を変えるか(すべての表面、素材、ライティングの選択)を明確に示す指示。既存素材の被写体を差し替えるのではなくスタイルを反転させたい場合の、良いデフォルト選択です。

例3:動画・画像・音声の3つを組み合わせる

最も要求の高いモードは3種類の参照すべてを重ね、出力を音声のタイミングに同期させることをモデルに求めます:

@video1 を職人の手の動き、工房での作業、カメラワークの構成、マクロ構図、そして原材料から最終的なお披露目までの進行の参照として使用する。元のガラス製品を @image1 の水晶のキツネ彫刻に置き換える。シーケンス全体を通して、キツネの半透明の多面幾何学、尖った耳、巻いた尻尾、水晶の色味、優雅な比率を保つ。職人が温かいガラス工房で水晶のキツネを丁寧に形作る様子を、本物の道具、輝く炉の炎、制御された反射、物理的に妥当な手とともに描く。@audio1 を同時にBGMと時間的リズムのガイドとして使用する。炉の炎の噴出を冒頭の低いパルスに同期させ、重要な道具の接触をガラスの澄んだ鳴き音に同期させ、最終的な水晶のキツネのお披露目を最後のきらめくクレッシェンドに同期させる。キツネは生命のないガラス彫刻のままとし、生きた動物に変えてはならない。同じ工房、同じ彫刻、滑らかな時間的連続性を保つ。文字、ロゴ、追加の彫刻、変形した手、無関係なシーンの変化を追加してはならない。

@audio1(reference_audio_urls 経由で渡す)はここで明示的なタイムトラックとして使われています——プロンプトは「音楽」を求めるだけでなく、どの視覚的ビートが音声のどの時点に対応すべきかをモデルに伝えています。この程度の指示があって初めて、同期は大まかな近似ではなく明確に識別できるものになります。

ショート動画の鍵となるフィールド

  • reference_video_urls(必須、配列)——少なくとも1つの公開動画URL。動作、カメラワーク経路、テンポを提供します。上記3つの例はいずれも1つだけ使用しています。
  • reference_image_urls(任意、配列)——例1のように、参照動画の動作を保ちながら被写体を差し替えます。
  • reference_audio_urls(任意、配列)——例3のように、音、音色、または明示的な時間同期のための参照音声。
  • duration——整数、4〜30秒。上記3つの例はいずれも4秒の下限を使用しており、ショート動画の1ビートを担うのに十分です。参照動画の総延長の上限が、実際に要求できる長さを決めます。
  • resolution——"480p"、"720p"、"1080p" のいずれか。
  • aspect_ratio——16:9、4:3、1:1、3:4、9:16、21:9、adaptive のいずれか。TikTok/Reels 向けには例1のように "9:16" を直接設定します——別途クロップする工程は不要です。

スキーマは厳格です:このリスト以外のフィールド(seed、ratio、image_urls、audio_urls)は生成開始前に拒否されます。完全なリクエスト/レスポンス構造とエラー処理については、リファレンス動画生成 API ガイドをご覧ください。

ショート動画リクエストの送信

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer sk-<your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5/reference-to-video",
    "input": {
      "prompt": "Use @video1 for camera path and pacing only. Replace the subject with the product from @image1, keep lighting and framing consistent with the source.",
      "reference_video_urls": ["https://your-cdn.example.com/reference-clip.mp4"],
      "reference_image_urls": ["https://your-cdn.example.com/subject-ref.jpg"],
      "duration": 4,
      "resolution": "720p",
      "aspect_ratio": "9:16"
    }
  }'

これにより taskId が即座に返されます。GET /v1/tasks/{taskId} をポーリングして status が "success" になるまで待ち、期限切れ前に output[0].url からダウンロードします。完全な認証設定についてはクイックスタートドキュメント、このモデルのパラメータリファレンスについては Seedance 2.5 ドキュメントページをご覧ください。

ショート動画バッチのコスト

現在の料金データでは、720p は1秒あたり $0.2715——480p は $0.1215/秒、1080p は $0.68/秒です。課金秒数は参照動画の長さに出力の長さを加えたもので、5秒の参照クリップから4秒の出力を生成すると、720p で約 $2.44 になります。参照クリップは必要な動作部分にトリムしてください。ショート動画のバッチで同じ参照動画に対し複数の被写体差し替えやスタイルバリエーションをテストする場合、クリップごとのコストは急速に積み上がります——プロンプトを反復するときはテスト尺を4秒の下限に保ち、参照設定が固まってから尺を延ばしてください。

よくある質問

参照動画は必要ですか、それとも参照画像だけで始められますか? reference_video_urls は必須です——少なくとも1つの動画URLが必要です。reference_image_urls と reference_audio_urls は重ね合わせの層であり、これを代替するものではありません。

クロップせずに真正の 9:16 出力を得られますか? はい——上記の例1のように、リクエストで aspect_ratio: "9:16" を設定してください。これはこのモデル上の実際の列挙値であり、元クリップの比率に制約されません。

音声は reference_audio_urls から来ますか、それとも生成されますか? どちらも可能です。上記の例3は明示的な @audio1 参照で時間を駆動しており、例1の音声は個別の音声参照なしでネイティブに生成されています。既存の音声トラックと特定の時間同期が必要な場合は、reference_audio_urls で提供し、プロンプト内で明示的に参照してください。

参照動画はどのくらいの長さまで可能ですか? 参照動画入力の総延長の上限は30秒で、出力の duration の上限も30秒です——このモデルは短いクリップ向けに作られており、長尺素材向けではありません。

参照入力を増やす(動画+画像+音声)と高くなりますか? いいえ——参照画像と音声は追加料金が発生しません。720p の料金は1秒あたり $0.2715 で、参照動画の長さに出力の長さを加えたものに基づいて課金されます。

これを中心にショート動画パイプラインを構築する場合、リファレンス動画生成 API ガイドがコールバックやエラー処理を含む完全なリクエストライフサイクルを扱っており、モデルページではスクリプトを書く前に参照クリップをテストできるライブプレイグラウンドが提供されています。

永続的なAIアーティファクトで開発を始める

APIキーを取得して、タスクベースの1つのAPIで画像・動画・音声モデルを呼び出せます。

APIドキュメントを読む