Seedance 2.0 Fast API

Seedance 2.0 Fast のテキストから動画は、被写体、セット、カメラ、光までフレーム全体をプロンプトから組み立て、サウンドトラックも同じ処理で生成します。映像を固定する素材がないため、まだ存在しないショットを作るためのエンドポイントです。

Seedance 2.0 Fast は ByteDance の Seedance 2.0 シリーズの高速グレードです。エンドポイントはいずれも 480p か 720p の 4〜15 秒クリップを返し、音声も映像と一緒に生成します。

開始素材から Seedance 2.0 Fast のモードを選ぶ

共通のフィールドと 3 種類のソース

エンドポイントはどれも同じ基本フィールドを受け付けます。prompt、4〜15 秒の duration_seconds（-1 ならモデルが長さを決めます）、480p か 720p の resolution、aspect_ratio、generate_audio、seed です。違うのは映像を固定するソースだけで、なし、開始フレーム、参照素材のいずれかです。そのソースを足すか外すだけで、リクエストを別のモードに移せます。

映像と音声を 1 回で生成

generate_audio は既定でオンで、環境音、動きに伴う効果音、声をフレームに合わせて生成します。このグレードではオフにしても料金は下がらないため、オフにするのは無音ループや後から音を付ける素材のときだけで十分です。

既定はアダプティブな画面比率

aspect_ratio の既定値は adaptive です。画像から動画は開始フレームの比率を保ち、参照から動画はメインの参照素材に合わせ、テキストから動画ではプロンプトから読み取れる形をモデルが選びます。配信先で形が決まっている場合は、16:9、9:16、4:3、3:4、1:1、21:9 の 6 つの固定比率を使えます。

SNS 向けの縦型カット

9:16 を直接指定し、スマートフォンが撮ったように書きます。手持ち、窓からの昼の光、環境音はそのまま残します。下の例がまさにそれで、実写素材なしのプロンプトだけでバスの窓際席の 5 秒を生成しています。

誰も撮影に行かないカット

たどる画像がないため、被写体、セット、カメラ、光の情報源はプロンプトだけです。ロケ地とスタッフが必要になるような状況説明カット、インサート、B ロールに向いたエンドポイントです。

長いシーケンスの最初のショット

このシリーズには延長用のエンドポイントがありません。ここで最初のショットを作り、最後のフレームを書き出して、画像から動画に次のショットの開始フレームとして渡します。衣装、セット、光はそのフレームに焼き込まれているので引き継がれます。

# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "bytedance/seedance-2.0-fast/text-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "resolution": "720p",
    "aspect_ratio": "adaptive",
    "bitrate_mode": "standard",
    "generate_audio": true,
    "duration_seconds": 5
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。