Skip to main content

​
概要

doubao-seedance-2-5-260628（2.5）、doubao-seedance-2-0-260128（標準）、doubao-seedance-2-0-fast-260128（高速）、および doubao-seedance-2-0-mini-260615（ミニ／Lite）は、ByteDance の最新動画生成モデルファミリーです。4つのモデルが並行して稼働し、上流のコンテンツ安全対策を組み込んだ Volcengine 中国本土の公式リソース（BytePlus 国際版ではありません）を通じて APIYI から提供されます。テキストから動画、最初＋最後／最初のフレーム画像から動画、マルチモーダル参照から動画をサポートし、映像と同期した音声、効果音、BGMを生成できます。 2.5 は最も高性能なティアです。最長時間は15秒から 30秒 に、参照画像は9枚から 30枚 に拡張され、音声単体を参照として使用できるほか、明示的な動画編集／延長タスクタイプと mov 出力が追加されています。コストも高くなります。720p／5秒の場合、2.0標準モデルの約1.5倍（約 $0.91 に対して約 $1.35）であり、Volcengine 自身の定価における2世代間の価格差と一致します。2.0ファミリーは引き続き利用可能で、廃止されません。15秒未満の通常クリップでは標準モデルの方が低価格で、1080p もサポートしています。ミニは大量制作向けの選択肢です（標準モデルの単価の約半額で、生成も高速、720pまで）。高速モデルはその中間に位置します。 2.5 は2.0ファミリーと同じ SeeDance2 グループ（0.18x）で稼働します。1つの token ですべての4モデルにアクセスできます。以下の「グループ設定」を参照してください。
🎬 主な特長：2.5 は 4～30秒、2.0ファミリーは4～15秒をサポートします（どちらもモデルが長さを選択する -1 を受け付けます）。3つの解像度ティア（480p／720p／1080p、1080p は2.5および2.0標準のみ対応）、6つのアスペクト比とアダプティブ、同期オーディオはデフォルトで有効、多言語 prompt に対応しています。大規模な ショート動画制作、ECアセット、モーションデザイン、バーチャルヒューマンコンテンツ 向けに構築されています。
🔥 期間限定割引 — 2026-10-07 23:59（UTC+8）まで：新しい2つの単一モデルグループ、SD2Mini（0.10x）および SD2Fast（0.15x）により、mini は44.4%、fast は16.7% レートが下がります。新しい Token に切り替えるだけで利用でき、コード変更は不要です。以下の「期間限定割引グループ」と「グループ設定」を参照してください。
2.5 を呼び出す Token には SeeDance2 グループ（レート0.18x）が必要です。これは2.0ファミリーと同じグループです。Default グループまたは別の動画グループの token で doubao-seedance-2-5-260628 を呼び出すと、**「このモデルで利用可能なチャネルがありません」**というエラーになります。SeeDance2 を有効にした1つの Token で4モデルすべてにアクセスできます。2.5と2.0ファミリーは同じグループおよび同じレートを共有するため、コードで変更するのは model フィールドだけです。

動画生成 API リファレンス

POST /seedance/api/v3/contents/generations/tasks — インタラクティブな Playground と完全なポーリング／ダウンロードコードを備えた非同期タスクエンドポイントです。

API マニュアル

Token の作成、base URL、課金モデル、一般的な呼び出し規則を説明します。

ビジュアル API テスト

コード不要で、iCover ビジュアルテストツールからこのエンドポイントを直接デバッグできます。

非同期タスクの検索／ダウンロード

API の外部にある検索エントリとして、APIYI コンソールで送信済み動画タスクを確認し、動画リンクをダウンロードできます。

​
AI エージェントに統合を任せる

Codex / Claude Code / Cursor で構築する場合は、以下の prompt をコピーしてエージェントに渡してください。まずこのページのプレーンテキスト版を取得し（任意の docs URL に .md を追加）、その後、プロジェクト独自のスタックでコードを作成します。非同期ポーリング、即時コピーを必須にする24時間のリンク有効期限、gzip ヘッダーの落とし穴、パラメーターの禁止事項は、すでに要件に組み込まれています。

このプロジェクトに Seedance 2.5 / 2.0 の動画生成を統合またはトラブルシューティングさせます。Codex、Claude Code、Cursor などのツールにコピー＆ペーストしてください。

​
APIYI の Seedance を選ぶ理由

まず位置づけについて補足します。このモデルには公式割引はなく、APIYI も利益目的で価格設定していません。供給を確保し、お客様に提供するために提供しています。APIYI を利用する真の価値は「より安い」ことではなく、アクセス性と体験にあります。

公式リソース・中国本土版

Volcengine 中国本土の公式リソース（BytePlus 国際版ではありません）であり、上流のコンテンツ安全対策が組み込まれています。パラメータ、レスポンス、課金は公式 API と完全に一致します。

バーチャル顔ホワイトリストへのアクセス

このチャネルには上流のバーチャル顔ホワイトリストアクセスが含まれています。AI 生成された顔とバーチャルアバターは、公式チャネルへの個別のホワイトリスト申請なしで、画像から動画への変換に直接使用できます（実在人物の顔は引き続き上流のコンテンツ安全対策による制限対象です）。

アセットライブラリを無料で提供

キャラクター一貫性のある動画を支えるプライベートアセットライブラリ（バーチャルアバター取り込み + 実在人物確認）は、APIYI では無料です。公式では別途購入が必要なアドオンであり、包括契約のないお客様には年間 6 桁 CNY の契約となります。これを API 価格に含めています。

供給優先の価格設定・公式と同水準

公式割引は存在せず、APIYI はこのモデルから利益を得ていません。単価は Volcengine の公式価格表と一致しています（プラットフォーム上の課金はおよそ 10% 高くなります）。チャージボーナスと組み合わせることで、実質コストは公式チャネルとほぼ同水準となり、高額チャージのお客様は一部のティアでそれを下回ることもあります。

同時実行数無制限・待機なし

当社テストでは、15 件の同時タスクがすべて待機なしで即座に running に入りました（2026-06-06 (UTC+8) に計測）。大規模なバッチ生成に対応できます。

手間のないアクセス・本人確認不要

Volcengine アカウント不要、実名・本人確認不要、利用額のしきい値なし（CNY 200 の有効化デポジットおよび企業確認を省略できます）。中国本土のデータセンター、住宅ネットワーク、海外ノードのいずれからも、単一のトークンで api.apiyi.com に直接アクセスできます。

動画モデルのフルラインナップ

VEO 3.1 と Wan2.7 も同一プラットフォームで利用できます。ユースケースに応じて組み合わせて使用できます。

プロフェッショナルサポート

動画生成ワークロードに精通したチームが、PoC から本番運用まで、モデル選定、チューニング、統合をサポートします。

​
主な機能

3つの画質 · 各画質で同一価格

480p / 720p / 1080p（1080pは2.5および2.0のstandardのみ対応。fastとMiniは720pが上限です）。同じ画質内では、16:9、9:16、1:1、その他すべての比率で、同じピクセル面積と同じ価格が適用されます。横向きと縦向きの切り替えに追加料金はかかりません。

音声はデフォルトで同期

generate_audioはデフォルトでtrueです。音声、効果音、BGMは映像に合わせて生成されます。ボイスオーバーの品質を高めるには、発話内容を二重引用符で囲んでください。

最大30秒の長さを制御可能

2.5では4秒から30秒までの整数秒を指定でき、2.0ファミリーでは4秒から15秒まで指定できます。-1ではモデルが長さを選択します（実際の出力長に基づいて課金されます）。2.5ではdurationのデフォルト値は-1です。省略すると、モデルが自動的に選択します。フレームレートは24 fps固定です。

多言語プロンプト

中国語（最大約500文字）と英語（最大約1000語）に加え、日本語、スペイン語、ポルトガル語、インドネシア語に対応しています。

最初+最後 / 最初のフレーム

2枚の画像で最初と最後のフレームを固定するか、1枚の画像を最初のフレームとしてアニメーション化できます。return_last_frameと組み合わせることで、クリップを連結してより長く連続した動画を作成できます。

マルチモーダルな参照画像からの動画生成

2.5では最大30枚の画像 + 10本の動画 + 10個の音声を使用でき、音声は単独でも利用できます。2.0ファミリーでは9枚の画像 + 3本の動画 + 3個の音声に対応し、音声を使用する場合は画像または動画も併せて指定する必要があります。キャラクターとスタイルの一貫性を保ちながら、動画の作成、編集、延長が可能です。

非同期タスクフロー

送信してtask_idを取得し、ステータスをポーリングした後、content.video_urlからmp4をダウンロードします（リンクの有効期間は24時間です）。

再現可能なシード

seedを固定すると、実行ごとに類似した結果を得られます。watermarkはデフォルトでfalseです。出力にウォーターマークは入りません。

​
料金

料金を一言で言えば — 正確な token 課金で、Volcengine 公式サイトに段階ごとに正確に連動しています。 4つのモデルは料金が異なります：mini < fast < standard < 2.5（公式サイトと同じ順序です。mini は standard モデルの単価の約半分、2.5 は約1.5倍です — 同じ料金水準ではありません）。Volcengine はこのシリーズに割引を提供していません。また、このチャネルは供給確保を目的に価格設定されているため、表示上の料金は公式料金をわずかに上回ります。ただし、チャージボーナス（一般顧客は10%、大口入金顧客は最大20%）を適用すると、実質的なコストは公式サイトとほぼ同等です — 大口入金顧客の場合、追加負担は約5%にとどまり、一部のティア（例：1080p の大口顧客向け料金）ではさらに低くなります。課金は面積×時間で計算されるため、±5%の差異は正常範囲です — ぜひお試しいただき、照合のうえ、いつでもお問い合わせください。もう1点、キャラクターの一貫性を保った動画に必要なアセットライブラリは、APIYI では無料で含まれています（公式では別途購入するアドオンであり、フレームワーク契約のない顧客の場合、年間契約額は6桁の人民元に達します）。この価値は、上記の単価比較には反映されていません。
token ベースの課金：tokens ≈ (input video duration + output duration)(s) × output width × output height × 24 / 1024（テキスト／画像から動画への変換では、入力動画の長さは0です。当社のテストでは誤差0.1%以内で検証済みです）。各ティア内のすべての比率でピクセル面積が同じであるため、料金は解像度ティア、出力時間、入力に動画が含まれるかどうかだけで決まります。

​
公式価格の基準値（16:9 / 5秒出力、動画あたりのCNY）

① 入力動画なし（テキストから動画 / 画像から動画 / 参照画像）: ② 入力動画あり（video_urlを含むマルチモーダル参照；入力動画は2～15秒、下限は約2～4秒の入力、高限は約15秒の入力）:
入力動画ありの場合、課金対象時間 = 入力動画の長さ + 出力の長さとなるため、通常のテキストから動画 / 画像から動画よりも高くなります。また、最小token数の下限も適用されます（非常に短い入力は下限値で課金されます）。正確な利用量は返却された usage.completion_tokensです。
プラットフォーム上での実測比較（2026年6月および2026年7月にテスト、16:9 / デフォルト音声 / 入力動画なし；固定の1:7レートでのCNY、参考値のみ）:
3つのモデルは同じ価格ではありません — 決して同一価格として扱わないでください。 同じ解像度 / 長さの場合、tokenあたりの価格は Mini < 高速 < 標準となります（例：720p / 5秒では、Mini ≈ ¥3.16、高速 ≈ ¥5.08、標準 ≈ ¥6.35）。これは公式の価格体系とも一致します。バッチ制作では、Miniが最も多くのコストと時間を節約します（2026年7月のテストでは、実効単価がプラットフォームの公称レートと正確に一致し、乖離率は0.00%でした）。1080pは標準のみです。
注: 「CNY」はプラットフォーム上の表示課金額です。「一般 ÷1.1」および「大口顧客 ÷1.2」は、10% / 20%のチャージボーナス適用後の実効価格です。ボーナス適用後の価格は公式基準値に近くなり、1080pの大口顧客価格は公式基準値を下回ります。正確な利用量は返却された usage.completion_tokensです。

​
Seedance 2.5 の料金（SeeDance2 グループ、0.18倍）

2.5と2.0ファミリーは、同じSeeDance2グループと同じ0.18倍のレートを共有しています。世代間の差は、モデル自身の単価によるものだけです。720p/5秒の場合、2.5では$1.3721、2.0の標準モデルでは$0.9074で、およそ1.5倍です。この差はVolcengine自身の公式リスト価格を反映しています（2.5のtokenレートは2.0より約52%高い）。APIYIによる上乗せではありません。アップグレードに価値があるかどうかは、30秒のクリップ、30枚の参照画像、mov出力、または動画編集・延長が本当に必要かどうかで決まります。必要ない場合は、2.0の標準モデルのほうが安く、1080pにも対応しています。 ① 入力に動画がない場合（text-to-video、image-to-video、参照画像）： ② 入力に動画がある場合（video_urlを含むマルチモーダル参照、動画編集、動画延長）：別の低いtokenレートで課金されます。 レートが低いからといって、請求額が低くなるとは限りません。入力に動画がある場合、課金対象token数 = （入力動画の長さ + 出力時間）×面積となるため、token数自体が増加します。上の行はレート①では$1.0945、レート②では$0.6567になります。 2つのtokenレート： token数と2つのレートはいずれも、レート計算から導いたものではなく、実際の課金ログ（2026-08-31に再検証済み）に基づいています。チャージボーナスを重ねて適用すると、高ティアのチャージ顧客は公式の参考価格に近い金額になります。
2.5で使いすぎる最も簡単な2つのパターン：
  1. **durationのデフォルト値は-1**です（2.0ファミリーのデフォルト値は5）。これを省略すると、2.5は4～30秒の範囲で独自に長さを選択します。長さを指定しないテストリクエストでは10秒のクリップが返され、5秒の場合のちょうど2倍の料金になりました。料金が重要な場合は、durationを明示的に渡してください。
  2. 30秒は5秒の6倍の料金がかかります（720pでは¥57.23対¥9.60）。料金は長さに厳密に比例するため、長いクリップを作成する前に、5秒でプロンプトを検証してください。
上の表と、先ほどの2.0の表はいずれも0.18倍のSeeDance2グループに基づいているため、直接比較できます。fastとminiには、より低い料金の期間限定割引グループもあります。次のセクションを参照してください。
課金に関する注意事項：
  • 最終的な料金は、コンソールのモデル料金と呼び出しログに従います
  • タスクは送信時に前払い請求され、完了時に精算されます。残高は一時的に変動します。呼び出しログと照合してください。1本の動画では2件の課金エントリが生成されます（下記の「ログで課金を確認する」を参照）
  • 仮押さえ額は解像度に関係なく、長さだけに基づきます：2.0ファミリーは1秒あたり$0.09、2.5は1秒あたり$0.135です。そのため、1080pでは通常、最終精算時に追加課金が発生し、480pでは通常、一部返金が発生します。いずれも正常な動作です
  • 拒否されたリクエスト（HTTP 400のパラメータエラーなど）は課金されません（検証済み）
  • 料金は長さに比例します。15秒の動画は、5秒の動画の約3倍の料金です

​
期間限定割引グループ（mini / fast のみ、10/7まで）

2026-08-08に2つの期間限定割引グループを開始: SD2Mini（0.10x レート）および SD2Fast（0.15x レート）です。通常の SeeDance2 グループの0.18xと比較して、mini は44.4%割引、fast は16.7%割引です。モデル機能、パラメータ、エンドポイント、呼び出し構文に変更はありません。Tokenを1つ差し替えるだけで、コードはそのままです。キャンペーンは 2026-10-07 23:59 (UTC+8) まで実施します（Volcengineの公式プロモーションに合わせて2026-09-05に延長。元の終了日は9月7日でした）。
同一条件での価格比較（上記の実測値を新しいグループレートに比例して換算、すなわち0.18で除算して新レートを乗算。CNYは固定レート1:7で換算しており、参考値です）: 同一モデル・同一仕様の場合、割引グループでは mini が44.4%、fast が16.7%お得です。これはグループレートの直接的な引き下げであり、チャージボーナスとは独立して併用できます。課金方式は変更されず、引き続き実際のtoken使用量に基づいて精算されます。±5%の誤差は正常です。
キャンペーン終了後も利用停止にはなりません: 2026-10-07 23:59 (UTC+8)以降も、SD2Mini と SD2Fast はオンラインのままです。レートが通常の SeeDance2 グループと同じ0.18xに戻るだけです。Tokensは引き続き利用でき、コード変更も不要です。バッチ生成を予定している場合は、割引期間内に実行してください。

​
ログで課金を確認する（事前課金 + 精算）

api.apiyi.com/log でコンソールのログページを開き、モデル名 doubao-seedance-2-0 を検索すると、すべての課金を確認できます。1本の動画では2つの課金エントリが生成されます：
  1. 事前課金：タスク送信時に差し引かれる見積額（「非ストリーミング」と表示され、tokenとグループが表示されるログエントリ）— 下のスクリーンショットでは $0.449998
  2. 精算（追加課金または返金）：タスク完了後、実際に生成されたtokensに基づいて差額が精算されます（「ストリーミング」と表示され、完了token数を含むログエントリ）— 下では $5.611858。1080pでは通常、追加課金が発生します
1本のSeedance 2.0動画に対する2つの課金エントリ（事前課金と精算）を示すAPIYIログページ

Two charge entries for one 15 s 1080p video: pre-charge + settlement

精算エントリにはtokenもそのグループも表示されません— これは正常です。2つのエントリの合計が動画の総コストになります。
時刻フィールドの見方：
  1. 最初のエントリ（事前課金）のタイムスタンプは動画の送信時刻です。「ファーストバイト」の値は、送信からタスクIDが返されるまでの時間を示します（例：首字节:3秒 / ファーストバイト：3秒）— 生成時間ではありません
  2. 精算エントリには 流式（ストリーミング）および 首字节:<1秒（1秒未満のファーストバイト）が表示されます。これらは精算レコード上の内部マーカーにすぎず、問題があることを示すものではありません
  3. 動画の実際の生成時間は、上部ナビゲーションの「非同期タスク」ページ（api.apiyi.com/task）にある「所要時間」列で確認できます
ログページの時刻およびファーストバイトフィールドの見方：最初のエントリは送信時刻と送信レイテンシを示します

The first log entry's timestamp = submission time, and its first-byte value (3 s) is the submission latency; this fast example settled as a refund (negative amount), total cost 0.360000 − 0.022750 = 0.337250 USD

各動画タスクの送信時刻と生成所要時間を表示する非同期タスクページ

The elapsed column on the Async tasks page is the actual video generation time, e.g. 158 s, 303 s

最初のスクリーンショットにある15秒・1080p動画の場合、総コスト = 0.449998 + 5.611858 = $6.061856 です。対応するタスクパラメータは、api.apiyi.com/task の上部にある「非同期タスク」で確認でき、課金額と完全に一致します：
732,108完了tokens ≈ 15 × 1248 × 1664 × 24 / 1024 です（3:4の1080p動画は1248×1664で出力されます）。これは課金計算式と一致します。
この15秒・1080p動画の合計は約**¥42.4です（固定1:7レートでの名目課金額）。チャージボーナスを考慮すると、実効コストは約¥35～39であり、同一仕様における公式参考価格の約¥37.2と比べられます。公式価格自体も安価ではありません— コストはモデル + 解像度 + 時間**によって決まります（高速 / 720p / 5秒に切り替えると大幅に安くなります）。このモデルは可用性を確保するために薄いマージンで提供されており、大口チャージのお客様にはより大きな割引が適用されます。
ベータ供給に関するお知らせ：Seedance 2.5および2.0ファミリーは現在ベータ供給フェーズです。実際の課金額が上記の表から大きく乖離する場合は、カスタマーサポートまでお問い合わせください。照合のうえ調整します。価格は、上流ポリシー（例：より低価格な公式バリアントが後日提供された場合）およびAPIYIの供給能力に応じて動的に調整されます。対応能力のあるチャネルパートナーからのご連絡も歓迎します。このモデルの価格は、利益ではなく供給の確保と顧客への提供を目的としています。

​
グループ設定

Seedance 2.5 と 2.0 ファミリーは専用グループで稼働し、2 つの必須要件があります。① Token の課金モデルが Pay-as-you-go Priority（または Pay-as-you-go）であること。リクエスト単位課金の Token はルーティングできません。② Token で対応するグループが有効になっていることです。Default グループまたは他の動画グループの Token では、「このモデルで利用可能なチャネルがありません」というエラーになります。 現在、グループは 3 つあります。2.5 と 2.0 ファミリーは SeeDance2 を共有し、さらに各 1 モデルのみを提供する期間限定割引グループが 2 つあります。
1 つの SeeDance2 Token ですべての 4 モデルにアクセスできます：2.5 と 2.0 ファミリーの 3 モデルはすべてこのグループにあるため、コードでは model フィールドを変更するだけです。2 つの割引グループは単一モデルのチャネルです：SD2Mini は mini のみ、SD2Fast は fast のみを提供するため、これらを通じて他のモデルを呼び出すと同じエラーが返されます。キャンペーン終了時の停止はありません：2026-10-07 23:59 (UTC+8) 以降も、両方の割引グループはレートが 0.18x に戻ってオンラインのままです。Token やコードを変更する必要はありません。
**2.5 も同じ 0.18x を使用します。**世代間の差はグループレートではなく、モデル自体の単価（Volcengine の 2.5 価格は 2.0 より高い）によるものです。したがって、2.5 と 2.0 ファミリーは完全に同じ換算基準で稼働します。**なぜ 0.18x なのでしょうか？**システムに組み込まれた Seedance の単価は Volcengine の公式リスト価格と一致しています。ただし、そのリストは CNY 建てである一方、APIYI の残高は USD 建てです（USD/CNY は固定 1:7 レート）。1x レートでは実質的に公式価格の 7 倍が課金されるため、通貨換算を吸収するためにグループレートを引き下げています。0.18 の由来はここにあり、割引でもマークアップでもありません。Volcengine はこのシリーズに割引を提供しておらず、このチャネルは供給確保を目的として価格設定されています。通常、名目上の請求額は公式基準価格をわずかに上回りますが、チャージボーナスがその大部分を吸収します。大口チャージのお客様は約 5% 高い料金のみとなり、一部のティア（たとえば 1080p）では公式価格を下回ります。ご注意ください：課金は常に実際の token 使用量に基づき、token 換算には小さな自然変動があります（±5% は正常です）。公式リスト価格は参照アンカーにすぎず、リクエストごとの保証ではありません。現行価格は供給優先の合理的な取り決めです。必ずチャージボーナスと合わせて評価してください。請求額に違和感がある場合はいつでも請求内容を照合しますが、「なぜ公式価格よりわずかに高いのか」という点については議論の対象ではありません。この点をご理解のうえ、懸念がある場合はこのチャネルをご利用にならないでください。一方で、キューイングなしの十分な同時実行数こそが、このチャネルが提供するものです。さらに、アセットライブラリ（バーチャルアバター取り込み / 実在人物認証）はこのチャネルでは無料で含まれます。公式には、別途購入するには CNY で 6 桁の年間契約が必要です。これもこのチャネルの実際の価値の一部です。

​
Token の設定方法

割引を狙わない場合：SeeDance2 グループを有効にした Token を 1 つ作成してください。全 4 モデルにアクセスでき、以下の表は不要です。 期間限定割引を利用する場合：mini と fast にはそれぞれ専用の単一モデルグループがあるため、以下のように Token を分けてください。 すべての Token で Pay-as-you-go Priority（または Pay-as-you-go）課金モデルを使用する必要があります。mini だけを使用する場合は Token A だけで十分です。2.5 だけを使用する場合は Token C だけで十分であり、すべてを用意する必要はありません。
割引用 Token を分ける価値がある理由：
  • 期限を逃しません — Token ごとに課金が分かれるため、キャンペーン中に使用した量と節約額を一目で確認でき、10 月 7 日が近づいた際にバッチ処理を前倒しするかどうかも判断しやすくなります
  • 切り替えにコストはかかりません — キャンペーン終了時にクライアントを Token C に戻すだけです。コード変更もグループ編集も不要です
  • 専用 Token は本番環境でも推奨されます — 事業ラインごとのクォータ制御とアラートが可能になり、予期しない急増もはるかに追跡しやすくなります
Seedance 2.5 は提供開始済みです（2026-08-28）：モデル名は doubao-seedance-2-5-260628 で、2.0 ファミリーと同じ**SeeDance2 グループ**（0.18x）にあります。エンドポイント、認証、リクエスト形式は 2.0 と同一です。model フィールドを差し替えるだけで、コードはそのまま動作します。2.0 ファミリーと比較すると、最大時間は 15 秒 → 30 秒、参照画像は 9 → 30、参照動画/音声は 3 → 10、音声単独での使用、さらに mov 出力と omni_reference_task_type タスクセレクターに対応しています。実行速度は 2.0 standard モデルのおよそ 1.5 倍です。完全な差分については、以下の「技術仕様」を参照してください。

​
技術仕様

​
API エンドポイント

Domains: api.apiyi.com は主要ゲートウェイです。vip.apiyi.com とその他のプラットフォームドメインは同一の動作をします。パスプレフィックスは /seedance/api/v3 です — /api セグメントを削除しないでください。また、/v1/videos は使用しないでください。

​
解像度とアスペクト比の詳細

解像度ティアは短辺ではなく、ピクセル面積を定義します。比率ごとの実際の出力寸法（公式値、テストで検証済み）は次のとおりです。
2.5では、480p 16:9は864×496ではなく854×480です（実測値）。864×496は2.0が生成する値で、2.5では面積がわずかに小さいため、同じ仕様でも必要なtokenはわずかに少なくなります。その他の測定したすべてのティアは両世代で一致します。480p 1:1 = 640×640、720p 16:9 = 1280×720、720p 21:9 = 1470×630、1080p 16:9 = 1920×1080です。このファミリーのモデルはいずれも4kをサポートしていません。"resolution": "4k"を送信すると同期400が返されます（課金対象外）。

​
アダプティブ動作の仕組み

  1. テキストから動画：モデルがpromptから最適な比率を推測します
  2. 最初+最後 / 最初のフレーム：最初のフレーム画像の比率に合わせます（比率が一致しない画像は中央でクロップされます）
  3. マルチモーダル参照から動画：promptの意図に従い、それ以外の場合は最初のメディア項目に従います（画像より動画が優先されます）
  4. 動画編集 / 拡張（2.5）：出力比率は、編集または拡張する入力動画に従います
  5. 実際に使用された比率は、タスクレスポンスのratioフィールドで返されます
ratioが受け付けるのは、上記の7つの列挙値のみです。たとえば"2:1"を渡すとInvalidParameterエラーが返されます（検証済み）。また、サポート範囲外（2.5では4～30、2.0ファミリーでは4～15）のdurationでも同様です。いずれも課金対象外です。2.5では、3種類のタスクでratio: adaptiveも強制されます：最初のフレーム / 最初+最後のフレームの生成、動画編集、動画拡張です。そこに具体的なアスペクト比を渡すと、InvalidParameter.TaskTypeConstraintが送信時に返されます（実測では、数分後に失敗するタスクではなく、同期400でした）。

​
ベストプラクティス

1

出力要件に応じてモデルを選択する

まず、2.5でしか利用できない機能が必要かどうかを確認します：30秒クリップ、30枚の参照画像、単独の音声参照、mov出力、または明示的な動画編集／延長タスクタイプです。いずれかが必要な場合は、doubao-seedance-2-5-260628を選択します（標準モデルの約1.5倍の価格で、2.0ファミリーと同じグループです）。必要ない場合は、2.0ファミリーを使用します：バッチ生成やコスト重視のワークロードにはLiteモデルを使用します doubao-seedance-2-0-mini-260615（標準モデルの約半額で、生成速度が最も速く、720pまでに制限されます）。1080pまたは最高品質が必要な場合は標準モデルを使用します。fastはその中間的な選択肢です。
2

画像と動画はまずアセット IDに取り込む

リクエストにメディアが含まれる場合、タスク作成のレイテンシーはそのメディアのアップロードによって大きく左右されます。インライン Base64や大きな画像 URLを使用すると、送信にかかる時間が約1秒から数十秒に延びたり、読み取りタイムアウトが発生したりします。まずメディアを取り込み、asset://アセット IDを取得して、それを参照してください。これにより、リクエストボディは数十バイトに縮小され、タスク IDがすぐに返され、コンテンツチェックも取り込み時に実行されます。アセット優先ワークフローを参照してください。
3

クロッピングを避けるにはadaptiveを使用する

画像から動画への変換では、モデルが元画像の比率に合わせられるよう、デフォルトのadaptiveを使用してください。9:16（縦向き）または16:9（横向き）に固定するのは、対象プラットフォームでその指定が必要な場合だけにしてください。
4

長さでコストを調整する

コストは長さに厳密に比例します。まず5秒のクリップでプロンプトを検証し、その後、長さを増やしてください（2.5は最大30秒で、5秒のクリップの6倍のコストがかかります）。2.5では、必ずdurationを明示的に指定してください。デフォルトは-1なので、省略するとモデルが選択します。テストでは10秒が選択され、コストが2倍になりました。
5

不要な場合は音声をオフにする

generate_audioのデフォルト値はtrueです。自分で音楽を付ける予定の無音映像には、falseを指定してください。
6

より自然なボイスオーバーのためにセリフを引用符で囲む

プロンプト内で話し言葉を二重引用符で囲んでください。モデルが自動的に一致する音声を生成します。
7

HTTPクライアントにAccept-Encoding: identityを追加する

ゲートウェイはレスポンスにcontent-encoding: gzipというラベルを付けますが、ボディは圧縮されていません。Python requestsなどの自動展開クライアントではContentDecodingErrorが発生します。Accept-Encoding: identityヘッダーを追加するとこれを回避できます（curlには影響ありません）。
8

15～30秒ごとにポーリングし、すぐにダウンロードする

タスクは通常2～5分で完了します。content.video_urlは24時間有効な署名付きリンクです。タスクが成功したら、できるだけ早くファイルを自分のストレージにコピーしてください。
9

return_last_frameでクリップを連結する

return_last_frame: trueを設定すると、ウォーターマークのない最後のフレームのpngを取得できます。それを次のタスクの最初のフレームとして使用し、複数のクリップから連続した動画を作成します。

​
エラーコードとリトライ

クライアントに関する推奨事項:
  • 作成／ポーリング呼び出しでは、リクエストタイムアウトは 30～60 秒で十分です（待機はタスク側で発生します）
  • 全体の時間枠を 15 分以上として、15～30 秒ごとにポーリングしてください（1080p／15 秒タスクではさらに長くしてください）
  • 5xx およびタイムアウト時には 指数バックオフを適用してください（2 回リトライ）
  • トラブルシューティングのため、タスク id と x-request-id レスポンスヘッダーをログに記録してください

​
FAQ

遅いのは生成ではなく、送信です。メディアは上流の APIYI まで送られた後、Volcengine に転送され、そこでデコードと検証が行われます。タスク ID が返るのは、そのすべてが完了してからです。インラインの Base64 や大きな画像 URL を使用すると、この処理は約 1 秒から数十秒に延び、クライアントの 60 秒の読み取りタイムアウトでも足りない場合があります。生成自体は通常 2～5 分かかります。これはプロバイダーの通常の速度であり、送信処理とは無関係です。本当の解決策は、先にメディアを取り込み、asset:// アセット ID として参照することです。これにより、リクエスト本文を数メガバイトから数十バイトに削減できます。レイテンシの内訳、移行手順、タイムアウト後にタスクが作成されたかどうかの確認方法については、アセット優先ワークフローを参照してください。
必要な機能で選択してください。2.5 が自動的なデフォルトというわけではありません。 2.5 は 2.0 の標準モデルの約 1.5 倍の価格です（720p/5 秒：$1.3721 対 $0.9074）。これは Volcengine 独自の表示価格の差とも一致します。次の場合は 2.5 を選択してください：15 秒を超えるクリップが必要（2.5 は 30 秒まで対応）、9 枚を超える参照画像が必要（2.5 は 30 枚まで対応）、mov 出力が必要、または送信時にパラメータエラーを検出できる動画編集／延長を行う場合（omni_reference_task_type）。2.5 では音声のみを参照素材にすることも可能ですが、2.0 では音声とともに画像または動画も必要です。クリップが 15 秒未満の場合は、2.0 ファミリーを使い続けてください。標準モデルは1080p にも対応しており、最高クラスの品質帯に位置します。コスト重視の一括生成には、標準単価の約半額で最速の生成が可能な mini を使用してください。2.0 ファミリーは廃止される予定はありません。エンドポイント、認証、リクエスト形式は世代間で同一で、グループも同じです。切り替え時に変更するフィールドは 1 つだけです：model。
1080p は動作します（実測では 1920×1080 が正常にレンダリングされました）。4k には対応していません。"resolution": "4k" を送信すると同期 400 が返されます（課金されません）。見落としやすい違いが 1 つあります。2.5 は 1080p を H.265（hvc1）としてエンコードしますが、480p と 720p では H.264（avc1）が使用されます。H.265 ファイルは小さくなりますが、古いプレーヤー、一部のブラウザー、特定の編集ソフトでは H.264 より安定して扱えない場合があります。1080p を配布する前に、後続のパイプラインでデコードできることを確認してください。
どちらも「オムニ参照」タスクです。content に参照動画を指定し、prompt で意図を表現すると実行されます。エラーを早期に検出できるよう、omni_reference_task_type を明示的に渡してください。
  • 動画編集：omni_reference_task_type: "edit"、少なくとも 1 つの role: "reference_video"、ratio は adaptive、duration は -1 である必要があります。また、元の動画の長さは 4～30 秒でなければなりません。prompt には編集を表す動詞（追加、削除、消去、変更、置換）が必要です。出力のアスペクト比と長さは入力動画に従います。また、長さには小数を指定できます（実測では 16.709 秒の結果が返されました）。
  • 動画延長：omni_reference_task_type: "extend"。参照動画を指定し、ratio を adaptive に設定します。prompt には延長を表す動詞（延長、継続）が必要です。
prompt 内では、アセットを位置で参照してください。@video1、@image1 のように、渡した順序に従います。無効なパラメータの場合は、数分後にタスクが失敗するのではなく、送信時に 400 が返されます（InvalidParameter.TaskTypeConstraint）。
"output_format": "mov" を渡すと、QuickTime コンテナ（H.264 + yuv444p クロマ + PCM オーディオ）が返され、色と輝度の再現性が向上します。これはカラーグレーディング、キーイング、コンポジットに適しており、動画編集／延長では入力と出力の両方に使用することが公式に推奨されています。デフォルトはmp4で、最も幅広い互換性があります。mov では、一部のプレーヤーで開けないプロフェッショナル向けコーデックが使用されることに注意してください（VLC、mpv、ffplay、macOS の IINA はすべて対応しています）。Web やモバイルで直接配信する場合は、デフォルトの mp4 を使用してください。
Seedance で最もよくあるエラーで、10 回に 9 回は Token で有効になっているグループが間違っています。エラーには、現在使用しているグループが表示されます。たとえば次のようになります。
モデルに対応するグループを確認し、Token 設定で有効にしてください。SeeDance2 を有効にした 1 つのキーですべての 4 モデルにアクセスできます。課金モデルは「従量課金（優先）」または「従量課金」である必要もあります。リクエストごとの課金 Token ではルーティングできません。
ゲートウェイの content-encoding: gzip ヘッダーが、実際の本文のエンコーディングと一致していません。症状には、ContentDecodingError、切り詰められた非 JSON 本文（例：先頭の {" が失われ、id":"cgt-xxx"} しか取得できない）、断続的な 400 などがあります。リクエストヘッダーに "Accept-Encoding": "identity" を追加してください。curl とブラウザーの fetch には影響ありません。
generate_audio のデフォルトは true です（検証済み）。モデルが音声、効果音、BGM を自動的に追加します。無音の出力にするには、"generate_audio": false を明示的に渡してください。
成功時、URL はポーリングレスポンスの content.video_url にあります（トップレベルではありません）。これは約 24 時間有効な署名付きリンクです。すぐにダウンロードして、自分の環境で再ホストしてください。task_id 自体は 7 日間クエリ可能です。
状態マシンは queued → running → succeeded / failed / expired です。成功状態は succeeded であり、completed ではありません。他の動画 API から移行する際によくある間違いです。
いいえ。Seedance 2.5 も 2.0 ファミリーも、実在する人物の顔を含む参照画像／動画は受け付けません（上流のコンテンツ安全対策による制限です）。代替手段として、過去 30 日以内に Seedance モデルで生成された顔を含む出力を再利用する、プラットフォームのプリセット仮想アバター（asset:// ID）を使用する、またはライセンス済みの顔アセットを使用してください。
いいえ。仮想アバターの取り込み、実在人物の検証、その他の非公開アセットライブラリは、APIYI の Seedance 2.0 API で無料です。年額料金もかかりません。公式には、この機能は別途購入するアドオンであり、フレームワーク契約のない顧客の場合は年間 6 桁人民元の契約が必要です（Volcengine から直接購入することもできます）。長期利用のお客様を重視しているため、この費用はすでに当社の API 価格に含まれています。SD2 API を通常の範囲で利用するお客様には、通常の業務量で追加料金はかかりません。使用方法については、アセットライブラリを参照してください。
パラメータ拒否（HTTP 400）は課金されません（検証済み）。課金は送信時に仮請求され、完了時に確定するため、残高は一時的に変動します。コールログと照合してください。
tokens ≈ duration(s) × width × height × 24 / 1024です。誤差 0.1% 以内で検証済みです。1 つのティア内では、すべてのアスペクト比でピクセル面積が同じです（720p の 16:9 と 9:16 はどちらも 5 秒あたり 108,900 token）。横長、縦長、正方形の料金はすべて同じです。
価格と速度は mini ＜ fast ＜ standard の順です（プラットフォーム上の 720p/5 秒の公称価格：約 ¥3.16 / ¥5.08 / ¥6.35）。一括生成やコスト重視のワークロードには mini を選択してください。標準価格の約半額で、生成速度も最速です（2026-07 の実測：720p・5 秒で約 1.5～2.5 分）。最大限のディテールが必要な場合は standard、中間の選択肢として fast を選んでください。mini と fast はどちらも 720p が上限です。1080p を要求すると 400 パラメータエラーが返されます（課金されません）。1080p だけが必要な場合、2.0 standard モデルはすでに対応しています。その目的だけでアップグレードする必要はありません。30 秒のクリップ、9 枚を超える参照画像、mov 出力、動画編集／延長が必要な場合は 2.5 を選択してください（standard モデルの約 1.5 倍の価格で、2.0 ファミリーと同じグループです）。
モデルが長さを自動的に選択し（2.5 では 4～30 秒、2.0 ファミリーでは 4～15 秒）、実際の出力長に基づいて課金されます。最終的な長さはタスクの duration フィールドに返されます。2.5 では -1 がデフォルトであることに注意してください（2.0 ファミリーのデフォルトは 5 秒です）。そのため、duration を省略すると、モデルが選択する長さが使用されます。実測では、duration を指定しない 2.5 のリクエストから 10 秒のクリップが返され、5 秒の場合のちょうど 2 倍の料金になりました。料金を予測しやすくしたい場合は、duration を明示的に渡してください。
いいえ。frames と camera_fixed は Seedance 1.x のパラメータです。Seedance 2.5 も Seedance 2.0 シリーズも対応していません。代わりに、秒単位の整数の duration を使用してください。
いいえ。これらは 3 つの相互排他的なモードです。first+last（first_frame／last_frame のロールが必須の 2 枚の画像）、first frame（1 枚の画像）、マルチモーダルの reference-to-video（画像ロール reference_image）です。「first/last frame + reference」を近似するには、reference モードを使用し、prompt でフレームを指定してください。参照数の上限は世代によって異なります。2.5 は画像 30 枚、動画 10 本、音声クリップ 10 個に対応し、音声のみでも使用できます。2.0 ファミリーは画像 9 枚、動画 3 本、音声クリップ 3 個に対応し、音声を使用する場合は少なくとも画像 1 枚または動画 1 本も必要です。
SeeDance2 グループは十分な同時実行数を備えており、キュー待ちはありません（テストでは 15 個のタスクを同時に実行し、すべて即時に開始されました）。より大規模な継続的ワークロードについては、営業にお問い合わせください。
prompt は中国語で約 500 文字、英語で約 1,000 語未満にしてください。長すぎる prompt はディテールを薄めます。対応言語は中国語、英語、日本語、スペイン語、ポルトガル語、インドネシア語です。被写体、動作、カメラの動き、ライティング／スタイルを説明してください。

​
関連ドキュメント

Seedanceは、デフォルトで同期音声を出力する数少ない2026年の一線級動画モデルファミリーの1つです。同一価格のアスペクト比と、2.5の30秒上限を組み合わせることで、ショート動画やEコマース向けアセットの制作における主要チャンネルとして強力な選択肢となります。代替手段を比較する場合、同じToken（追加のグループを有効にした場合）で、Sora 2、VEO 3.1、Wan2.7を直接呼び出せます。