Seedance 2.5 API：エンドポイント、パラメータ、実際の課金
Seedance 2.5 API は非同期で、秒単位の課金です。実装時に見落とされがちな課金ルールが3つあります。最初の呼び出しを書く前に必要な情報をまとめます。
最安 $0.07 1秒あたり、参照クリップありの 480p
Seedance 2.5 API で得られるもの
POST を1回でジョブを作成し、GET を1回でポーリングします。ポーリングは無料です。Seedance 2.5 API は、専用のパラメータではなく、どのメディアフィールドを埋めたかでモードを決めます。
prompt だけなら text-to-video です。画像を加えると Seedance 2.5 API は image-to-video として動作します。最初と最後のフレームを渡せばその間の遷移を生成し、ソースクリップを渡せば編集または延長します。
POST は即座にタスク ID を返し、生成には2〜5分かかります。Seedance 2.5 API の実装には、同期リクエストではなくポーリングループかキューが必要です。
プラットフォームは doubao-seedance-2.5-face として提供しています。Seedance 2.5 API のモデル文字列の誤りは、最初の呼び出しでもっとも多い失敗原因ですが、課金ではなく同期的なエラーが返ります。
ヘッダー1つ、ワークスペース単位のスコープ、プロジェクト ID はありません。Seedance 2.5 API のキーは、発行したワークスペースの課金スコープを引き継ぎます。
失敗したジョブは、モデレーションによる拒否も含めてクレジットが全額返ります。Seedance 2.5 API は、受け取っていない生成に課金することはありません。
このページに生成機能はありません。Seedance 2.5 API の呼び出しはホスト型 API 上で実行され、以下のパラメータと料金はすべて公開ドキュメントから取っています。
もっとも重要な Seedance 2.5 API のパラメータ
費用と結果を左右する4つのフィールドです。
duration
4〜30秒、既定値は5秒です。-1 を渡すとモデルが決めますが、Seedance 2.5 API は30秒の上限でクレジットを確保してから差額を返金するため、残高が少ないと 402 が発生することがあります。
resolution
480p、720p、1080p で、既定値は 720p です。Seedance 2.5 API に 4K はなく、指定しても品質を落としたクリップではなくエラーが返ります。
content_filter
真偽値で、既定値は true です。false にすると Seedance 2.5 API のリクエストは制限の緩いチャネルへ振り分けられ、prompt が必須になります。プラットフォームはこれをオフスイッチではなくルーティングとして記載しています。
omni_reference_task_type
edit または extend を明示すると、Seedance 2.5 API は数分後に失敗させるのではなく、送信時にルールを検証します。参照素材を使うジョブでは設定しておく価値があります。
Seedance 2.5 API を動かすまでの4ステップ
- 1
キーを作成する
プラットフォームのダッシュボードでキーを発行し、bearer トークンとして送信します。Seedance 2.5 API は authorization ヘッダーでそれ以外を受け付けません。
- 2
ジョブを POST する
モデル、prompt、必要なメディアの URL を動画生成エンドポイントへ送ります。Seedance 2.5 API のメディア関連フィールドはすべて公開された HTTP または HTTPS の URL を受け取り、base64 はプラットフォーム全体で拒否されます。
- 3
タスクをポーリングする
ステータスが completed または failed になるまで、タスク ID を GET し続けます。Seedance 2.5 API のポーリングは無料なので、2秒間隔でも問題ありません。
- 4
出力を読み取る
完了した Seedance 2.5 API のタスクは動画の URL を返し、要求していれば最終フレームの URL も返します。配信される URL は恒久的ではないため、残したいものは自分で再ホストしてください。
Seedance 2.5 API に関する疑問への回答
課金対象の動画の秒単位で、解像度と参照クリップの有無に応じて $0.071153 から $0.461856 までです。10秒の 1080p 生成で約 $4.62 です。参照画像と参照音声は請求額に加算されません。
出力の尺に参照動画の全長を加えた秒数で、動画を含むリクエストには出力尺の3分の5という下限があります。2秒のソースで5秒の出力なら、7秒ではなく9秒分の課金になります。最初の実装で多くの人が驚く点です。
ホスト型 API 上の doubao-seedance-2.5-face です。古いガイドは接尾辞なしの doubao-seedance-2.5 を挙げていますが、これはローンチ前の名称で解決できません。コードサンプルを信用せず、モデルページを確認してください。
ドキュメントに記載された方法はポーリングで、しかも無料です。短い間隔のループがもっとも単純な Seedance 2.5 API の実装になります。生成には2〜5分かかるため、2〜5秒間隔のポーリングでも負荷はほぼなく、コールバックの仕組みも不要です。
スキーマ検証によるもので、課金は発生していません。よくある原因は、無効な解像度、最初または最後のフレームと組み合わせた size の値、text-to-video のリクエストでの prompt の欠落です。エラーは該当するフィールド名を示します。
タスク種別のルールか、モデレーションのいずれかです。エラー 80006 は安全性による拒否で、段階は示されません。編集ジョブでのパラメータの不一致は別の失敗を返し、omni_reference_task_type を明示しておけば、次回からは即座に 400 として返るようになります。
画像は30枚まで、動画クリップは合計30秒で10本まで、音声トラックは10本までです。画像の配列とロールを付与した画像の配列は排他なので、1回の Seedance 2.5 API リクエストではどちらか一方を選んでください。
あります。同じエンドポイントでモデル ID を変えるだけです。Seedance 2.0 は15秒が上限で 2.5 は30秒に達しますが、リクエストの形は十分に近く、バージョンの切り替えはほぼ文字列の変更で済みます。
キーは発行したワークスペースの課金スコープを引き継ぎ、プロジェクト用のヘッダーは別に用意されていません。利用状況はワークスペース単位で集計されるため、会計を分けたいチームは1つのワークスペース内でキーを分けるのではなく、ワークスペース自体を分けています。