> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Seedance 2.0 動画生成
> バイトダンスの Seedance 2.0 を Volcengine の公式リソース経由で利用できます。standard / fast / mini (lite) モデルを並列で提供し、text-to-video、first+last/first frame、マルチモーダルな reference-to-video に対応します。各ティアで、すべてのアスペクト比が同一価格で、同期音声がデフォルト、キュー待ちなしの高い同時実行数を備えています。
## 概要
**doubao-seedance-2-0-260128**（standard）、**doubao-seedance-2-0-fast-260128**（fast）、**doubao-seedance-2-0-mini-260615**（mini/lite）は、ByteDance の最新の動画生成モデルファミリーです。3 つのモデルが並行して稼働し、APIYI 経由で **official Volcengine 中国本土リソース**上に提供されています（BytePlus の国際版ではありません）。上流のコンテンツ安全機能も組み込まれています。text-to-video、first+last/first frame image-to-video、そしてマルチモーダル入力（0-9 枚の参照画像 + 0-3 本の参照 video / 0-3 本の参照 audios）をサポートし、映像と同期した voice、sound effects、background music を生成できます。2026 年 6 月に追加された Mini は、コスト効率重視の選択肢で、**標準モデルの単価のおよそ半額で、生成も高速**、上限は 720p です。
**🎬 ハイライト**: 4-15 s の制御可能な再生時間（または `-1` のモデル選択長）、3 つの解像度階層（480p/720p/1080p；1080p は standard モデルのみ）、6 つのアスペクト比に加えて adaptive、**同期 audio はデフォルトでオン**、そして多言語 prompt（中国語、英語、日本語、スペイン語、ポルトガル語、インドネシア語）に対応しています。**短尺動画制作、eコマース素材、モーションデザイン、バーチャルヒューマンコンテンツ**の大規模運用向けに設計されています。
`POST /seedance/api/v3/contents/generations/tasks` — インタラクティブな Playground と、完全なポーリング/ダウンロードコードを備えた非同期タスク エンドポイントです。
token の作成、base URL、課金モデル、一般的な呼び出し規約。
この endpoint を iCover のビジュアルテストツールで直接デバッグできます — コードは不要です。
送信済みの動画タスクを表示し、APIYI コンソールで動画リンクをダウンロードできます — API の外側にある参照エントリです。
## なぜAPIYIのSeedance 2.0なのか？
まず位置づけについて一言です: このモデルには**公式割引はなく、APIYIも利益目的で価格設定していません** — **供給を確保し、お客様に提供するため**にご提供しています。APIYI経由の本当の価値は「より安いこと」ではなく、アクセスと体験にあります:
Volcengineの中国本土向け公式リソースであり（BytePlusの海外版ではありません）、上流側のコンテンツ安全対策が組み込まれています。パラメータ、レスポンス、課金は公式APIと完全に一致します。
当社のテストでは、15件の同時タスクがすべて即座に`running`へ入り、待ち行列はゼロでした（2026-06-06 (UTC+8) 計測）— 大規模なバッチ本番運用にすぐ対応できます。
公式割引は存在せず、APIYIもこのモデルで利益を得ていません。単価はVolcengineの公式料金表に合わせており（プラットフォーム内の課金はおおむね10%高めです）、[チャージ特典](/ja/faq/recharge-promotions)を組み合わせると実質コストは**公式チャネルとほぼ同等**になります。さらに、高額チャージのお客様は一部の階層ではそれを下回る場合があります。
**Volcengineアカウント不要、実名/本人確認不要、利用額のしきい値なし**（CNY 200の有効化デポジットと法人確認を省略できます）。中国本土のデータセンター、家庭用ネットワーク、海外ノードのいずれからも、1つのTokenで`api.apiyi.com`へ直接アクセスできます。
このチャネルには上流側の**バーチャルフェイスのホワイトリスト**アクセスが含まれており、AI生成の顔やバーチャルアバターを画像から動画へ直接利用できます。公式チャネルへの別途ホワイトリスト申請は不要です（実在の人物の顔は引き続き上流のコンテンツ安全対策により制限されます）。
[VEO 3.1](/ja/api-capabilities/veo-3-1-official/overview)、[Sora 2](/ja/api-capabilities/sora-2/overview)、[Wan2.7](/ja/api-capabilities/wan/overview) を同一プラットフォームで利用できます — 用途に応じて自由に組み合わせられます。
動画生成ワークロードに精通したチームが、PoCから本番導入まで、モデル選定、チューニング、統合支援を提供します。
## 主な機能
480p / 720p / 1080p（1080p は標準モデルのみ）。各ティア内では、16:9、9:16、1:1、およびその他すべての比率で**同じピクセル面積と同じ価格**を共有します — 横向きと縦向きを追加費用なしで切り替えられます。
`generate_audio` は既定で true です: 音声、効果音、BGM は映像に合わせて生成されます。セリフはダブルクォートで囲むと、ナレーション品質が向上します。
`duration` は 4 から 15 までの整数秒を指定でき、`-1` にするとモデルに長さを選ばせます（実際の出力で課金されます）。固定 24 fps です。
中国語（約 500 文字まで）と英語（約 1000 語まで）に加え、日本語、スペイン語、ポルトガル語、インドネシア語に対応しています。
2 枚の画像で最初と最後のフレームを固定するか、1 枚の画像を最初のフレームとしてアニメーション化できます。`return_last_frame` と組み合わせると、クリップをつなげてより長い連続動画にできます。
0〜9 枚の参照画像、0〜3 本の参照動画、0〜3 個の参照オーディオを組み合わせて（少なくとも 1 枚の画像または 1 本の動画が必要です。3 つの画像モードは相互排他的です）、キャラクターとスタイルの一貫性を保ちながら動画を作成、編集、または拡張できます。
送信して `task_id` を受け取り、ステータスをポーリングし、その後 `content.video_url` から mp4 をダウンロードします（リンクは 24 時間有効です）。
`seed` を固定すると、実行ごとに類似した結果が得られます。`watermark` は既定で false です — 出力にウォーターマークは入りません。
## 料金
**1行で言うと、精密な token 課金で、各ティアごとに Volcengine の公式サイトに連動しています。** 3つのモデルは **異なる価格設定** です: mini \< fast \< standard（公式サイトと同じ方向性です。mini は standard モデルの単価のおよそ半分で動作し、**同じ価格帯ではありません**）。プラットフォーム上の一覧価格は公式一覧の約 **1.1倍** で、[チャージ特典](/ja/faq/recharge-promotions)（一般ユーザーは 10%、大口入金ユーザーは最大 20%）を含めると、実質コストは **ほぼ公式サイトと同等** です。ティアによっては（例: 1080p の大口ユーザー価格）さらに安くなることもあります。課金は面積×時間で行われるため、**±5% の差異は正常** です。ぜひテストして照合し、いつでもお問い合わせください。
token ベースの課金: `tokens ≈ (input video duration + output duration)(s) × output width × output height × 24 / 1024`（text-/image-to-video の入力 video 時間は 0 です。社内テストでは 0.1% 以内で確認済みです）。ティア内の各比率はすべて同じピクセル面積なので、**価格は解像度ティア、出力時間、入力に video が含まれるかどうかだけで決まります**】【。
### 公式価格の基準値（16:9 / 5 s 出力、動画あたり CNY）
**① 入力動画なし**（テキスト→動画 / 画像→動画 / 参照画像）:
| 解像度 | 標準 `doubao-seedance-2.0` | 高速 | Mini |
| ----- | ------------------------ | -------- | -------- |
| 480p | CNY 2.31 | CNY 1.86 | CNY 1.16 |
| 720p | CNY 4.97 | CNY 4.00 | CNY 2.50 |
| 1080p | CNY 12.39 | 非対応 | 非対応 |
**② 入力動画あり**（`video_url` を含むマルチモーダル参照；入力動画 2-15 s、下限 ≈ 2-4 s の入力、上限 ≈ 15 s の入力）:
| 解像度 | 標準 `doubao-seedance-2.0` | 高速 | Mini |
| ----- | ------------------------ | --------------- | --------------- |
| 480p | CNY 2.53 - 5.62 | CNY 1.99 - 4.42 | CNY 1.28 - 2.84 |
| 720p | CNY 5.44 - 12.10 | CNY 4.28 - 9.50 | CNY 2.74 - 6.10 |
| 1080p | CNY 13.56 - 30.13 | 非対応 | 非対応 |
入力動画ありの場合、課金対象時間 = **入力動画の長さ + 出力時間** となるため、単純なテキスト→動画/画像→動画より高くなります。さらに最小 token の下限も適用されます（非常に短い入力は下限で課金されます）。正確な利用情報は返却される `usage.completion_tokens` です。
**プラットフォーム上での実測比較**（2026-06 と 2026-07 に計測、16:9 / デフォルト音声 / 入力動画なし；固定 1:7 レートでの CNY 換算、参考用）:
| モデル | 解像度 | 長さ | APIYI コスト | CNY | 一般 ÷1.1 (¥) | 大口顧客 ÷1.2 (¥) | 公式参考価格 (¥) |
| --------------------------------- | ----- | --- | --------- | ------ | ----------- | ------------- | ---------- |
| `doubao-seedance-2-0-fast-260128` | 720p | 5s | \$0.7253 | ¥5.08 | ¥4.62 | ¥4.23 | ¥4.00 |
| `doubao-seedance-2-0-fast-260128` | 480p | 5s | \$0.3373 | ¥2.36 | ¥2.15 | ¥1.97 | ¥1.86 |
| `doubao-seedance-2-0-260128` | 720p | 5s | \$0.9074 | ¥6.35 | ¥5.77 | ¥5.29 | ¥4.97 |
| `doubao-seedance-2-0-260128` | 480p | 5s | \$0.4193 | ¥2.94 | ¥2.67 | ¥2.45 | ¥2.31 |
| `doubao-seedance-2-0-260128` | 1080p | 5s | \$2.0288 | ¥14.20 | ¥12.91 | ¥11.84 | ¥12.39 |
| `doubao-seedance-2-0-fast-260128` | 720p | 4s | \$0.5814 | ¥4.07 | ¥3.70 | ¥3.39 | ¥3.20 |
| `doubao-seedance-2-0-fast-260128` | 720p | 8s | \$1.1568 | ¥8.10 | ¥7.36 | ¥6.75 | ¥6.40 |
| `doubao-seedance-2-0-mini-260615` | 720p | 5s | \$0.4508 | ¥3.16 | ¥2.87 | ¥2.63 | ¥2.50 |
| `doubao-seedance-2-0-mini-260615` | 480p | 4s | \$0.1681 | ¥1.18 | ¥1.07 | ¥0.98 | ¥0.93 |
| `doubao-seedance-2-0-mini-260615` | 720p | 15s | \$1.3451 | ¥9.42 | ¥8.56 | ¥7.85 | ¥7.47 |
**3つのモデルは同一価格ではありません — 決して同じと見なさないでください。** 同じ解像度/時間では、token あたりの価格は Mini \< 高速 \< 標準 となり（例: 720p/5s では、Mini ≈ ¥3.16、高速 ≈ ¥5.08、標準 ≈ ¥6.35）、公式の価格段階と一致しています。バッチ生成では、Mini が **最も費用と時間を節約できます**（2026-07 のテストでは、実効単価がプラットフォームの名目レートと完全に一致し、乖離は 0.00% でした）；1080p は標準のみです。
注: 「CNY」はコンソール上の定価です。「General ÷1.1」と「Large customer ÷1.2」は、10% / 20% の [チャージボーナス](/ja/faq/recharge-promotions) 後の実効価格です。ボーナス適用後は価格が公式参考価格にかなり近くなり、1080p の大口顧客価格はさらに公式価格を下回ります。正確な利用情報は返却される `usage.completion_tokens` です。
**課金に関する注意**:
* 最終請求はコンソールのモデル価格とコールログに従います
* **タスクは送信時に事前課金され、完了時に精算されます** — 残高は一時的に変動します。コールログと照合してください。動画 1 本につき課金エントリが **2 件** 発生します（下の「ログ内の課金の読み方」を参照）
* 拒否されたリクエスト（HTTP 400 のパラメータエラーなど）は **課金されません**（確認済み）
* 料金は時間に比例して増えます。15 秒の動画は 5 秒の約 3 倍です
### ログの課金の読み方（事前チャージ + 清算）
`api.apiyi.com/log` のコンソールのログページを開き、モデル名 `doubao-seedance-2-0` を検索すると、すべての課金を確認できます。**1本の動画で2件の課金エントリが発生します**:
1. **事前チャージ**: タスク送信時に差し引かれる見積額（「non-streaming」とラベルされたログエントリで、token とグループを表示）— 下のスクリーンショットでは \$0.449998
2. **清算（追加請求または返金）**: タスク完了後、実際に生成された token に基づいて差額が清算されます（「streaming」とラベルされたログエントリで、completion token 数を表示）— 下では \$5.611858; **1080p は通常、追加課金が発生します**
清算エントリには **token もそのグループも表示されません** — これは正常です。2件の合計が動画の総コストです。
**時間フィールドの見方**:
1. 最初のエントリ（事前チャージ）のタイムスタンプは動画の**送信時刻**です。その「first byte」値は、送信して task ID を返すまでにかかった時間です（例: `首字节:3秒` / first byte: 3 s）— **生成時間ではありません**
2. 清算エントリには `流式`（ストリーミング）と `首字节:<1秒`（1 s 未満の first byte）が表示されますが、これらは清算レコード上の内部マーカーにすぎず、**問題の兆候ではありません**
3. 動画の実際の**生成時間**は、上部ナビゲーションの「Async tasks」ページ（`api.apiyi.com/task`）にある「耗时」（経過時間）列です
最初のスクリーンショットにある 15 s の 1080p 動画では、総コスト = 0.449998 + 5.611858 = **\$6.061856** です。対応するタスクパラメータは `api.apiyi.com/task` 上部の「Async tasks」で確認でき、課金内容と完全に一致します:
```json theme={null}
{
"id": "cgt-20260703185641-9nbbg",
"model": "doubao-seedance-2-0-260128",
"status": "succeeded",
"duration": 15,
"resolution": "1080p",
"ratio": "3:4",
"framespersecond": 24,
"generate_audio": true
}
```
732,108 の completion token ≈ 15 × 1248 × 1664 × 24 / 1024（1080p の 3:4 動画は 1248×1664 を出力します）— 課金計算式と一致しています。
この 15 s の 1080p 動画の総額は約 **¥42.4**（固定 1:7 レートでの名目上の課金）です。[チャージ特典](/ja/faq/recharge-promotions) を含めると実質コストは約 ¥35-39 で、同仕様の公式参考値は約 ¥37.2 です。**公式価格そのものも安くはありません** — コストは **モデル + 解像度 + 長さ** で決まり（fast / 720p / 5 s に切り替えると、はるかに安くなります）、このモデルは供給を確保するために薄利で提供されており、大口チャージのお客様にはより大きな割引があります。
**ベータ供給に関するお知らせ**: Seedance 2.0 は現在ベータ供給段階にあります。実際の課金が上記の表から大きくずれる場合は、カスタマーサポートまでご連絡ください。調整いたします。料金は上流側のポリシー（たとえば、後日より安価な公式版が出た場合など）と APIYI の供給能力に応じて動的に調整されます。対応可能なチャネルパートナーの方はぜひご連絡ください。このモデルは **供給を確保してお客様に提供するため** の価格設定であり、利益目的ではありません。
## グループ設定
Seedance 2.0 は専用の **`SeeDance2` グループ**（0.18x レート、CNY建て）で動作します。これには 2 つの **厳格な要件** があります。① token の課金モデルは **Pay-as-you-go Priority**（または Pay-as-you-go）である必要があります。-per-request token ではルーティングできません。② token で **`SeeDance2` グループ** を有効にしておく必要があります。Default グループや他の動画グループの token は、"**このモデルで利用可能なチャネルがありません**" で失敗します。
| グループ | レート | 使いどき |
| ----------- | ----- | -------------------------------------------------- |
| `SeeDance2` | 0.18x | Seedance 2.0 を提供する唯一のグループ — 同時実行数に余裕があり、待ち行列はありません |
**なぜ 0.18x なのか？** システム内蔵の Seedance 2.0 の単価は Volcengine の公式リスト価格と一致しますが、そのリストは **CNY** 建てで、APIYI の残高は **USD** 建てです（USD/CNY は固定で 1:7）。1x レートだと実質的に公式価格の 7 倍請求になるため、為替変換を吸収するようグループのレートを下げています: **0.18 × 7 = 1.26**、つまり名目請求額は公式の CNY 価格のおよそ 1.26 倍です。[チャージボーナス](/ja/faq/recharge-promotions) を加味すると、通常ユーザーの支払いは公式価格よりおよそ 10% 高くなりますが、高額チャージのお客様は同水準、あるいはそれ以下になります（たとえば 1080p ティア）。
**ご注意ください**: 課金は常に **実際の token 使用量** に基づき、token 換算には自然なぶれが少しあります（±5% は通常です）。公式リスト価格はあくまで **参照基準** であり、リクエストごとの保証ではありません。現在の価格設定は供給優先の妥当な取り決めです — いつも **チャージボーナスと合わせて** 評価してください。請求額に違和感があれば、いつでも一緒に請求の突合確認をします。ただし、「なぜ公式価格より少し高いのか」は議論の対象ではありません — その点をご理解のうえ、そこが気になる場合はこのチャネルは使わないでください。逆に、**同時実行数に余裕があり待ち行列がない** ことこそが、このチャネルの提供価値です。
推奨される token 構成は 2 つあります。
| 構成 | 向いている用途 | 方法 |
| ------------------- | ----------------- | ----------------------------------------------------------------------------- |
| **A. 共有 token 1 つ** | 個人プロジェクト、複数モデルの併用 | 既存の token のグループ一覧に **`SeeDance2`** を追加し、課金モデルは Pay-as-you-go Priority のままにします |
| **B. 専用 token** | 本番ワークロード、課金の分離 | **`SeeDance2`** グループのみを持つ token を作成します — レポートがすっきりし、事業ラインごとのクォータ通知も分かりやすくなります |
本番環境では **B（専用 token）** をおすすめします: 課金が明確で、ラインごとのクォータ管理ができ、利用が急増したときの切り分けもしやすくなります。
## 技術仕様
| Dimension | Value |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------- |
| **Models** | `doubao-seedance-2-0-260128`（標準） / `doubao-seedance-2-0-fast-260128`（高速） / `doubao-seedance-2-0-mini-260615`（ミニ） |
| **Resolutions** | 480p / 720p / 1080p（1080p は標準のみ対応；高速とミニは 720p まで） |
| **Aspect ratios** | `16:9` `4:3` `1:1` `3:4` `9:16` `21:9` `adaptive`（デフォルトはアダプティブ） |
| **Duration** | 4〜15 の整数秒、または `-1` がモデル選択（デフォルト 5） |
| **Frame rate** | 固定 24 fps（`frames` パラメータはサポートされません） |
| **Audio** | `generate_audio` のデフォルトは `true`；モノラル |
| **Input images** | jpeg/png/webp/bmp/tiff/gif/heic/heif；アスペクト比 (0.4, 2.5)；辺の長さ (300, 6000) px；各 30 MB 未満 |
| **Input video/audio** | Seedance 2.0 のみ；音声は wav/mp3、各クリップ 2〜15 秒、最大 3 クリップ、画像または動画と併用する必要があります |
| **Generation time (measured)** | 5 s @720p: 約 2〜5 分；1080p: 約 3 分；15 s: 約 4.5 分；ミニはより高速（5 s @720p: 約 1.5〜2.5 分；15 s: 約 3 分） |
| **Response fields** | `content.video_url`（mp4 直リンク、**24 時間で期限切れ**）、`usage.completion_tokens` |
| **Task retention** | task\_id は 7 日間照会可能 |
## API エンドポイント
| Endpoint | 用途 | Content-Type |
| ------------------------------------------------------ | ------------------------------- | ------------------ |
| `POST /seedance/api/v3/contents/generations/tasks` | 動画生成タスクを作成します | `application/json` |
| `GET /seedance/api/v3/contents/generations/tasks/{id}` | タスクのステータスをポーリング / 動画 URL を取得します | — |
**Domains**: `api.apiyi.com` は主要ゲートウェイです。`vip.apiyi.com` とその他のプラットフォームドメインは同一の動作をします。パスプレフィックスは `/seedance/api/v3` です — **`/api` セグメントを削除しないでください**。また、`/v1/videos` は使用しないでください。
## 解像度とアスペクト比の詳細
解像度ティアは短辺ではなく、**ピクセル面積**を定義します。各アスペクト比ごとの実際の出力サイズ（公式値、テストで確認済み）:
| Ratio | 480p | 720p | 1080p（標準のみ） |
| ---------- | ------------------------ | -------- | ----------- |
| `16:9` | 864×496 | 1280×720 | 1920×1080 |
| `4:3` | 752×560 | 1112×834 | 1664×1248 |
| `1:1` | 640×640 | 960×960 | 1440×1440 |
| `3:4` | 560×752 | 834×1112 | 1248×1664 |
| `9:16` | 496×864 | 720×1280 | 1080×1920 |
| `21:9` | 992×432 | 1470×630 | 2206×946 |
| `adaptive` | モデルが入力に基づいて上記のいずれかを選択します | 同じ | 同じ |
### アダプティブの仕組み
1. **Text-to-video**: モデルがプロンプトから最適なアスペクト比を推論します
2. **First+last / first frame**: 最初のフレーム画像のアスペクト比に一致します（不一致の画像は中央でトリミングされます）
3. **Multi-modal reference-to-video**: プロンプトの意図に従い、それ以外の場合は最初のメディア項目です（video は画像より優先されます）
4. 実際に使用されたアスペクト比は、タスク応答の `ratio` フィールドで返されます
`ratio` は上記の 7 つの enum 値のみを受け付けます。たとえば `"2:1"` を渡すと `InvalidParameter` エラーが返り（確認済み）、4-15 の範囲外の `duration` も同様です。どちらも課金されません。
## ベストプラクティス
1080p または最高品質には標準モデル`doubao-seedance-2-0-260128`を選びます。バッチ制作やコスト重視のワークロードには lite モデル`doubao-seedance-2-0-mini-260615`を選びます（**標準価格の約半額で、生成速度が最速**、720p 上限）。その中間には `fast` を選びます。
image-to-video ではデフォルトの `adaptive` のままにして、モデルが元画像の比率に合わせるようにします。ターゲットのプラットフォームで必要な場合にのみ、`9:16`（縦向き）または `16:9`（横向き）を固定します。
コストは長さに比例して増えます。まずは 5 s のクリップでプロンプトを検証し、その後 10-15 s に拡張します。テンポをモデルに任せたい場合は `duration: -1` を使います。
`generate_audio` はデフォルトで true です。自分で音を付ける予定の無音映像には `false` を指定します。
話すセリフはプロンプト内で二重引用符で囲みます — モデルが一致する音声を自動的に生成します。
ゲートウェイはレスポンスを `content-encoding: gzip` とラベル付けしますが、本文は未圧縮です。Python requests のような自動展開するクライアントでは `ContentDecodingError` が発生します。`Accept-Encoding: identity` ヘッダーを追加するとこれを回避できます（curl は影響を受けません）。
タスクは通常 2-5 分で完了します。`content.video_url` は 24 時間有効な署名付きリンクです。タスクが成功したらすぐにファイルを自分のストレージへコピーしてください。
`return_last_frame: true` を設定すると、透かしのない最後のフレーム png を取得できます。それを次のタスクの最初のフレームとして使い、連続した複数クリップの動画を作成します。
## エラーコードと再試行
| コード | 意味 | 推奨対応 |
| -------------- | -------------------------------------------------------------- | -------------------------------------------------- |
| `400` | `InvalidParameter`: 解像度/比率/継続時間が不正です（例: fast または mini + 1080p） | メッセージに不正なパラメータ名が示されています — 上の表に従って修正してください。課金されません |
| `401` | 無効な Token | Bearer Token を確認してください |
| `403` | コンテンツモデレーションによる拒否（実在の顔、ポリシー違反） | アセットまたは prompt を変更してください |
| `429` | レート制限中 / クォータ不足 | 指数バックオフを行ってください。残高を確認してください |
| `5xx` | ゲートウェイ / バックエンドエラー | 1〜2回再試行してください |
| Task `failed` | 生成に失敗しました | タスクの error フィールドを確認してください。必要に応じて別の seed で再試行してください |
| Task `expired` | `execution_expires_after` を超過しました（デフォルト 48 h） | 再送信してください |
**クライアント向けの推奨事項**:
* create/poll 呼び出しには 30〜60 s のリクエストタイムアウトで十分です（待機はタスク側で発生します）
* 15〜30 s ごとにポーリングし、全体の予算は **15 分以上** にしてください（1080p / 15 s タスクではさらに長くしてください）
* 5xx とタイムアウトには **指数バックオフ** を適用してください（2回再試行）
* トラブルシューティングのためにタスク `id` と `x-request-id` レスポンスヘッダーを記録してください
## FAQ
Seedance 2.0 で最も多いエラーです。Token に `SeeDance2` グループが有効化されていません。Default グループや他の動画グループの Token は、このモデルへルーティングできません。Token Settings で `SeeDance2` グループを有効にし、従量課金の Priority 課金モデルを使用してください。
ゲートウェイの `content-encoding: gzip` ヘッダーが実際の本文エンコーディングと一致していません。症状には `ContentDecodingError`、切り詰められた JSON ではない本文（例: 先頭の `{"` が失われ、`id":"cgt-xxx"}` しか返らない）、または断続的な 400 エラーが含まれます。リクエストヘッダーに `"Accept-Encoding": "identity"` を追加してください。curl とブラウザの fetch には影響しません。
`generate_audio` の既定値は `true` です（確認済み）。このモデルは音声、効果音、BGM を自動で追加します。無音出力にしたい場合は、`"generate_audio": false` を明示的に指定してください。
成功時、URL は poll 応答の `content.video_url` にあります（**トップレベルではありません**）。これは約24時間有効な署名付きリンクです。すぐにダウンロードして再ホストしてください。task\_id 自体は 7 日間照会可能です。
状態マシンは `queued → running → succeeded / failed / expired` です。成功状態は **`succeeded`** であり、`completed` ではありません。これは他の動画 API から移行する際によくある間違いです。
いいえ。Seedance 2.0 は、実在の人間の顔を含む参照画像/動画を拒否します（上流のコンテンツ安全性）。代替案として、過去 30 日以内に Seedance モデルで生成した顔を含む出力を再利用する、プラットフォームのプリセット仮想アバター（`asset://` IDs）を使う、またはライセンス済みの顔素材を使ってください。
パラメータ拒否（HTTP 400）は **課金されません**（確認済み）。課金は送信時に事前チャージされ、完了時に精算されるため、残高は一時的に変動します。呼び出しログと照合してください。
`tokens ≈ duration(s) × width × height × 24 / 1024`、0.1% 以内で確認済みです。各階層のすべての比率は同じピクセル面積です（720p の 16:9 と 9:16 はどちらも 5 s あたり 108,900 tokens です）— **横長、縦長、正方形はすべて同額です**。
価格と速度は mini \< fast \< 標準 の順です（プラットフォーム上の 720p/5s の名目価格: 約 ¥3.16 / ¥5.08 / ¥6.35）。**バッチ生成やコスト重視のワークロードには mini を選んでください**。標準価格の約半額で、生成も最速です（2026-07 測定: 720p で 5 s あたり約 1.5〜2.5 分）。1080p や最大限のディテールには標準を、間を取るなら fast を選んでください。mini と fast はどちらも 720p が上限です。1080p を要求すると 400 のパラメータエラーが返り、課金されません。
モデルが 4〜15 s の間で長さを選び（当社のテストでは 10 s の動画が生成されました）、実際の出力に基づいて課金されます。最終的な長さは task の `duration` フィールドに返されます。コストの予測しやすさを重視する場合は、duration を明示的に固定してください。
いいえ。`frames` と `camera_fixed` は Seedance 1.x のパラメータで、**Seedance 2.0 シリーズではサポートされていません**。代わりに整数秒の `duration` を使ってください。
いいえ。これらは 3 つの**排他的**モードです: first+last（`first_frame`/`last_frame` の役割が必須の 2 枚の画像）、first frame（1 枚の画像）、およびマルチモーダル reference-to-video（0-9 images + 0-3 videos + 0-3 audios、少なくとも 1 image または 1 video、image role `reference_image`）。「first/last frame + reference」に近づけたい場合は、reference モードを使い、prompt でフレームを指定してください。
SeeDance2 グループは同時実行数に十分な余裕があり、キューはありません（当社のテストでは 15 件の同時 task がすべて即時に実行されました）。より大きな継続ワークロードについては営業にお問い合わせください。
prompt は中国語で約 500 文字、英語で約 1000 words 未満にしてください。長すぎる prompt はディテールを薄めます。対応言語: 中国語、英語、日本語、スペイン語、ポルトガル語、インドネシア語。被写体 + 動作 + カメラの動き + ライティング/スタイルを記述してください。
## 関連ドキュメント
* [動画生成 API リファレンス＆プレイグラウンド](/ja/api-capabilities/seedance2/video-generation) - `POST /seedance/api/v3/contents/generations/tasks`
* [Sora 2 動画生成](/ja/api-capabilities/sora-2/overview) - OpenAI公式リレー動画チャネル
* [VEO 3.1 動画生成](/ja/api-capabilities/veo-3-1-official/overview) - Google公式動画チャネル
* [チャージ特典](/ja/faq/recharge-promotions) - 実効コストは公式チャネルとほぼ同等です
* [APIマニュアル](/ja/api-manual) - 一般的な呼び出し方法
Seedance 2.0 は、デフォルトで同期音声を出力する数少ない2026年の第一線動画モデルの一つです。同一価格のアスペクト比と15秒の上限を組み合わせることで、ショート動画やEC素材制作の主要チャネルとして非常に有力です。代替手段を比較する場合、同じ token（追加のグループを有効化した場合）で Sora 2、VEO 3.1、Wan2.7 を直接呼び出せます。