使用ガイド
Seedance 2.5 Flash 画像から動画への接続ガイド:最初のフレーム、最後のフレーム、秒単位課金
1枚の画像を動かす:パラメータ、価格、よくある失敗原因
- モデル
- seedance-2.5-flash
このページの内容
このモデルが何をするか
seedance-2.5-flash/image-to-video は ByteDance の画像から動画を生成するモデルです。画像を1枚アップロードして最初のフレームとし、モデルはそれを起点に連続した動画を生成し、同時に音声も生成します。画面比率は最初のフレームに従い、二次的なトリミングは行いません。
確実な素材を起点とする場面に適しています:製品画像の動的ディスプレイ、キャラクター立ち絵の微表情や身体動作、絵コンテスケッチの動的プレビズ、コンテンツプールを大量に埋めるためのショート動画など。一方、「一文だけ与えて完全な物語を生成する」といったニーズには向いておらず、それはテキストから動画を生成する系統の役割です。
リクエストパラメータ
- prompt(必須):期待する動作、カメラワーク、シーン、音声を記述。最大 5000 文字。
- first_frame_url(必須):最初のフレーム画像。jpeg、png、webp、bmp、tiff、gif、heic、heif に対応。1枚あたり 30 MB 以下、各辺 300〜6000 ピクセル、アスペクト比 0.4〜2.5。
- last_frame_url(任意):最後のフレーム画像。制約は最初のフレームと同じ。比率が一致しない場合は中央でクロップして揃えます。最後のフレームを渡す場合は必ず最初のフレームも同時に渡してください。
- resolution:
480pまたは720p、デフォルトは480p。 - duration:4〜30 の整数、デフォルトは 5、単位は秒。
- aspect_ratio:
adaptiveのみ受け付け、出力比率は最初のフレーム画像に従います。 - output_format:
mp4(デフォルト)またはmov。 - generate_audio:デフォルトは
true。
秒単位課金
- 480p:$0.0679/秒
- 720p:$0.1525/秒
課金される秒数はリクエストした duration と同じです。よくある組み合わせ:480p 4秒 $0.2716、720p 4秒 $0.61、480p 10秒 $0.679、720p 10秒 $1.525。最初のフレームと最後のフレームの画像自体には追加料金はかかりません。
秒単位課金のため、リトライはそのまま重複課金になります。「最初のフレームが適切かどうか」を提出前に判断する方が、生成後にやり直すよりはるかに安く済みます。
最初のフレームが完成品の上限を決める
モデルは最初のフレームに既にある情報だけを基に延長するため、最初のフレームの品質がほぼ結果の上限を決めます:
- 被写体が鮮明で、画面に占める割合が適切であること——被写体が小さすぎると、モデルは何を動かすべきか判断しにくくなります。
- 強いぼけやノイズを避けること。低品質な入力は各フレームで増幅されます。
- 画面の端に注意すること。切れている被写体は動く際に変形しやすくなります。
- 画面内の文字は動きの中で安定を保ちにくいため、そもそも重要でない場合を除いて避けましょう。
- 同じ被写体で候補の最初のフレームを複数用意する方が、プロンプトを繰り返し調整するより効果的です。
長さは費用であり品質変数でもある
クリップが長くなるほど、モデルが一貫性を維持すべきフレーム数が増え、ドリフトや歪みが蓄積する確率が高まります。まず 4〜5 秒で最初のフレームと運動方向が成立するか検証し、確認できてから必要に応じて延ばすことをお勧めします。長いコンテンツは「複数の短いクリップ + ポストプロダクションでの結合」で構成し、単一の長い生成に頼らないようにしましょう。
よくある失敗と切り分けの順序
- 提出時にパラメータエラーになる:まず画像が上限を超えていないか(サイズ、辺の長さ、アスペクト比、形式)、また
last_frame_urlだけを渡して最初のフレームを渡していないかを確認します。 - 画面の被写体が変形する:多くは最初のフレームの被写体が小さすぎる、端が切れている、または動きの幅の要求が大きすぎることが原因です。最初のフレームを変えるか、動作を小さめに記述します。
- 比率が想定と異なる:この系統は
adaptive固定で、出力は最初のフレームに従います。16:9 や 9:16 が欲しい場合は最初のフレーム側で決めてください。 - コンテンツがブロックされる:最初のフレーム自体もコンプライアンス審査を通る必要があり、画像に何が写っているかが呼び出しの成否を直接決めます。
- クライアントがタイムアウトしたがタスクは実は成功している:動画生成は時間がかかるため、クライアントのタイムアウトを短く設定しすぎると成功を失敗とみなし、再提出で重複課金になります。非同期タスクとして処理し、十分なタイムアウトを設定してください。
リリースに向けた提案
まず 3〜5 枚の異なるタイプの最初のフレームで一連の流れを通し、提出・ポーリング・ダウンロードがすべて通ることを確認します。次に最初のフレームを固定してプロンプトだけを変え、どの動作記述にモデルがよく応答するかを見極めます。最後に比率を上げて拡大し、成功率、平均所要時間、リトライ率を注視します。パラメータと価格はモデルページの現在の説明を基準にしてください。