はじめに
Seedance 2.0 Mini のテキストから動画は、被写体、セット、カメラ、光までフレーム全体をプロンプトから組み立て、サウンドトラックも同じ処理で生成します。誰も撮影に行かないカットを埋めるためのエンドポイントです。
Seedance 2.0 Mini は ByteDance の Seedance 2.0 シリーズで最も小さいグレードです。Seedance 2.0 Fast と同じエンドポイントを公開しており、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 文に 1 つのアイデアで並べてください。 1 文字以上 |
aspect_ratio | いいえ | 出力の画面比率です。既定は adaptive で、21:9 から 9:16 までの 6 つの固定比率からも選べます。 |
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 / 秒 |
ユースケース
日常の B ロールを大量に
窓からの朝の光、顔までかぶった羽毛布団、光の筋に舞うほこり。カタログやアプリが何百カットも必要とし、誰もわざわざ撮影を組みたくない日常のショットです。下の公開例がまさにそれで、プロンプトだけで生成しています。
1 つのブリーフをすべての比率で
プロンプトを固定し、同じバッチで 16:9、9:16、1:1 に展開します。エンドポイントは非同期なので、同じアイデアの 3 つの比率は、計画すべき 3 件の仕事ではなく、受け取るべき 3 つのタスク ID になります。
同じリクエスト形式で幅広いルック
同じフィールドで実写風にも様式化したアニメーションにも対応します。このエンドポイントの例には、望遠レンズで撮った雨の夜の路地と、雪の露天風呂を描いたセル調のアニメシーンがあります。ルックはプロンプトで決め、追加のフィールドは不要です。
プロンプトガイドと実践のヒント
被写体、動作、カメラ、光、音の順に
1 文に 1 つの要素を、この順番で書きます。duration_seconds を長くして時間が増えたら、2 つ目の動作を足すのではなく、すでに書いた動作を最後まで見せるのに使ってください。
Seedance に拒否される表現は言い換える
当社は表現を審査しませんが、Seedance 独自のレイヤーが一部を生成前に拒否し、キスは確実に拒否されます。耳元のささやきや額を寄せ合う描写に言い換えれば通り、画像から動画で開始フレームを使えば文字どおりの表現も通ります。
付属の例を応用する
公開している例は aspect_ratio 16:9、duration_seconds 5、generate_audio true、resolution 720p です。
Morning in a sunlit studio apartment. An adult woman in an oversized grey t-shirt stretches her arms overhead beside the window, the hem lifting slightly, then drops onto the unmade bed and pulls the duvet over her face laughing. Warm dust in the light shaft, handheld, soft film grain, quiet room tone and distant traffic.
手持ち感と静かな室内の音をまとった日常のカットで、まさにこのグレードの用途です。部屋としぐさを変え、動作は 1 つという構成は保ってください。
音声をオフにするのは後で音を付けるときだけ
このグレードでは generate_audio をオフにしても料金は変わりません。環境音がシーンを支えるならオンのままにし、無音ループや後から音楽を付ける場合にだけオフにします。
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/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 リファレンスを参照してください。
