SEEDANCE25APIINDEPENDENT

Seedance 2.5 の使い方:公式 API と EvoLink アクセス

Seedance 2.5 公式 API と EvoLink 統合は公開済みです。以下では公式アプリから EvoLink API までの経路を扱います。本記事は独立したガイドであり、当サイトは ByteDance と提携関係にありません。EvoLink キーを作成し、短いテストから始め、拡大前に現行料金とアカウント制限を確認してください。

ルート 1:公式アプリ(Dreamina、CapCut)

ByteDance は Dreamina などの自社クリエイティブアプリで Seedance 2.5 を提供しています。すでに Dreamina や CapCut のプランに課金しており、お住まいの地域でアクセスできるなら、これが最も統合された体験になり得ます——生成、編集、公開が一箇所で完結します。注意点として、展開は地域とプランごとに異なる場合があり、ヘビーな利用はプランの上限にすぐ達しがちです。

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 の役割

workflowmodel ID必須入力向いている用途
Text-to-videoseedance-2.5-text-to-videopromptprompt のみのテイク。最速のスタート地点
Image-to-videoseedance-2.5-image-to-videoprompt + フレーム画像 1〜2 枚最初のフレーム(または最初と最後のフレーム)で構図を固定
Reference-to-videoseedance-2.5-reference-to-videoprompt + 少なくとも 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 にはカメラ用語を明示的に指定するのが効果的です——ホイップパン、ラックフォーカス、クレーン移動、手持ちの揺れは、いずれも明示的に書く価値があります。

うまく機能しやすい構成は次のとおりです。

  1. ショットタイプ + カメラの動き——「マクロレンズで押し込む」「手持ちのトラッキングショット」
  2. 被写体 + アクション——何が起きるかを順序立てて
  3. 光 + 雰囲気——「逆光の蒸気」「ナトリウム灯の街灯」
  4. スタイルのアンカー——フィルムストック、時代、ジャンル

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 秒なのか」という混乱を避けられます:

パラメータデフォルトオプション
duration5 秒4〜30 秒
quality720p480p / 720p
aspect_ratioadaptive(入力または prompt に追従)16:9、9:16、1:1、4:3、3:4、21:9、adaptive
generate_audiotruefalse で無音の動画を出力
content_filtertrue無効化すると約 10% の追加料金と documentation に記載。コンソールの請求で確認

リマインダーを 2 つ。縦型コンテンツでは adaptive の推測に頼らず、明示的に 9:16 を渡してください。また、後工程で音声を当てるパイプラインでは generate_audio をオフにしてください——そうしないと、使わないトラック付きのテイクが毎回出力されます。課金の挙動は引き続きコンソールと現行 documentation が基準です。route capability は設定可能に保ってください。

予算を燃やさずにイテレーションする

EvoLink コンソールの現行料金を基準にコスト baseline を作成してください。documentation に従う低リスク smoke test と実際の請求記録で照合し、料金表も参照します。

よくある失敗パターン

  • テイクの途中で顔が変形する——キャラクターの参照画像を追加してください。prompt だけに頼らないこと。
  • カメラが動かない——動きを指定していないためです。静的な prompt からは静的なショットしか得られません。
  • 音声がカットと同期しない——同期を明示的に記述し(「ダウンビートごとに照明が変化する」)、そのトラックを音声参照として提供してください。

プレイグラウンドで最初のテイクをセットアップし、本番に移行する前に provider のサポート状況と価格を確認してください。

Q&Aクイック回答
Q.01Seedance 2.5 を使うには Dreamina や CapCut が必要ですか?
必ずしも必要ではありません。EvoLink API ルートは公開済みで、任意のブラウザやコードベースから従量課金で利用できます。公式アプリは選択肢の一つであり、必須ではありません。開発を進める前に、コンソールで現行料金とアカウント制限を確認してください。
Q.021 回の生成にはどれくらい時間がかかりますか?
レンダリング時間はキューの混雑状況、長さ、画質に依存します。短く低解像度のテイクは、長く高解像度のものより速くレンダリングされます。自分のワークロードで短いテストを実行し、実測で見積もってください。
Q.03複数のショットにわたってキャラクターの一貫性を保つには?
少数の権利確認済み・バージョン固定の素材を用意し、評価で再利用します。R2V は最大 30 画像、10 動画、10 音声なので、一層ずつ追加してください。
Q.04参照素材にはどのようなフォーマットとサイズの要件がありますか?
画像は jpeg/png/webp、300〜6000px、1 枚あたり最大 30MB。動画は mp4/mov、各 2〜30 秒、合計 30 秒以内、1 本あたり最大 200MB。音声は wav/mp3、各 2〜30 秒、合計 30 秒以内、1 本あたり最大 15MB。常に現行の route documentation で確認してください。