Apimart
ログイン新規登録
Seedance 2 Mini API：高速で低価格な AI 動画

Seedance 2 Mini API：高速で低価格な AI 動画

ByteDance Seedance 2 Mini の開発者向けガイド。入力、出力仕様、$0.081/秒前後の料金、高速・低コストなショート動画向け非同期 API フローを解説します。

モデル解説

短い AI 動画クリップを素早く作る必要があるなら、Seedance 2 Mini は仕上げ優先ではなく下書き優先のモデルに見えます。 記事から見える限り、主なトレードオフはシンプルです：低コストと短い待ち時間が得られますが、最上位の出力品質を一部諦めます。

要点をまとめると次のとおりです：

  • 私なら Seedance 2 Mini (seedance-2-0-fast) を 5～15 秒のクリップに使います
  • テキスト、画像、動画、音声の入力に対応します
  • 24 fps の MP4 を返します
  • 480p、720p、1080p に対応します
  • 5 秒の 720p クリップは約 35～48 秒と記載されています
  • コストはソース内で 2 通りに説明されています：
    • 1 クリップあたり約 $0.05～$0.10
    • そして $0.081/秒 （5 秒で $0.41）
  • タスク ID、ポーリング、または Webhook を伴う非同期 API フローで動作します
  • 生成されたファイルのリンクは 24 時間で失効します
  • 最適な用途：広告テスト、短い SNS クリップ、製品ティザー、バッチアイデアテスト

最も重要なのは使い方です。私は Mini をすべてのジョブの最終レンダリングティアとしては扱いません。初回パスのモデルとして扱います：480p または 720p でプロンプトをテストし、クリップを短く保ち、仕上げが重要なら最良のアイデアを Sora 2 のような上位ティアに移します。

Seedance 2 Mini vs Standard: Speed, Cost & Quality Compared
Seedance 2 Mini vs Standard：速度・コスト・品質の比較

Seedance 2.0 API へのアクセス方法（動画ウォークスルー）

クイック比較

モデル主な用途解像度5 秒のコスト標準的な待ち時間最適な用途
Seedance 2 Mini / Fast低コストの下書き480p、720p、1080p160 クレジット約 30～90 秒広告フック、SNS テスト、バッチバリエーション
Seedance 2.0 Standard上位の出力最大 2K240 クレジット約 45～120 秒最終ブランド動画、仕上げ済み納品

記事からいくつかの点が際立ちます。

第一に、このモデルはショートフォーム生成を中心に設計されています。つまり、リクエストの設定が非常に重要です。アップロードするアセットには次のような制限があります：

  • 画像： 最大 30 MB
  • 動画： 2～15 秒、50 MB 未満
  • 音声： MP3 または WAV、各最大 15 MB
  • 最大 3 つの音声ファイル
  • 最大 9 枚の画像リファレンス
  • 最大 3 本の動画リファレンス

第二に、記事はプロンプト構造が依然として重要であることを示しています。ショット + 被写体 + 動き + 設定 + 照明 + スタイルのようなシンプルな形式が、出力をより狙いどおりに保つのに役立つはずです。リップシンクでは、プロンプト内の引用された発話がソースに記された引き金です。

第三に、これは注意してパイプラインに組み込むべきモデルに見えます。私なら必ず次を行います：

  • タスク ID を保存する
  • ジョブステータスをポーリングするか Webhook を使う
  • バックオフで 429 制限を処理する
  • リトライ前に 402 クレジットエラーをキャッチする
  • URL が 24 時間で失効するため、完成した動画をすぐにダウンロードする

記事はもう 1 つ有用なワークフローも指摘しています：最後のフレームを要求してクリップを連鎖させ、そのフレームを次のリクエストに渡すことです。これはマルチショットシーケンスのぎこちなさを減らすシンプルな方法です。

つまり私の結論は単純です：Seedance 2 Mini は、ボリューム・短いクリップ・ターン時間が最上の仕上げよりも重要なときに最も理にかなっています。 広告テスト、縦型 SNS 下書き、製品ティザーを作っているなら、良い最初の立ち寄り先に見えます。シネマティックなリアリズムが必要なプロジェクトには、Kling V3 が強力な代替を提供します。より仕上がった最終物が必要なら、私なら Mini で勝者を見つけ、そのコンセプトを Google Veo 3.1 のような上位ティアで再実行します。

以下では、完全なガイドがモデルの設定、リクエストフロー、料金、制限、本番のヒントをより詳しく扱います。

Seedance 2 Mini：背景とコンテキスト

Seedance 2 Mini

Seedance 2 Mini は ByteDance の Seedance 2.0 ファミリーにおける高速・低コストのティアです。短いクリップと高速イテレーション向けに作られています。そのトレードオフは、入力制限、出力オプション、そしてリクエストの設計方法に現れます。

Seedance 2 が内部でどう動くか

これらのアーキテクチャの選択が、Mini が長尺レンダリングよりも短く繰り返し可能なジョブに適している理由を説明するのに役立ちます。

Seedance 2.0 は Dual-Branch Diffusion Transformer アーキテクチャを使い、動画と音声を 1 パスで一緒に生成します [6][9]。平たく言えば、これにより後から音声を足すのではなく、生成中にビジュアルとサウンドの同期を保てます。また、テキスト、画像、動画、音声のリファレンスを含むマルチモーダル入力にも対応します [6]。

Seedance 2.0 は VBench の動きの一貫性スコア 84.1 を獲得し、これは前バージョンに対して 16.2% の向上でした [3]。また、平均生成レイテンシを バージョン 1.0 と比べて約 40% 削減しました [3]。チームにとって、それはより速いレビューサイクルと、クリップからクリップへのより安定した動きを意味します。

Mini が Seedance 2 ラインナップのどこに位置するか

API で seedance-2-0-fast として記載される Mini は、標準の Seedance 2.0 モデルの下に位置します。標準ティアは品質優先のベースラインです。Mini は速度、イテレーション、そして最上のビジュアル仕上げを追うのではなく多くのクリエイティブバリエーションを生み出すことに調整されています [1][11]。標準モデルより約 19% 安く [11]、5 秒、10 秒、または 15 秒のクリップ向けに作られています [10]。

Seedance 2.0 Mini / FastSeedance 2.0 Standard
主な焦点イテレーション速度とコスト規律最大のシネマティック品質
解像度480p、720p、1080p最大 2K (2,560 × 1,440)
クレジットコスト（5 秒クリップ）160 クレジット240 クレジット
標準的なレイテンシ約 30～90 秒約 45～120 秒
最適なユースケース下書き、広告フック、バッチ発想最終制作、ブランド動画

米国チーム向けのユースケース

Mini は速度が最も重要なワークフローで理にかなっています。広告フックの A/B テスト、TikTok や Reels コンテンツの作成、多くのクリエイティブバリエーションの量産、または教育・マーケティング動画向けの B ロールの制作などを考えてみてください [1][11]。製品の視覚的アイデンティティをそのままに、AI キャンバスエディターを使って静止製品画像を短いティザーにアニメーション化することもできます [5][12]。

よくあるセットアップはシンプルです：Mini で 720p でプロトタイプし、方向性が承認されたら勝ったアイデアを 1080p 以上で再レンダリングします [6]。これにより早期のラウンドを高速に保ち、最終レンダリングを最も納品される可能性の高いコンセプトのために取っておけます。次に、リクエスト設計を形作る入力モード、出力フォーマット、制限を見ていきます。

入力モード、出力フォーマット、制限

これらの速度とコストの利点は、リクエストの設定がしっかりしている場合にのみ成立します。入力の選択、ファイルの上限、出力設定のすべてが、返ってくるものを形作ります。

対応入力：テキスト、画像、動画、音声

Seedance 2 Mini は、1 つのリクエストでテキスト、画像、動画クリップ、音声ファイルを受け取れます。各入力タイプは異なる種類のジョブに対応します。

テキストから動画は、広告モックアップや SNS コンセプトテストへの最速ルートです。プロンプトのみの下書きが欲しいなら、このパスはソースアセットを必要とせずにそこへ到達させます。

画像から動画は、静止画像を動きに変えます。リクエストあたり最大 9 枚の画像リファレンスに対応し、特にチームが静止製品ショットを Amazon や Shopify のリスティング向けの短いアニメーションティザーに変えたいときに Eコマースのユースケースによく合います [12][9]。

動画ガイド生成は、スタイル、カメラの動き、または被写体の動きを導くために最大 3 本のリファレンスクリップに対応します [4][9]。すでに持っているフッテージを作り直すときに、オブジェクトや背景を入れ替えるのにも使えます。

音声条件付き生成では、モデルが音声とビジュアルを 1 パスで作成します。これにより、英語、スペイン語、フランス語、ドイツ語を含む 8 言語以上でリップシンクが可能になります [9]。リップシンクを起動するには、話されるセリフをテキストプロンプト内の二重引用符で囲みます [4]。

プロンプト内でアップロードしたファイルを指す必要があるときは、@ 記号を使います。例えば、@Image1 や @Video1 は指示を特定のアセットにリンクします [12][9]。

アップロード制限はかなり厳しいので重要です：

  • 画像は各最大 30 MB まで
  • 動画ファイルは 2～15 秒で 50 MB 未満でなければなりません
  • 音声アップロードは MP3 または WAV ファイルで各最大 15 MB、合計再生時間 15 秒以下
  • Seedance 2 Mini はリクエストあたり最大 3 つの音声ファイルに対応します [2][12][9]

これらの制限は、API 呼び出しの構築方法と、1 つのリクエストに詰め込めるリファレンスの数に影響します。

出力プロファイル：解像度、再生時間、フレームレート、ファイル配信

出力は固定 24 fps の MP4 ファイルとして返されます [13][2]。クリップ長は 4～15 秒の範囲で、モデルに最終的な長さを決めさせたい場合は自動再生時間に -1 を使えます [12][2][4]。

アスペクト比のプリセットには 16:9、9:16、1:1、4:3、3:4、21:9、3:2 が含まれます [14][9]。画像から動画のリクエストでは、出力がソース画像の寸法に従い黒帯を避けるよう、ratio パラメータを "adaptive" に設定します [2][4]。

アスペクト比480p720p1080p
16:9864 × 4961,280 × 7201,920 × 1,080
9:16496 × 864720 × 1,2801,080 × 1,920
1:1640 × 640960 × 9601,080 × 1,080
21:9992 × 4321,470 × 6301,920 × 822

解像度は、クリップが粗いプレビューとして機能するか、最終納品に近いものとして機能するかを左右します。再生時間の制限は、シーンをより小さなビートに分ける方法を形作ります。

もう 1 つ：生成された動画 URL は 24 時間後に失効します [2]。だからジョブが終わっても何もファイルを掴まなければ、消えてしまうことがあります。パイプラインに自動ダウンロードのステップを組み込み、リクエストが成功したらすぐにファイルを永続ストレージに移してください。

これらの設定は、ストレージ、配信、ポストプロダクションの計画を形作ります。

コンテンツポリシーとプロンプト設計の制約

プロンプトとアップロードはモデレーションを通ります。リアルな暴力、露骨な素材、または実在の人物の無許可ディープフェイクを含むジョブは失敗します [2][9]。1 つの拒否されたタスクがバッチ実行をひそかに凍結させないよう、エラー処理はこれを直接考慮すべきです。

プロンプト構造には、この順序を使います：[Shot type], [Subject description], [Action/motion], [Environment], [Lighting], [Style] [8]。モデルは最大 2,000 プロンプトトークンに対応するため [3]、シーンが必要とするときには詳細なシネマティック指示のための十分な余裕があります。

入力ルール、出力設定、ポリシー制限を整えたら、次のパートは API リクエストフローです。

API を通じた Seedance 2 Mini へのアクセス方法

このワークフローに APIMart がうまく機能する理由

GccAi

入力と出力の制限を把握したら、次のステップはかなりシンプルです：アクセスを得て、認証を処理し、コストを把握することです。APIMart は Seedance 2 Mini 用の 1 つの API エンドポイントを、WAN 2.6 のような他の AI 動画モデルとともに、単一のキーと 1 つの認証フローの下で、USD 課金で提供します [6][16]。米国チームにとって、それは課金とキー管理をずっとすっきりさせます。

ここで Seedance 2 Mini は紙上のモデルであることをやめ、実際の API ワークフローに収まり始めます。APIMart は OpenAI 互換なので、チームがすでにそのリクエストパターンを使っているなら、Seedance 2 Mini の追加には通常ほとんど手直しがいりません。

アカウント設定、API キー、環境構成

始めるのは簡単です。APIMart でアカウントを作成し、API Key Management に移動してサーバーサイドのキーを生成します [15]。

そのキーを環境変数やシークレットマネージャーに保存します。dev、staging、production をまたいで作業しているなら、それぞれに別々の API キーを使います。そうすればテストトラフィックが本番のスループット制限を食わず、使用量も追跡しやすくなります [15]。

すべてのリクエストを Authorization ヘッダーの Bearer トークンとともに送信します [15]：

Authorization: Bearer YOUR_API_KEY

テキスト、画像、動画、音声のリクエストには同じキーとエンドポイントを使います。モデル ID は全体を通して seedance-2-0-fast です [15][2]。

料金とスループットの計画

キーを設定したら、予算は主にクリップ長と解像度に帰着します。Seedance 2 Mini は $0.081/秒で、つまり 5 秒のクリップは約 $0.41、10 秒のクリップは約 $0.81 のコストです [7]。

動画から動画の作業では、トークン料金は 100 万トークンあたり約 $3.90 です。標準的なテキストから動画と画像から動画のジョブは 100 万トークンあたり約 $6.40 のコストです [2]。

解像度はトークン使用量を急速に押し上げ得ます。5 秒の 1080p クリップは約 102,960 トークンを使うため、スケールでジョブを実行するとこれらの選択が重要になります。エンタープライズプランには、ボリューム割引やより高い同時実行制限も含まれることがあります [2][6][17]。

リクエストと本番ワークフローの構築

テキストから動画・画像から動画のリクエストパターン

アクセスを設定したら、リクエストフローはかなりシンプルです。ほとんどの Seedance 2 Mini ジョブは同じ非同期パターンに従います：POST リクエストを送り、task_id を保存し、その後ステータスエンドポイントをポーリングするか、ジョブが終わるまで Webhook を待ちます。

import requests

headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}

payload = {
    "model": "seedance-2-0-fast",
    "prompt": "A barista pours latte art in a sunlit café, slow dolly push in, warm tones, cinematic",
    "resolution": "480p",
    "duration": 5,
    "aspect_ratio": "16:9",
    "generate_audio": True,
    "seed": 12345
}

response = requests.post("YOUR_GENERATION_ENDPOINT", headers=headers, json=payload)
task_id = response.json().get("task_id") or response.json().get("job_id")

画像から動画では、image_url を含め、出力がソースフレームに一致するよう aspect_ratio を "adaptive" に設定します [2]。

seed パラメータは、実行をまたいで同じ開始点が欲しいときに役立ちます。プロンプトの変更をテストしたり解像度を入れ替えたりする間は、固定したままにします。そうすれば、ランダムな変動を追わずに何が変わったかを判断できます。

プロンプト構造も重要です。シンプルな公式がうまく機能します：被写体 + アクション + カメラ + シーン/照明 + スタイル。モデルは明確な視覚的ターゲットがあるときに良い結果を出す傾向があるため、カメラの動きについては具体的にしてください [21]。

速度・コスト・一貫した結果のためのチューニング

本番作業では、Mini はテストティアとして使うのが最適です。最終レンダリングにより多くのクレジットを使う前に、プロンプトの表現、動き、アスペクト比を試すのに使います。これは広告フック、製品ティザー、教育ビジュアルによく機能し、WAN 2.6 のような高忠実度モデルへの前段としても機能します。

480p と 4～5 秒で始め、それから最良のアイデアを 720p で再実行します [18][12]。Fast/Mini ティアは再生時間ベースの料金式を使います：duration_seconds × 40 クレジットなので、5 秒のクリップは 160 クレジットのコストです [19]。

設定下書きコンセプト洗練クリップ
解像度480p720p
再生時間4～5 秒10～15 秒
クレジット使用量低いクレジット支出高いクレジット支出
最適用途プロンプトテスト、A/B イテレーション最終納品

この種の 2 パスワークフローはクレジットを節約し、プロセスを健全に保ちます。まずアイデアをテストし、それからすでに有望に見えるクリップにのみより多くを使います。

非同期ジョブ、エラー処理、ワークフロー例

ジョブを送信したら、完了を非同期で処理します。数秒ごとにステータスエンドポイントをポーリングするか、より大量に実行している場合は Webhook を使えます。300 秒のタイムアウトは堅実な本番デフォルトです [8]。ジョブが成功したら、すぐに動画をダウンロードします。

製品ウォークスルーや教育シーケンスでよく出てくるマルチショットナラティブでは、MiniMax Hailuo 02 の高い一貫性の出力と同様に、各リクエストに return_last_frame: true を設定します。それからそのフレームを image_url として次の呼び出しに渡します。シンプルなトリックですが、ショットが互いにより滑らかに流れるのに役立ちます [3]。

最も一般的な本番エラーはかなり読み取りやすいです：

  • 429 は同時実行制限に達したことを意味するので、指数バックオフを使います。
  • 402 はクレジット残高が空であることを意味するので、リトライループを始める前にそれを確認します。
  • ポリシー関連の問題は failed を返します。そうなったら、再試行する前にプロンプトやソースアセットを修正します [20]。

結論：Seedance 2 Mini を使うべきとき

API フロー、使用量の上限、料金をまとめて見ると、選択はかなりシンプルです：速度 vs. 最終の仕上げ。速いターンアラウンドと低コストが最上の出力より重要なときに Mini を使ってください。

だからこそ、下書きテストとバッチ発想によく機能します。使いすぎることなく、より多くの初期段階の動画コンセプトを実行できます。

Mini は最終制作ティアではありません。複雑なシーンや長いクリップでは、より高品質なティアほど信頼できません。だから最終レンダリングレーンではなく、下書きレーンとして使う方が理にかなっています。

また、上で扱った非同期 API ワークフローにきれいに収まります。チームがある程度の実ボリュームでショートフォーム動画を制作しているなら、2 パスのセットアップ —— Mini で下書きし、より高品質なティアで仕上げる —— は、アイデアから納品物へ進む費用対効果の高い方法です。

よくある質問

Seedance 2 Mini は最終動画に十分ですか？

Seedance 2 Mini は速度が最も重要なときに最も効果的です。

高速なプロンプトテスト、バッチ発想、粗い SNS コンセプト下書きに使ってください。速度を落とさずに多くの方向性を試したい初期段階の作業によく合います。しかし、最終的な高忠実度の制作の主力モデルとしては適切な選択ではありません。

プロンプトが強く見え始めたら、それを完全な Seedance 2.0 ワークフローに移します。そこでは、仕上げられた消費者向けアセットのために、より良い出力品質、より厳密な動き制御、より強いマルチモーダルの一貫性が得られます。

480p、720p、1080p の間はどう選ぶべきですか？

プロセスのどこにいるか、何を納品する必要があるかに基づいて選びます：

  • 480p は、速度とコストが最も重要なときの早期のアイデアチェック、高速なプロンプトテスト、バッチ発想に最適です。
  • 720p は、品質と低い API コストの堅実なバランスが必要な SNS 投稿、プレビュー、下書きによく合います。
  • 1080p は、視覚品質を仕上げて見せる必要があるマーケティングアセット、YouTube 動画、最終クライアント納品物に適した選択です。

API ワークフローで何を自動化すべきですか？

非同期生成フローをエンドツーエンドで自動化します：リクエストを送信し、ステータスをポーリングし、完成した動画をダウンロードします。

生成は通常 30～120 秒かかるため、コードは次のようにすべきです：

  • リクエストが受理されたらすぐに ジョブ ID を保存する
  • 5～10 秒ごとにジョブステータスを確認する
  • API が HTTP 429 を返したら 指数バックオフを使う

タイムアウト、接続切断、一時的な 5xx レスポンスのような短命の失敗にリトライロジックを追加するのも役立ちます。

動画が準備できたら、すぐに永続ストレージへダウンロードします。一時的なダウンロード URL は 24 時間以内に失効するため、これが重要です。