Seedance 2.0 Fast API

Seedance 2.0 Fast の画像から動画は、用意した画像からクリップを始め、最長 15 秒まで動かします。終了画像を加えるとショットはそこに着地しなければならないため、トランジションやビフォーアフターを再現可能な形で作れます。

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

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

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

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 つの固定比率を使えます。

自前の画像から文字どおりの結果を

開始フレームに写っているものは最初からクリップに入っているので、プロンプトは動きを説明するだけでよく、内容を言葉で通す必要がありません。同じシーンを文章で書くと Seedance 独自のフィルターに拒否される場合に、確実に使える方法です。

ビフォーアフターとトランジション

image_url と一緒に last_image_url を送ると、ショットは終了画像に着地する必要があります。公開している例では、カメラを固定したまま 10 秒で空き部屋にラグ、ソファ、ランプが並びます。リフォームのお披露目や商品の変化を見せる形です。

480p で試し、720p で納品

動作と構図が決まるまで安価な 480p で回し、残すテイクだけ同じリクエストを 720p で実行します。解像度が変えるのは納品形式だけで、開始フレームにないディテールは加わりません。

# 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/image-to-video",
  "input": {
    "aspect_ratio": "adaptive",
    "bitrate_mode": "standard",
    "duration_seconds": 5,
    "generate_audio": true,
    "image_url": "https://example.com/reference.png",
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise"
  }
}'

# 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 リファレンスを参照してください。