はじめに
Seedance 2.0 Mini の画像から動画は、用意した画像からクリップを始め、最長 15 秒まで動かします。終了画像を加えるとショットはそこに着地しなければならないため、トランジションを再現可能な形で作れます。
Seedance 2.0 Mini は ByteDance の Seedance 2.0 シリーズで最も小さいグレードです。Seedance 2.0 Fast と同じ 3 つのエンドポイントを公開しており、480p か 720p の 4〜15 秒クリップを、同じ処理で生成した音声付きで返します。
開始素材から Seedance 2.0 Mini のモードを選ぶ
| 開始素材 | モード |
|---|---|
| 台本やシーンの説明 | Seedance 2.0 Mini テキストから動画 |
| 確定済みの開始画像 | Seedance 2.0 Mini 画像から動画 |
| 見た目・動き・音声を分けた参照素材 | 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 つのファイルが返ります。各ステップで課金されるのは足した秒数だけで、つないだ結果はもう一度延長できます。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | いいえ | 任意ですが、書く価値があります。すでに見えているものを繰り返すのではなく、画像のあとに何が起きるか（動作、カメラの動き、時間の経過、音）を書いてください。 1 文字以上 |
image_url | はい | 最初のフレームへの、公開された直接ダウンロード可能なリンク。必須です。 |
last_image_url | いいえ | 任意の最後の画像です。ショットがどの絵で終わるかを決めます。 |
aspect_ratio | いいえ | 出力の画面比率です。既定の adaptive では最初の画像の縦横比をそのまま保つため、切り落とされる部分がありません。 |
resolution | いいえ | 出力解像度。480p か既定の 720p。 |
duration_seconds | いいえ | 完成クリップの長さを整数秒で指定します。4～15 秒で既定は 5 秒、課金対象の秒数でもあります。 |
generate_audio | いいえ | 映像に同期したネイティブのサウンドトラックを生成するかどうかです。既定でオンですが、このバージョンではオフにしても料金は下がりません。 デフォルト値: |
enable_web_search | いいえ | 既定はオフです。オンにすると、モデルは描画の前にプロンプトに関連する情報をウェブで検索することがあります。 デフォルト値: |
seed | いいえ | 整数の seed。省くと毎回それぞれの乱数になります。 |
return_last_frame | いいえ | 動画と一緒に、クリップの最終フレームを別の画像として返します。次の先頭フレームとして image-to-video に渡せば、自分で静止画を書き出さずにショットをつなげられます。 デフォルト値: |
bitrate_mode | いいえ | 納品ファイルのビットレートです。 |
watermark | いいえ | モデル自身の「AI generated」という可視の透かしを動画に入れます。既定ではオフです。 デフォルト値: |
料金
| 仕様 | 料金 |
|---|---|
| $0.0246078 / 秒 |
| $0.05292 / 秒 |
| $0.036 / 秒 |
| $0.072 / 秒 |
ユースケース
カタログ写真に動きを
平面的な商品写真や棚の写真が、撮り直しなしで数秒の動きになります。公開している例では、カメラを固定したまま 4 秒で冷蔵棚に缶を 1 本ずつ補充し、小さな金属音や冷蔵機のうなりも入っています。
2 枚のフレーム間のタイムラプス
last_image_url を指定すると、クリップは終了画像に着地する必要があります。例の 1 つでは、同じ小道が 10 秒で晩夏から深い秋へ移り変わります。カメラは固定で、カットはありません。
テキストでは拒否されるシーン
内容は開始フレームが担うので、プロンプトは動きを書くだけで済みます。文章で書いたシーンが Seedance 独自のレイヤーに拒否される場合は、開始フレームから動かすのが有効です。
プロンプトガイドと実践のヒント
開始フレームを整える
image_url は必須で、構図、見た目、画質の上限を決めます。各辺は 300〜6000 ピクセルが必要です。文字、透かし、ロゴは動画にも残るので、先に消しておきます。
そこにあるものではなく、変わることを書く
プロンプトは任意です。フレームのあとに続く動作、カメラの動き、音を書きます。書かなければモデルが動きを決めます。1 枚のフレームで動かすショットは長いほどずれていくので、15 秒分を払う前に 4〜5 秒で動きを確かめてください。
付属の例を応用する
公開している例は aspect_ratio 16:9、duration_seconds 4、generate_audio true、resolution 720p で、棚の写真を image_url にしています。
A gloved hand enters from the right and fills the gap in the upper row can by can, facing each label forward, then withdraws. Camera locked off on the shelf. Small metallic clinks, chiller hum, fluorescent light unchanged throughout.
固定カメラで明確な動作を 1 つ見せるなら 4 秒で足ります。自社の商品写真に差し替えても、動きは 1 つに保ってください。
終了フレームも同じ比率に
last_image_url は開始フレームと同じ比率にする必要があり、違うと合わせてトリミングされます。2 枚の間でカメラと光は変えず、小道の例の季節のように、はっきりした状態の変化を 1 つだけにします。
API クイックスタート
# 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/image-to-video",
"input": {
"aspect_ratio": "adaptive",
"bitrate_mode": "standard",
"duration_seconds": 5,
"enable_web_search": false,
"generate_audio": true,
"image_url": "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 リファレンスを参照してください。
