使用ガイド
Seedance 2.5 Flash テキストtoビデオ導入ガイド:パラメータ、秒単位課金とエンジニアリング実践
1回のリクエストから安定したリリースまで:パラメータの設定方法とコストの計算
- モデル
- seedance-2.5-flash
このページの内容
このモデルの役割
seedance-2.5-flash/text-to-video は ByteDance のテキストtoビデオモデルです:テキストのプロンプトを入力すると、同期音声付きの動画を出力します。入力経路はこれ1つだけで、画像や動画を条件入力として受け付けず、動画理解も行いません。
適しているのは「一言で使える短い動画を1本出す」場面です:マーケティング素材の一括生成、製品ショート動画の空撮カットや雰囲気カット、コンテンツプールの尺埋め、クリエイティブ方向性の素早いプレビュー。出発点が画像なら、image-to-video のラインを使う方が直接的です。参考素材に沿って主体の一貫性を保つ必要があるなら、参考素材駆動のラインを使ってください。
リクエストに含まれるパラメータ
- prompt(必須):シーン、主体、カメラワークと動作。最大 5000 文字。
- resolution:
480pまたは720p、デフォルトは480p。 - duration:4〜30 の整数、デフォルトは 5、単位は秒。
- aspect_ratio:
16:9、4:3、1:1、3:4、9:16、21:9、adaptive、デフォルトはadaptive(モデルがプロンプトに応じて比率を選択)。 - output_format:
mp4(デフォルト)またはmov。 - generate_audio:デフォルトは
true、映像に同期したセリフ、効果音、背景音を生成します。
prompt 以外はすべてデフォルト値があるため、最小のリクエストには prompt だけが必要です。リクエストボディは厳格に検証されます:宣言されていないフィールドを余分に渡すと、黙って破棄されるのではなく拒否されます——これにより、結合テスト段階のエラーが課金後のあとではなく、送信時点で明らかになります。
秒単位の課金方法
課金の基準は「1秒あたりの単価 × 出力秒数」で、解像度の段階に連動します:
- 480p:$0.0679/秒
- 720p:$0.1525/秒
出力秒数はリクエスト内の duration をそのまま使い、四捨五入による予期せぬ処理は行いません。例:480p 5秒は $0.3395、720p 5秒は $0.7625。480p 30秒は $2.037、720p 30秒は $4.575。尺が倍になれば費用も倍になり、「長いほど安い」といった割引はありません。
これは3つのことを意味します。第一に、予算見積もりは単なる掛け算で、まず1本あたりの尺を決めてから本数を掛けます。第二に、リトライは再課金であり、失敗時のリトライには必ず上限を設けます。第三に、長尺は一度に生成せず、複数の短いセグメントに分割してそれぞれ生成し、後で結合します。費用を抑えられ、失敗しても壊れたセグメントだけに影響が収まります。
導入形態:非同期タスク
動画生成は時間のかかるタスクであり、インターフェースは非同期です:送信後にタスク識別子を取得し、ポーリングまたはコールバックで結果を取得し、最後に成果物をダウンロードして保存します。これを同期 RPC としてラップし、ユーザーのリクエストをブロックしてはいけません。
- 状態機械の永続化:タスク識別子、状態、リクエストパラメータをデータベースに保存し、プロセスメモリだけに置かないこと——再起動でタスクを失うのは、お金を払って結果がないのと同じです。
- ポーリングのバックオフ:開始間隔は短く、徐々に延ばしつつジッターを加え、同時に各タスクに全体タイムアウトを設定し、タイムアウト時は無限ポーリングではなく失敗ブランチに進めます。
- エラー分類:パラメータエラーやコンテンツ違反は確定的な失敗であり、リトライは無意味です。ネットワークの揺らぎやレート制限といった一過性のエラーだけがバックオフ付きリトライに値します。
- 冪等性:送信側に業務上の一意キーを持たせ、ユーザーの二重クリックによる複数タスクと二重課金を防ぎます。
安定するプロンプトの書き方
「主体 → 動作の順序 → 環境と光 → カメラ」の4段構成で書くと、形容詞を並べるよりはるかに安定します。
主体:窓辺に座る白い猫、逆光
動作:静止状態から顔を上げて窓の外を眺め、尻尾をゆっくり振る
環境と光:午後の暖かい光、浅い被写界深度、静かな屋内の雰囲気
カメラ:ミディアムショット、固定カメラ、わずかな手持ち感
3つの規律:1つのプロンプトでは1つの連続ショットだけを語り、複数シーンの切り替えを一度の生成に詰め込まないこと。プロンプトはバージョン管理し、毎回1つの変数だけを変えることで、どの変更が効いたのか判断できます。まず小サンプル、その後バッチ——まだ確定していないプロンプトをバッチで検証しないこと。
アスペクト比やカメラ言語は自然言語で記述すれば十分です——モデルに独立した「カメラワーク」パラメータはないため、存在しないフィールドを期待するよりプロンプトに書き込む方が確実です。
リリースまでの道筋
- パイプラインの疎通:典型的なシーンをカバーする3つのプロンプトで、送信、ポーリング、ダウンロードがすべて通ることを確認します。まず出来栄えは見ません。
- プロンプトと尺の確定:少数のプロンプトを固定し、異なる書き方と異なる尺での出力を比較し、各件の費用を記録して、再利用可能なテンプレートライブラリを形成します。
- 段階的な拡大:割合を決めて拡大し、成功率、平均所要時間、リトライ率、費用曲線を観察し、3項目が基準を満たしてから量を増やします。
- 定常運用:定期的にテンプレートライブラリを振り返り、非効率な書き方を整理し、費用の傾向とリトライのしきい値を監視します。
モデルページに最新のパラメータ説明と価格があるので、導入前に照合しておけば十分です。