Reliability and Routing2026年7月27日Flatkey Team

2026年のSeedance 2.0 API: アクセス、料金、フォールバックルーティング

Seedance 2.0 APIのアクセス方法、料金確認、非同期ジョブ、そして変化する動画モデルのバージョンをまたいだ安全なフォールバックルーティングを解説する最新ガイドです。

2026年のSeedance 2.0 API: アクセス、料金、フォールバックルーティング

Seedance 2.0 APIは、もはや単なるモデル発見の問題ではありません。プロダクトチームにとってより難しいのは、必要な正確な入力モードでルートが利用可能か、使用量がどのように課金されるか、そしてプレビュー版や早期アクセスの動画モデルが利用できない場合に何が起こるか、という点です。

この違いが重要なのは、公開されているモデルの状況が急速に変化しているためです。ByteDanceは2026年2月12日にSeedance 2.0を正式リリースし、マルチモーダル入力と同期音声を中核機能として発表しました。2026年7月27日時点で、Flatkeyの公開モデルディレクトリにはseedance-2.5が1080pの早期アクセス対応テキストtoビデオおよび画像toビデオのオプションとして掲載されており、seedance-2.0-i2vは720pの使用量ベースの画像toビデオルートとして掲載されています。

これらのカタログ上の記載は有用な出発点ではありますが、恒久的な契約ではありません。本番環境の統合では、起動や大規模キャンペーンのたびに、モデルの利用可否、モダリティ、解像度、課金単位、ジョブの仕様を検証する必要があります。

このガイドでは、2026年におけるSeedanceへのアクセスを評価する方法、生成動画の実際のコストを見積もる方法、そしてモデル名、プロバイダールート、機能が変わっても壊れないフォールバックルーティングを設計する方法を説明します。

Seedance 2.0 API: 簡潔な答え

Seedance 2.0 APIを評価するチームは、これをバージョン管理された機能契約を持つ非同期メディアワークフローとして扱うべきです。

実際には、アプリケーションは次のことを行う必要があります。

  1. 選択したルートがテキストtoビデオ、画像toビデオ、音声、対象解像度、継続時間、地域をサポートしているか検証する。
  2. チャット形式の応答を待つのではなく、生成ジョブを送信する。
  3. プロバイダーのジョブIDと、自身の冪等性キーを保存する。
  4. ジョブが終端状態に達するまでポーリングするか、Webhookを処理する。
  5. 出力URL、メタデータ、コスト、エラー理由を正規化する。
  6. 安全に再試行するか、主要ルートが利用できない場合は互換性のあるフォールバックルートを選択する。

Seedanceがより大きな製品の中の1つのモデルである場合は、1つのプロバイダーの前提をアプリケーション全体に埋め込むのではなく、このロジックをルーティング層の背後に置いてください。

最初のSeedance 2.0 APIガイドから何が変わったか

初期のSeedance 2.0記事は、利用可能なAPIパスを何でも見つけることに焦点を当てていました。それだけではもはや不十分です。

現在の判断軸には次のものが含まれます。

  • 複数のモデルバージョン: チームはSeedance 2.0、モダリティ特化の2.0ルート、またはより新しいSeedance 2.5ルートに遭遇する可能性があります。
  • 異なる機能の組み合わせ: テキストtoビデオ、画像toビデオ、解像度、音声、継続時間の制限はルートごとに一致しない場合があります。
  • 変化するアクセス状態: 早期アクセス、許可リスト、地域別の利用可否、アカウントの適格性は、製品側が変わらなくても変化することがあります。
  • 異なる課金単位: 動画料金は、秒単位、生成アセット単位、クレジット単位、またはプラットフォーム固有の使用単位で表される場合があります。
  • 非同期運用リスク: キュー時間、タイムアウト、重複送信、期限切れの出力URL、失敗したジョブは、コストとユーザー体験の両方に影響します。

その結果、より成熟した統合の問いが生まれます。それは「Seedance APIは存在するか?」ではなく、「今日このリクエストを満たすルートはどれで、そのルートが満たせなくなった場合に製品はどう振る舞うか?」です。

2026年7月27日時点のSeedanceアクセス概要

次の表は、期限付きの評価用資料です。アクセスや料金は変更される可能性があるため、実装前にライブのモデルディレクトリを確認してください。

ルート 公開カタログの状態 モダリティ 掲載出力 最適な用途
seedance-2.5 早期アクセス テキストから動画、および画像から動画 1080p より広い現在の機能セットが必要な新規評価
seedance-2.0-i2v 従量課金 画像から動画 720p 既存、または互換性重視の画像から動画ワークフロー

このスナップショットは重要なルーティングルールを示しています。新しいモデルが、すべてのリクエストに対して自動的に有効なフォールバックになるわけではなく、古いモデルも新しいルートと自動的に互換ではありません

有効なフォールバックは、リクエストに必要な機能を満たしていなければなりません。ユーザーが参照画像を渡した場合、フォールバックは画像から動画をサポートしている必要があります。製品が1080p出力を約束しているなら、720pのみのルートは同等ではありません。同期音声が必要な場合は、無音動画ルートは送信前に機能検証で失敗すべきです。

モデルを選ぶ前に機能要件を定義する

フォールバック設計をモデル名の一覧から始めてはいけません。リクエスト契約から始めてください。

社内向けの説明例となる契約は、次のようになります。

{
  "operation": "image_to_video",
  "required": {
    "resolution": "1080p",
    "audio": true,
    "max_queue_seconds": 90
  },
  "preferred_models": [
    "seedance-2.5",
    "seedance-2.0-i2v"
  ],
  "fallback": {
    "allow_lower_resolution": false,
    "allow_silent_output": false,
    "max_attempts": 2
  }
}

これはプロバイダーへのリクエスト本文ではありません。これは、リクエストをプロバイダー固有の API にマッピングする前に、ルーターが評価できるアプリケーションレベルのポリシーです。

この契約では、以下を分離する必要があります。

  • ハード要件: モダリティ、最小解像度、音声、長さ、コンプライアンス地域、出力形式。
  • 優先事項: モデルの順序、品質ティア、想定レイテンシ、コスト目標。
  • 許容される劣化: ユーザーが低解像度、無音出力、短い長さ、または異なるビジュアルスタイルを許容するかどうか。
  • 運用上の制限: 最大キュー時間、再試行回数、予算、期限。

この分離がなければ、フォールバックルーティングは推測に頼ることになります。

信頼性の高いフォールバックルーティングのワークフロー

1. ライブのルートレジストリを維持する

各候補ルートを、現在の機能とアクセス状態とともに保存します。

  • モデル識別子
  • プロバイダー
  • 対応モダリティ
  • 解像度と長さの制限
  • 音声対応
  • 地域またはアカウント制限
  • 料金単位
  • 現在のヘルス状態
  • 最後に成功したリクエスト時刻
  • 最後の証拠更新時刻

マーケティング上のモデル名だけで安全にルーティングできるだけの情報があると想定しないでください。

2. ヘルスの前に機能でフィルタリングする

まず、リクエストを満たせないルートを除外します。その後、残ったルートをヘルス、コスト、レイテンシ、または品質で順位付けします。

この順序により、健全だが互換性のないルートが、処理できないリクエストを受け取ることを防げます。

3. アドミッション失敗とジョブ失敗を分ける

動画 API は、ジョブ作成の前後どちらでも失敗する可能性があります。

アドミッション失敗には、無効な認証情報、利用不可のモデル、未対応パラメータ、アカウント制限、レート制限が含まれます。これらは多くの場合、即座のルート変更を引き起こせます。

ジョブ失敗は、プロバイダーがリクエストを受け入れた後に発生します。安全性フィルタリング、生成エラー、タイムアウト、アセット配信失敗などが含まれます。これらの失敗を再試行するには、最初の試行ですでに時間や課金対象の計算リソースを消費している可能性があるため、より慎重な対応が必要です。

4. 境界で冪等性を使用する

いずれかのプロバイダーを呼び出す前に、アプリケーションのジョブ ID を割り当てます。すべてのプロバイダーへの試行をその ID の下に保存します。

ネットワークタイムアウトのためにクライアントが再試行した場合、サービスは同一の生成を再送信するのではなく、既存のジョブ状態を返すべきです。これは特に動画ワークロードで重要で、誤って重複すると高コストになる可能性があります。

5. プロバイダー状態を正規化する

製品は、動画モデルごとに異なる状態マシンを公開すべきではありません。プロバイダー固有の状態を、次のような小さな内部セットにマッピングします。

  • queued
  • running
  • succeeded
  • failed_retryable
  • failed_terminal
  • cancelled

元のプロバイダー状態と生のエラーはデバッグ用に保存しつつ、製品の契約は安定したまま維持します。

6. 境界付きのフォールバックルールを適用する

フォールバックは、無制限ループではなく、意図的に行うべきです。

実用的なポリシーでは、以下を許可することがあります:

  • 受け入れ失敗の後に、すぐに1回だけ代替ルートへ切り替える
  • 再試行可能なジョブ失敗の後に、1回だけ再試行する
  • ポリシーまたは安全性の拒否の後はフォールバックしない
  • ユーザーの明示した解像度または音声要件を下回るダウングレードはしない
  • リクエストの予算または期限が尽きた後は新規送信をしない

7. ルート決定を記録する

各ジョブについて、次をログに記録します:

  • 要求された機能
  • 選択されたルートと理由
  • 拒否された候補とその理由
  • プロバイダージョブID
  • キュー、開始、完了のタイムスタンプ
  • 出力の長さと解像度
  • 請求額または使用単位
  • 再試行とフォールバックの履歴

これらの記録によって、ルーティングはブラックボックスから監査可能な製品システムになります。

Seedance 2.0 APIの料金: 数値を比較する前に単位を確認する

「Seedance 2.0 APIの料金」という表現には、複数の異なる課金モデルが隠れていることがあります。プロバイダーやゲートウェイを比較する前に、以下をすべて確認してください:

料金項目 確認すべき点
課金単位 生成秒数ごとか、アセットごとか、クレジットごとか、その他の使用単位か
解像度 720p と 1080p で料金が異なるか
長さ 最小長、増分、最大長
音声 同期音声で料金が変わるか
失敗ジョブ 失敗した生成やフィルタリングされた生成が課金対象か
再試行 新しいプロバイダージョブごとに別途課金されるか
ストレージ 出力保持期間とダウンロードまたはエグレス費用
プラットフォーム手数料 ゲートウェイ手数料、確約量割引、またはエンタープライズ料金の有無

単一の目立つ数値を比較するのではなく、次のワークロード式を使ってください:

monthly generation cost =
successful output seconds
× effective rate per second
+ retry and failure cost
+ storage and delivery cost
+ platform or support cost

たとえば、月に10,000本の成功クリップを生成するプロダクトでも、平均長、解像度、再試行率、音声の有無によって採算性は大きく変わります。初回成功率の小さな改善は、表示上の単価の小さな差よりも重要になる場合があります。

現在のプランと購入情報については、ライブのFlatkey pricing pageをご利用ください。本格的な展開では、モデル機能を保存する同じルートレジストリに、正確な価格ソースと確認日を記録してください。

製品を壊さずに Seedance 2.0 から Seedance 2.5 へ移行する

モデルのアップグレードは、文字列の置換ではなく、制御されたルート変更として扱ってください。

契約を比較する

新しいルートが次を維持するかテストします:

  • 入力タイプとサイズ制限
  • プロンプトの動作
  • サポートされるアスペクト比
  • 出力の長さと解像度
  • 音声の動作
  • ジョブ状態の意味
  • モデレーションの動作
  • アセットURLの有効期間
  • コストレポート

シャドー評価を実行する

対象となるリクエストの少数サンプルについて、顧客クリティカルな経路の外で同じ正規化済み入力を両方のルートに送信します。完了率、レイテンシ、出力品質、コスト、ポリシー結果を比較します。

段階的ロールアウトを使用する

互換性のあるジョブの少量を新しいルートへ移行します。以前のルートは、依然としてリクエスト契約全体を満たす場合にのみ利用可能にしておきます。

ルートレベルの可観測性を維持する

Seedance 2.0 と Seedance 2.5 のメトリクスを 1 つの「video」合計にまとめないでください。ロールアウトがリグレッションを隠さないよう、バージョンごとに個別に追跡します。

Seedance API 統合でよくあるミス

動画生成をチャット完了として扱う

長時間実行される動画ジョブには、永続的な状態、キュー管理、アセット処理が必要です。同期リクエストのパターンでは、脆弱なタイムアウトと不十分な再試行動作が発生します。

フォールバックポリシーとしてモデル名を使う

seedance-2.5seedance-2.0-i2v は、同じファミリー名を共有しているだけでは互換ではありません。機能に基づいてルーティングしてください。

冪等性なしで再試行する

クライアントのタイムアウトは、プロバイダーがリクエストを拒否したことを証明しません。盲目的な再試行は、重複した課金対象ジョブを生み出す可能性があります。

フォールバックで生成できない解像度を約束する

製品が 1080p を約束している場合、720p のルートが黙って代わりを務めるべきではありません。ユーザーの同意を求めるか、明確に失敗させてください。

日付のない価格を製品ロジックにコピーする

料金ページは変更されます。料金ソースと検証日を保存し、コストしきい値を設定可能にしてください。

出力保持を無視する

プロバイダーの URL は期限切れになることがあります。永続的な製品 URL として公開する前に、完了したアセットを自社の承認済みストレージへコピーしてください。

新興の動画モデルガイド向け更新チェックリスト

新興モデルのページには、明示的な更新責任者と証跡サイクルが必要です。大きな Seedance の新バージョンが公開されるたびに、またアクセス状況が急速に変わる間は少なくとも毎月、このページを見直してください。

各更新で確認すべき項目:

  1. 公式のモデル/バージョン発表。
  2. ライブカタログ上の現在のモデル識別子。
  3. テキストから動画、および画像から動画のサポート。
  4. 解像度、長さ、音声、地域の制限。
  5. 早期アクセスや許可リスト要件を含むアクセス状態。
  6. 現在の課金単位と購入ページ。
  7. ジョブ作成、ポーリング、Webhook、キャンセルの意味。
  8. 再試行、失敗課金、出力保持の動作。
  9. 公開ルートのステータスと日付付き記事の主張。
  10. 料金とマルチモーダルルーティングのガイダンスへの社内リンク。

これが、短期間だけ順位を得る記事と、検索需要がまだ形成途中の間も有用であり続ける資産との違いです。

よくある質問

Seedance 2.0 API はありますか?

はい。Seedance 2.0 は ByteDance の公式動画モデルリリースであり、API アクセスはプロバイダーおよびゲートウェイルートを通じて利用できます。正確なモデル識別子、モダリティ、地域、アカウント適格性はアクセス経路によって異なるため、実装前にライブカタログを確認してください。

Seedance 2.0 API は text-to-video と image-to-video をサポートしていますか?

Seedance はマルチモーダルな動画モデルファミリーですが、個々の API ルートはモダリティ固有である場合があります。2026年7月27日時点で、Flatkey は image-to-video 向けに seedance-2.0-i2v を掲載しており、text-to-video と image-to-video の両方に seedance-2.5 を掲載しています。

Seedance 2.0 API の料金はいくらですか?

答えは、プロバイダー、ルート、解像度、尺、オーディオモード、課金単位によって異なります。ルートが秒単位、アセット単位、クレジット、または別の使用単位のどれで課金されるのかを確認し、そのうえで再試行、失敗、ストレージ、プラットフォーム शुल्कをワークロード見積もりに含めてください。

Seedance 2.5 は Seedance 2.0 のフォールバックになりえますか?

同じ必須モダリティ、解像度、オーディオ、リージョン、予算、運用契約を満たす場合は候補になりえます。モデルファミリー名だけを根拠に、自動的な置き換えと見なしてはいけません。

どのような場合にフォールバックルートを発動すべきですか?

適切なトリガーには、ルートの利用不可、アカウント制限、レート制限、再試行可能なインフラ障害が含まれます。安全性による拒否、未サポートの機能、予算の消化、期限切れの締め切りは、通常は別の自動生成に切り替えるのではなく停止すべきです。

実践的な次のステップ

Seedance ルートを選ぶ前に、製品が約束する機能と、許容しうる劣化を文書化してください。次に、最新のモデルカタログと料金情報源を確認し、小規模な非同期ジョブのテストを実行して、証拠日付を記録します。

Seedance が他の動画、画像、または言語モデルと並んで動作する場合は、プロバイダーの詳細を安定したルーティング層の背後に置いてください。そうすることで、より新しいモデルを計画的に導入し、フォールバックオプションを維持し、モデル環境が変化してもプロダクトを作り直さずにアクセス前提を更新できる、制御された方法をチームに提供できます。