Seedance 2.0 API ガイド
まず結論 · Seedance 2.0 は MaxAPI の動画生成 API で bytedance/seedance-2.0 を指定します。タスク ID を保存して最終結果を問い合わせます。受付は完成ではなく、素材、長さ、解像度はモデルとルートの条件を確認してください。
接続仕様の確認日 ·
MaxAPI の公開カタログ、ゲートウェイ実装、ローカル回帰ケースで確認した接続情報です。共通処理の確認は各モデルのエンドツーエンドテストではなく、上流の現在の稼働状況や性能の報告でもありません。
導入前の確認事項
以下は MaxAPI の公開設定です。選択したルートに追加の入力条件や利用条件がある場合があります。
- リクエストのモデル ID
bytedance/seedance-2.0- 出力の種類
- 動画
- Base URL
https://api.maxapi.dev- 生成フロー
- 非同期タスク+ポーリング
- 品質の設定値
4k / 1080p / 720p / 480p- 解像度とサイズ
- 4k / 1080p / 720p / 480p
- 動画の長さ
- 掲載中の Seedance 2.0 モデルは 4〜15 秒です。
参照素材を準備する前に生成モードを選びます。画像、動画、音声では役割が異なります。このモデルの API タブにあるフィールドと制限を確認してください。タスクの受付は動画の完成を意味しません。
モデルの特徴と選び方
参照で映像と音を設計
ByteDance は Seedance 2.0 を、テキスト・画像・音声・動画の参照によって演技、照明、カメラを制御する音声映像同時生成モデルとしています。MaxAPI 標準入口には Fast や Mini にない 1080p・4K もあります。
出典確認 ·
このモデルの出典: ByteDance · Seedance 2.0 · BytePlus · Seedance 2.x capability comparison
比較するとよい用途
参照、動き、構図に具体的な要件がある場合や 1080p・4K が必要な場合に比較します。最大 30 秒の長い物語が必要なら 2.5 を別途評価します。
制限と注意点
音声映像同時生成でも任意の素材組合せが有効とは限りません。API タブのモードに従い、全編のタイミング、音、物体の連続性を確認します。
提供元の能力説明は MaxAPI の全機能を示すものではありません。この入口に記載したパラメータ、入力、ルートを使用してください。速度や品質の位置付けはサービス保証ではありません。
MaxAPI でのリクエスト処理
どのルートが優先される?
ルートの優先順は API キーの route_modes リスト → リクエストで明示したルート → モデルの既定ルートです。キーに空でないリストがある場合、リクエストの route_mode より優先します。ルート比較の前にキー設定を確認してください。
ユーザーの RPM は配下のキーで共有
ユーザーの有効な RPM 上限は配下のキーで共有します。キーはより厳しく制限できますが、ユーザー上限を超えて許可できません。ユーザーが 200 RPM ならキーごとに 200 RPM ではありません。サービス全体の RPM と同時実行制御も適用されます。
ルートと料金
公開ルート:official-cheap、official。画像/動画の JSON リクエストでは route_mode、Gemini ネイティブでは X-MaxAPI-Route-Mode を指定します。ルートは接続先と課金の選択であり、別の公開モデル ID ではありません。
| ルート | 公開基本料金 | 課金単位 |
|---|---|---|
official | $7 | 480p / 720p · 参照動画なし · 100 万トークンあたり |
official | $4.3 | 480p / 720p · 参照動画あり · 100 万トークンあたり |
official | $7.7 | 1080p · 参照動画なし · 100 万トークンあたり |
official | $4.7 | 1080p · 参照動画あり · 100 万トークンあたり |
official | $4 | 4K · 参照動画なし · 100 万トークンあたり |
official | $2.4 | 4K · 参照動画あり · 100 万トークンあたり |
official-cheap | $6.3 | 480p / 720p · 参照動画なし · 100 万トークンあたり |
official-cheap | $3.87 | 480p / 720p · 参照動画あり · 100 万トークンあたり |
official-cheap | $6.93 | 1080p · 参照動画なし · 100 万トークンあたり |
official-cheap | $4.23 | 1080p · 参照動画あり · 100 万トークンあたり |
official-cheap | $3.6 | 4K · 参照動画なし · 100 万トークンあたり |
official-cheap | $2.16 | 4K · 参照動画あり · 100 万トークンあたり |
1 クレジット = 1 米ドル。以下はカタログの基本料金で、アカウントの見積額ではありません。アカウント倍率が適用されます。Seedance は提供元が報告する出力トークンで課金します。トークン数 ≈(出力秒数+参照動画の秒数)× 幅 × 高さ × 24 / 1024 で、720p・16:9 では毎秒約 21,600、4K では毎秒約 194,400 です。「参照動画あり」の単価はリクエストに参照動画が 1 本以上ある場合のみ適用され、参照画像・先頭/末尾フレーム・音声は参照なしの単価です。参照動画がある場合、提供元は少なくとも「出力秒数+⌈出力秒数×⅔⌉」分を課金します(動画入力時の最低使用量)。送信時に見積額を仮押さえし(参照動画がある場合は最大 15 秒、Seedance 2.5 は 30 秒の参照動画分を含む)、報告されたトークン数で精算して差額を返金します。失敗したタスクは課金されません。
現在の料金を確認最初のリクエスト
MaxAPI の API キーはサーバー環境の MAXAPI_KEY に設定し、ブラウザーに埋め込まないでください。キーのルート一覧が設定済みならリクエスト指定より優先され、一覧が空ならリクエスト指定、両方なければモデルの既定ルートを使います。API 呼び出しは課金される場合があります。
POST /v1/videos/generationsGET /v1/videos/generations/{task_id}
curl -X POST "https://api.maxapi.dev/v1/videos/generations" \
-H "Authorization: Bearer $MAXAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "bytedance/seedance-2.0",
"prompt": "a calm ocean wave at sunrise, slow camera pan",
"ratio": "16:9",
"duration": 5,
"mode": "text_to_video",
"resolution": "1080p"
}'最初の結果を確認
リクエスト仕様の確認 ·
公開カタログとゲートウェイのコードで確認した形式例です。有料モデルの実測、遅延測定、全ルートの現在の利用可能性を保証するものではありません。
送信する項目
model / mode- 最初は bytedance/seedance-2.0 と mode=text_to_video を使います。Seedance 2.5 の Ark 形式や廃止された Beta ID と混同しないでください。
duration / resolution / ratio- 例は 5 秒です。掲載解像度:4k、1080p、720p、480p。料金比較では時間、解像度、参照動画の有無を固定します。
HTTP 202 / id / poll_url- 受付成功は動画の完成ではありません。クライアントを閉じる前に id と poll_url を保存します。JSON の識別子は task_id ではなく id です。
実際の結果を読む
status / video- 同じアカウントの認証で照会します。queued/running は処理中、succeeded では最上位の video URL を確認し、failed/canceled では message を確認します。
estimated_charge_credits- 受付時の料金は見積もりで、最終請求ではありません。利用・請求記録で確認し、完了と動画のダウンロード成功も区別してください。
{
"id": "example-task-id",
"object": "video.generation.task",
"status": "queued",
"model": "bytedance/seedance-2.0",
"poll_url": "/v1/videos/generations/example-task-id"
}# Set TASK_ID to the saved response.id; this queries, it does not create a task.
curl --fail-with-body "https://api.maxapi.dev/v1/videos/generations/${TASK_ID:?Set TASK_ID from response.id}" \
-H "Authorization: Bearer $MAXAPI_KEY"HTTP ステータスだけでなく症状で判断する
429rate_limit_exceeded / capacity_exhausted
- 判断のポイント
- 429 はユーザー/キーの RPM、サービス全体、生成容量などで発生します。Retry-After と返された X-RateLimit-*/X-Global-* ヘッダーを使って判断してください。
- 次の対処
- Retry-After があれば従い、原因に応じて頻度や同時処理数を下げ、回数制限付きで再試行します。全体容量は各アカウントの専用枠ではありません。
活用シーンとワークフロー
以下の用途とプロンプトは評価用の提案であり、提供元のベンチマークや実測出力ではありません。

AI で制作したコンセプト画像です。このモデルの出力例・評価結果ではありません。下記のプロンプトは出発点であり、画像の再現手順ではありません。
制作の実践・共通のヒント
エフェクトより先にショットを設計する
Seedance 2.0 では被写体、場面、カメラの意図を先に決めます。商品紹介なら素材の細部から引く、日常シーンなら固定カメラで被写体を動かす、といった指示です。短いクリップに無関係な場所や動作を詰め込まず、編集しやすい単一ショットから始めてください。
配図はビジュアルの方向性で、動画生成の実例ではありません。開始、中間の変化、最後のフレームを順に記述し、全編で動き、形、構図を確認します。参照モードと素材フィールドは選択したモデルのドキュメントに従ってください。

用途に合わせて使えるプロンプト例
よいプロンプトは短い制作指示書です。被写体や制約を実際の要件に置き換え、サイズ、ルート、品質は文章だけでなく API パラメータでも指定してください。
01 / 参照商品のワンショット紹介
提供の商品画像を参照し、素材の接写から 8 秒で滑らかに引いて暗い展示台の全体を見せる。比率とラベルを維持し、商品は動かさずカメラだけ動かす。最後は商品全体が明瞭な構図。カットや文字は加えない。出力後の確認 · 最後だけでなく引いていく途中も細部の一貫性を確認します。

絵コンテから使えるクリップへ
合格基準を決める
代表的な入力と利用可能な出力の条件を決めます。理想例だけでなく難しい例も含め、比較中はパラメータを固定します。
実行と表示を分ける
リクエスト ID と元の応答を保存してから表示用に変換します。エラーや未完了を明示し、画面のタイムアウトで重複実行しないようにします。
呼び出し成功だけでなく実用性を測る
モデル、ルート、入力特性、実際の使用量、確認結果を記録します。実用的な成果物の費用には、手修正と再試行も含めて評価します。

テストから本番運用へ
本番と同じルートで試す
最初の比較はモデル、ルート、パラメータを固定します。通常の入力だけでなく大きなファイルや例外もテストしてください。公開仕様がすべての上流チャネルの動作を保証するわけではありません。
制限と生成エラーを分ける
429 ではリクエスト頻度や同時実行数を下げ、間隔を空けて再試行します。無効な入力は先に修正してください。調査用の ID を保存し、API キーや機密素材を公開ログに残さないでください。
利用可能な結果と実費を記録
アカウントの利用・請求記録で最終結果と料金を確認します。HTTP の成功がタスク受付のみを示す場合もあります。公開前に生成内容と参照素材の利用権を確認してください。
確認済みの接続ケース
MaxAPI の公開カタログ、ゲートウェイ実装、ローカル回帰ケースで確認した接続情報です。共通処理の確認は各モデルのエンドツーエンドテストではなく、上流の現在の稼働状況や性能の報告でもありません。
複数キーでユーザー上限を共有
ローカル回帰テスト・合格- テスト条件
- 同一アカウントの 2 キーと少量のユーザー枠をメモリー内の制限器で使用。
- 確認した結果
- 両キーのリクエストが同じユーザー枠を消費し、超過を制限。大きいキー枠はユーザー枠を上書きせず、小さいキー枠も有効。
よくある質問
このモデルを選ぶ用途は?
参照、動き、構図に具体的な要件がある場合や 1080p・4K が必要な場合に比較します。最大 30 秒の長い物語が必要なら 2.5 を別途評価します。
この入口で特に注意する制限は?
音声映像同時生成でも任意の素材組合せが有効とは限りません。API タブのモードに従い、全編のタイミング、音、物体の連続性を確認します。
route_mode を変えてもルートが変わらないのはなぜ?
ルートの優先順は API キーの route_modes リスト → リクエストで明示したルート → モデルの既定ルートです。キーに空でないリストがある場合、リクエストの route_mode より優先します。ルート比較の前にキー設定を確認してください。
各 API キーにユーザーの RPM 枠が付くのですか?
ユーザーの有効な RPM 上限は配下のキーで共有します。キーはより厳しく制限できますが、ユーザー上限を超えて許可できません。ユーザーが 200 RPM ならキーごとに 200 RPM ではありません。サービス全体の RPM と同時実行制御も適用されます。
このローカル回帰テストは実稼働の性能を証明しますか?
ローカルテストは模擬リクエスト・応答とテスト用ストレージを使い、有料モデルには接続しません。画像品質、実稼働の成功率・遅延、参照上限のエンドツーエンド動作を証明するものではなく、配図もテスト出力ではありません。
Seedance 2.0 のモデル ID は?
bytedance/seedance-2.0 を使用します。エンドポイント形式はサンプルに従ってください。Gemini ネイティブの URL は短いモデル名を使用します。
掲載料金はすべてのアカウント・ルートで同じですか?
1 クレジット = 1 米ドル。以下はカタログの基本料金で、アカウントの見積額ではありません。アカウント倍率が適用されます。Seedance は提供元が報告する出力トークンで課金します。トークン数 ≈(出力秒数+参照動画の秒数)× 幅 × 高さ × 24 / 1024 で、720p・16:9 では毎秒約 21,600、4K では毎秒約 194,400 です。「参照動画あり」の単価はリクエストに参照動画が 1 本以上ある場合のみ適用され、参照画像・先頭/末尾フレーム・音声は参照なしの単価です。参照動画がある場合、提供元は少なくとも「出力秒数+⌈出力秒数×⅔⌉」分を課金します(動画入力時の最低使用量)。送信時に見積額を仮押さえし(参照動画がある場合は最大 15 秒、Seedance 2.5 は 30 秒の参照動画分を含む)、報告されたトークン数で精算して差額を返金します。失敗したタスクは課金されません。
失敗したリクエストにも課金されますか?
MaxAPI の公開ルールでは失敗したリクエストに課金しません。処理中に残高が一時的に予約される場合があるため、最終的なタスク結果と請求記録を確認してください。
API キーでルートを利用できないのはなぜですか?
モデル、アカウント権限、API キーで許可されたルートによって利用可否が決まります。料金の掲載は利用権限の付与ではありません。
結果を処理する前に何を確認しますか?
参照素材を準備する前に生成モードを選びます。画像、動画、音声では役割が異なります。このモデルの API タブにあるフィールドと制限を確認してください。タスクの受付は動画の完成を意味しません。
失敗やタイムアウトの直後に再送すべきですか?
まず制限、入力エラー、処理中のタスクを区別します。タスク ID がある場合は新たに生成する前に状態を確認し、再試行可能なエラーにだけ回数制限付きのバックオフを使ってください。