はじめに
Seedance 1.5 Pro のテキストから動画は、フレーム全体をプロンプトから組み立て、サウンドトラックも同じ処理で生成します。camera_fixed によって、モデルがカメラワークを作るか、画を完全に止めるかが決まります。
ByteDance の Seedance 1.5 Pro は、テキストから動画と画像から動画の 2 つのエンドポイントを公開しています。どちらも 480p、720p、1080p で 4〜12 秒のクリップをネイティブ音声付きで返し、camera_fixed スイッチを備えています。
開始素材から Seedance 1.5 Pro のモードを選ぶ
| 開始素材 | モード |
|---|---|
| 確定済みの開始画像 | Seedance 1.5 Pro 画像から動画 |
| 台本やシーンの説明 | 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 にしかないのがカメラの固定です。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 画面に現れるものの唯一の源です。被写体、動作、カメラ、光、音の順に、1 文に 1 つのアイデアで並べ、 |
aspect_ratio | いいえ | 6 種の固定値から画面を選びます。既定は 16:9。 |
resolution | いいえ | 出力解像度。既定は 720p、上は 1080p まで。 |
duration_seconds | いいえ | 完成するクリップの長さを整数秒で、4〜12、既定は 5。課金される数量です。 |
generate_audio | いいえ | 映像に同期したネイティブのサウンドトラックを描画するかどうかを指定します。既定でオンで、上の料金段になります。 デフォルト値: |
camera_fixed | いいえ | カメラを固定します。既定は false。 デフォルト値: |
seed | いいえ | ランダムな出発点を決める 0 から 2147483647 までの整数です。省くと毎回それぞれの値になります。 |
料金
| 解像度 | 音声を生成: いいえ | 音声を生成: はい |
|---|---|---|
| $0.0112 / 秒 | $0.0223 / 秒 |
| $0.0227 / 秒 | $0.0454 / 秒 |
| $0.0491 / 秒 | $0.0982 / 秒 |
ユースケース
合成用の固定ショット
camera_fixed をオンにし、フレーム内で起きる動きを書きます。公開している例は、動くのは布と人物の呼吸だけという固定のワイドショットで、キーイング、トラッキング、ループに使える素材になります。
条件をそろえたプロンプト比較
カメラを固定し、ほかのフィールドはすべて同じにして、1 回ごとに光源、レンズ、1 つの動作など 1 か所だけを変えます。480p と 720p では seed も固定すれば乱数の出発点も動きません。seed は比較のための道具で同一フレームの保証ではないので、各バージョンを数テイクずつ比べましょう。カメラが固定されていれば、違いは言い回しの差だと判断できます。
絵画調・様式化したルック
プロンプトでは動作だけでなくルックも決まります。このエンドポイントの例の 1 つは、ろうそくの明かりだけで照らした明暗の強い油絵調を指定し、ごくゆっくりとしたドリーで、camera_fixed はオフにしています。
プロンプトガイドと実践のヒント
まずカメラを決める
この世代で最初に決めるのは camera_fixed です。トラッキング、キーイング、ループ、実写との編集に使うなら true にして、プロンプトでも固定を明記します。カメラを動かしたいなら false のままにして、プッシュイン、パン、ティルト、回り込みなど動きの種類を書きます。
Seedance 独自の拒否を避けて書く
当社は表現を審査しませんが、Seedance 独自の安全レイヤーが一部を生成前に退けます。キスは確実に拒否され、耳元のささやきや額を寄せ合う描写は通ります。文字どおりのシーンが必要なら、プロンプトではなく画像から動画の自前のフレームから始めてください。
付属の例を応用する
公開している例は aspect_ratio 16:9、camera_fixed true、duration_seconds 5、generate_audio true、resolution 720p です。
Locked-off static wide shot, camera never moves. An adult woman lies on her back across white hotel sheets in a pale blue camisole, ankles crossed and lifted in the foreground, one foot slowly rocking side to side, her hand tracing a lazy circle on the duvet. Blown-out window light, high-key minimal composition, only the sheets and her breathing move.
固定はフィールドで指定し、プロンプトの最初の文でも繰り返しています。動きはすべて人物か布のものです。
安く試してから納品する
resolution と duration_seconds はどちらも料金を決め、generate_audio は料金帯を上げます。言い回しは音声オフの 480p で詰め、納品するテイクだけ解像度を上げて音声をオンに戻しましょう。
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-1.5-pro/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"aspect_ratio": "16:9",
"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 リファレンスを参照してください。
















