Seedance 2.5 の使い方:公式 API と EvoLink アクセス
Seedance 2.5 公式 API と EvoLink 統合は公開済みです。以下では公式アプリから EvoLink API までの経路を扱います。本記事は独立したガイドであり、当サイトは ByteDance と提携関係にありません。EvoLink キーを作成し、短いテストから始め、拡大前に現行料金とアカウント制限を確認してください。
ルート 1:公式アプリ(Dreamina、CapCut)
ByteDance は Dreamina などの自社クリエイティブアプリで Seedance 2.5 を提供しています。すでに Dreamina や CapCut のプランに課金しており、お住まいの地域でアクセスできるなら、これが最も統合された体験になり得ます——生成、編集、公開が一箇所で完結します。注意点として、展開は地域とプランごとに異なる場合があり、ヘビーな利用はプランの上限にすぐ達しがちです。
ルート 2:EvoLink live API
EvoLink は当サイトが推奨するサードパーティの Seedance 2.5 provider です。T2V、I2V、R2V model ID は公開済みです。料金表とコンソールで現行料金を確認し、API クイックスタートから短い 2.5 テストを実行してください。2.0 は rollback に保ちます。
コードを書きたくない場合は 2 つの方法があります。1 つは当サイトのプレイグラウンドでショットをセットアップする方法——prompt を書き、長さと画質を選べば、設定をそのまま EvoLink に引き継げます。もう 1 つは、prompt ライブラリの公式ケースを開き、完全な prompt と launch ティアの設定をワンクリックで EvoLink の生成画面に送る方法です。agent から操作することも可能です。
適切な workflow を選ぶ:3 つの model ID の役割
| workflow | model ID | 必須入力 | 向いている用途 |
|---|---|---|---|
| Text-to-video | seedance-2.5-text-to-video | prompt | prompt のみのテイク。最速のスタート地点 |
| Image-to-video | seedance-2.5-image-to-video | prompt + フレーム画像 1〜2 枚 | 最初のフレーム(または最初と最後のフレーム)で構図を固定 |
| Reference-to-video | seedance-2.5-reference-to-video | prompt + 少なくとも 1 種類の参照素材 | キャラクター/製品の一貫性、モーション転写、音声同期 |
事前に知っておきたい落とし穴が 2 つあります。image-to-video の prompt は必須で、フレーム画像だけでは送信できません。また、フレーム画像の上限は 2 枚です。一貫性の制御にもっと多くの素材を使いたい場合は、image-to-video に画像を詰め込むのではなく、reference-to-video に切り替えてください。
prompt 自体の上限は 10,000 トークンで、route documentation では英語で約 1,000 語が目安とされています。長い prompt ほど従順になるわけではないので、トークン予算は正確なカメラ用語に使いましょう。
prompt の書き方:描写ではなく指示する
品質を左右する最大のレバーは、願望を述べるのではなく、監督のように prompt を書くことです。比較してみましょう。
❌ 「夕暮れの美しい都市、シネマティック、高品質」
✅ 「ゴールデンアワーに沿岸都市の上空からドローンでプルバック、アナモルフィックフレア、街灯が次々と灯る中、港の上をゆっくりドリーアウト」
2 つ目の prompt は、カメラ(ドローンのプルバック、ゆっくりとしたドリーアウト)、光(ゴールデンアワー、フレア)、そしてタイミングを伴うイベント(街灯が次々と灯る)を指定しています。Seedance 2.5 にはカメラ用語を明示的に指定するのが効果的です——ホイップパン、ラックフォーカス、クレーン移動、手持ちの揺れは、いずれも明示的に書く価値があります。
うまく機能しやすい構成は次のとおりです。
- ショットタイプ + カメラの動き——「マクロレンズで押し込む」「手持ちのトラッキングショット」
- 被写体 + アクション——何が起きるかを順序立てて
- 光 + 雰囲気——「逆光の蒸気」「ナトリウム灯の街灯」
- スタイルのアンカー——フィルムストック、時代、ジャンル
prompt ライブラリから、設定付きの実用例を拝借してください。
参照素材の使い方
参照素材は、公開されている 2.5 のプロダクトデモが際立つポイントです。公開済みの reference-to-video ルートは、1 リクエストあたり最大で画像 30、動画 10、音声 10 を受け付けます。この予算の中で役割を設計してください:
| 参照タイプ | 固定できるもの | route documentation 上の仕様 | 実用的なヒント |
|---|---|---|---|
| 画像(最大 30) | キャラクター、製品、ロケーション、カラーパレット | jpeg/png/webp、300〜6000px、各 ≤30MB | 少数の承認済みアイデンティティセットの方がデバッグしやすい |
| 動画クリップ(最大 10) | カメラの動き、モーションスタイル、エフェクト | mp4/mov、各 2〜30 秒、合計 ≤30 秒、各 ≤200MB | モーションの役割は一度に 1 つずつ追加する |
| 音声ファイル(最大 10) | テンポ、リズム、雰囲気 | wav/mp3、各 2〜30 秒、合計 ≤30 秒、各 ≤15MB | 権利処理済みのクリーンな素材を使う |
参照素材はファイルアップロードではなく URL として送信されます。すべてのリンクがタスクのライフタイム全体でアクセス可能であることを確認してください。レンダリング中に期限切れになる署名付き URL は、最も一般的なサイレント失敗の原因の 1 つです。
有効なワークフローは次のとおりです。まず prompt のみのテイクでショットを固め、その後、参照素材を一層ずつ追加します——最初にキャラクター、次にカメラの動き、最後に音声です。すべてを一度に追加すると、失敗の原因を診断できなくなります。
長さ、画質、音声:デフォルトとオプション
パラメータを省略すると route はデフォルト値を適用します。デフォルトを知っておけば、「なぜクリップが 5 秒なのか」という混乱を避けられます:
| パラメータ | デフォルト | オプション |
|---|---|---|
duration | 5 秒 | 4〜30 秒 |
quality | 720p | 480p / 720p |
aspect_ratio | adaptive(入力または prompt に追従) | 16:9、9:16、1:1、4:3、3:4、21:9、adaptive |
generate_audio | true | false で無音の動画を出力 |
content_filter | true | 無効化すると約 10% の追加料金と documentation に記載。コンソールの請求で確認 |
リマインダーを 2 つ。縦型コンテンツでは adaptive の推測に頼らず、明示的に 9:16 を渡してください。また、後工程で音声を当てるパイプラインでは generate_audio をオフにしてください——そうしないと、使わないトラック付きのテイクが毎回出力されます。課金の挙動は引き続きコンソールと現行 documentation が基準です。route capability は設定可能に保ってください。
予算を燃やさずにイテレーションする
EvoLink コンソールの現行料金を基準にコスト baseline を作成してください。documentation に従う低リスク smoke test と実際の請求記録で照合し、料金表も参照します。
よくある失敗パターン
- テイクの途中で顔が変形する——キャラクターの参照画像を追加してください。prompt だけに頼らないこと。
- カメラが動かない——動きを指定していないためです。静的な prompt からは静的なショットしか得られません。
- 音声がカットと同期しない——同期を明示的に記述し(「ダウンビートごとに照明が変化する」)、そのトラックを音声参照として提供してください。
プレイグラウンドで最初のテイクをセットアップし、本番に移行する前に provider のサポート状況と価格を確認してください。