Seedance 1.5 Pro API

Seedance 1.5 Pro の画像から動画は、用意した画像からクリップを始め、最長 12 秒まで動かします。camera_fixed をオンにすると構図がそのまま保たれるため、合成に使えるプレートを作れるエンドポイントです。

ByteDance の Seedance 1.5 Pro は、テキストから動画と画像から動画の 2 つのエンドポイントを公開しています。どちらも 480p、720p、1080p で 4〜12 秒のクリップをネイティブ音声付きで返し、camera_fixed スイッチを備えています。

開始素材から Seedance 1.5 Pro のモードを選ぶ

camera_fixed で画角を固定

既定値の false では、モデルがドリフト、プッシュイン、ゆっくりした回り込みなどのカメラワークを自分で作ります。true にするとカメラは止まり、被写体だけがフレーム内で動き続けます。固定した画はトラッキング、キーイング、合成、ループに使え、Seedance 2.0 と 2.5 にはこのスイッチがありません。

同じ処理で音声も

generate_audio の既定値は true で、環境音、動きの効果音、声をフレームに合わせて生成します。リクエストは上の料金帯になるので、商品ループや後から音を付ける素材ではオフにしましょう。

はっきりした上限

クリップは 4〜12 秒、解像度は 480p、720p、1080p です。画面比率は 6 つの固定値で既定は 16:9、アダプティブはありません。参照用のエンドポイントはありません。seed は 480p と 720p で使えます。4K、長いテイク、複数画像でのキャスティングが必要なら Seedance 2.0 か 2.5 を使いますが、1.5 Pro にしかないのがカメラの固定です。

合成用のプレート

確定済みの静止画を送って camera_fixed をオンにすると、被写体だけが動き、構図はクリップの最後まで保たれます。三脚で撮った素材のように扱え、キーイング用のきれいな背景、タイトルをトラッキングする安定した面、実写のシーケンスに編集で組み込めるプレートになります。

商品のターンテーブルとループ

固定フレームで物体が回るのは典型的な使い方です。ずれがなく、水平線は水平のまま、最後のフレームが最初のフレームに十分近いのでループにできます。商品ループに環境音はほぼ不要なので、generate_audio はオフにします。

背景のゆっくりした動き

公開している例では、1 枚の静止画に降る雪、立ちのぼる湯気、水の動きを重ね、ごくゆっくりとしたプッシュインで見せています。カメラの速さで隠れてしまわないようにするためです。天候、煙、水は、構図を止めたときに最もよく映える動きです。

# 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-1.5-pro/image-to-video",
  "input": {
    "aspect_ratio": "16:9",
    "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",
    "resolution": "720p"
  }
}'

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