Seedance 2.0 Mini API

Seedance 2.0 Mini の参照から動画は、許諾を得た複数のソースを 1 つのショットにまとめます。画像は誰と何を、クリップは動きとテンポを、音声はカットが合わせる拍を担当します。開始フレームは受け付けません。

Seedance 2.0 Mini は ByteDance の Seedance 2.0 シリーズで最も小さいグレードです。Seedance 2.0 Fast と同じエンドポイントを公開しており、480p か 720p の 4〜15 秒クリップを、同じ処理で生成した音声付きで返します。

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

Seedance 2.0 Fast と同じ仕様

Mini のエンドポイントとフィールドは Seedance 2.0 Fast と同じです。アダプティブ比率と 6 つの固定比率、4〜15 秒（-1 でモデルが長さを決定）、ネイティブ音声、seed を備え、解像度だけが 720p までです。Mini 向けに作ったパイプラインは、リクエストではなくモデル ID を変えるだけで Fast に移せます。

大量生成向け

大きい Seedance 2.0 モデルの画質よりも処理量を重視するなら Mini が適しています。どのエンドポイントも非同期なので、リクエストごとに Idempotency-Key を送り、タスク ID を保存して、ポーリングかコールバックで結果を受け取ります。キーは 24 時間有効で、接続が切れたあとに再試行しても元のタスクが返ります。

動画延長で長尺に

15 秒を超えたいときは、完成したクリップを video-extend エンドポイントに送ってください。クリップの最後のフレームが Seedance 2.0 Mini の新しいショットの開始フレームになり、両方をつないだ 1 つのファイルが返ります。各ステップで課金されるのは足した秒数だけで、つないだ結果はもう一度延長できます。

1 組の参照でシリーズ全体を

1 人の男性を正面、斜め、横顔から撮った 3 枚と、エプロンの 4 枚目があれば、リクエストごとにプロンプトを変えるだけでシリーズ全体を支えられます。公開しているパン屋の例はまさにこの構成です。

クリップからテンポを借りる

参照クリップは内容ではなくリズムを提供することもできます。例の 1 つでは、クリップのゆったりした連続のプッシュインを取り入れ、参照画像の通路で演出し、足音を参照トラックの拍に合わせています。9:16 で 8 秒です。

角度が変わっても同じカップル

同じカップルの画像が 3 枚あれば、顔と衣装を保ったまま新しいショットで 3 つ目の角度を作れます。480p で生成した公園のベンチの例がそうです。

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

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