はじめに
image_url と prompt を送ると、静止画が動きます。last_image_url、duration_seconds、resolution、generate_audio は任意で、watermark、return_last_frame、output_format も追加で指定できます。クリップは開始画像の形を保つため、aspect_ratio の項目はありません。プロンプトには、写真をもう一度描写するのではなく、動き、カメラ、音を書いてください。
| 項目 | 値 |
|---|---|
| 入力 | 画像 |
| 出力 | 動画 |
| 提供元 | ByteDance(Seedance 2.5 Flash は Seedance 2.5 の高速版で、2026 年 11 月 12 日に BytePlus が発表) |
| API 名 | bytedance/seedance-2.5-flash/text-to-video、image-to-video、reference-to-video、video-edit、video-extend |
| 解像度 | 480p または 720p(既定は 720p)。1080p と 4K は非対応 |
| クリップの長さ | 4〜30 の整数秒、既定は 5 秒。動画編集は 4〜30 秒の元クリップに従う |
| アスペクト比 | テキストとリファレンスのリクエストでは 16:9(既定)、9:16、4:3、3:4、1:1、21:9、adaptive。画像から動画は開始画像に従う |
| リファレンスの上限 | リファレンスから動画では、画像 10 枚、動画 5 本(合計 30 秒)、音声 5 本まで |
| リファレンス動画の条件 | 1 本につき 2 秒以上として数え、約 409,600 ピクセル(854×480 以上)が必要 |
| 編集の入力 | 4〜30 秒の |
| 音声 |
|
| 出力オプション | mp4(既定)または mov。watermark は既定でオフ。 |
| 課金の基準 | 解像度ごとの秒単位。リファレンス動画はその秒数を加算、編集は元クリップの秒数。失敗した生成は無料 |
| 実測の生成時間 | 4 秒・480p で 84 秒〜約 11 分(2026 年 11 月 13 日の実行) |
主な機能とハイライト
上限を下げた、フラッグシップのワークフロー
Flash は、下書きに向く Seedance 2.5 の 4 つのワークフロー(テキスト、開始・終了フレーム、混合リファレンス、クリップ編集)を残して 1080p と 4K を外し、画像から動画モードを使った動画延長を加えています。BytePlus はこのトレードオフを、フラッグシップに近い結果をほぼ 2 倍の速度で、と説明しています。私たちの 4 秒・480p のレンダーは 84 秒から約 11 分かかったので、速度はご自身のキューで測ってください。
プロンプトで、アップロードごとに役割を与える
素材は、スペースを入れた種類と順番(@Image 1、@Video 1、@Audio 1)で呼びます。2 枚のポートレートを @Image 1 と @Image 2 にして 16:9 で試したときは、2 人が同じエレベーターの場面に並び、顔、髪、服もそのまま保たれました。画像 1 枚、クリップ 1 本、声のファイル 1 本の場合は、クリップの通り、黄色い路面電車、追いかけるカメラが引き継がれましたが、人物は背中を向けたままで、@Image 1 の顔はほとんど映りませんでした。
晴れた通りが雪の夕方に
2 人の乗り手、自転車、路面電車、カメラの動きは、元のフレームとコマごとに一致し、天気と光だけが変わって、ほかは変わりませんでした。音声オフの 4.0 秒・480p のクリップで、元のサウンドトラックもそのまま残りました。
スイッチ 1 つで、どちらのサウンドトラックにするかが決まる
generate_audio は既定でオンで、映像と一緒にセリフ、効果音、環境音を生成します。動画編集でオフにすると元クリップ自身のトラックが残り(私たちのテストでは 44.1 kHz)、オンにすると @Audio 1 に沿える新しいトラックが生成されます。このスイッチは料金に影響しません。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 必須です。何がどの順に動き、カメラがどう振る舞い、何が聞こえるかを書き、見た目は画像に任せます。 1 文字以上 · 20000 文字以内 |
image_url | はい | 必須です。クリップはこの画像から始まり、比率もこの画像から決まります。 |
last_image_url | いいえ | 任意の終了フレームで、 |
resolution | いいえ | 480p または 720p を指定します。省略時は 720p です。 |
duration_seconds | いいえ | 整数秒の 4〜30 を指定でき、既定値は 5 秒です。依頼した秒数はすべて課金されます。 |
generate_audio | いいえ | 既定はオンで、Audio: の行と画像から、同じ処理の中で音が生成されます。音声なしのクリップが必要なときはオフにします。 デフォルト値: |
output_format | いいえ | 形式は mp4(既定)または mov です。編集ソフトやプレーヤーが求めるコンテナを選んでください。 |
return_last_frame | いいえ | 既定はオフです。オンにすると、最後のフレームが JPEG としても返り、次の呼び出しの |
watermark | いいえ | 既定はオフです。オンにすると、モデルの見える透かしがフレームに入ります。 デフォルト値: |
料金
指定した秒数で課金され、単価は選んだ解像度で決まります。終了フレーム、音声スイッチ、透かし、最後のフレームの画像、ファイル形式は料金に影響せず、失敗した生成は課金されません。
| 仕様 | 料金 |
|---|---|
| $0.115 / 秒 |
| $0.2392 / 秒 |
ユースケース
最終レンダーの前にショットの流れを試す
末尾に Audio: の行を付けた 4 秒・480p・16:9 のプロンプトを送ります。例は雨の夜の横断歩道です。私たちのテストでは、24 fps の 854×480、長さ 4.064 秒で、雨音と笑い声の AAC ステレオ音声が付いて返りました。語句を 1 つだけ変えて再実行すれば、何が変わったかを見比べられます。
撮影済みの映像のスタイルを変える
4〜30 秒のクリップをアップロードし、変更点を書いたあと、残すものを並べます。テストでは、2 人の自転車と路面電車がいる晴れた通りが雪の夕方になり、generate_audio をオフにすると元のサウンドトラックがそのまま返りました。
キャラクターと商品のモックアップ
人物写真と商品写真を @Image 1 と @Image 2 として付け、9:16 を指定します。2 枚の画像を使ったテストでは、男性がガラスのスポイトボトルをレンズに向けて持ち上げる 480×854 の映像が返り、両方のリファレンスが反映されました。結果はアイデアの確認に使い、そのあとで仕上げ版を作ってください。
ポートレートのループアニメーション
同じ写真を image_url と last_image_url の両方に指定し、その間の動きを書きます。陶芸家のポートレートでは、562×748・4.064 秒のクリップが返り、最初と最後のフレームがどちらも元のポーズと一致しました。
1 つのショットを次のショットにつなぐ
return_last_frame を true にすると、MP4 と一緒に最後のフレームの JPEG が届きます(テストでは 480p・16:9 で 854×480)。その JPEG を次の画像から動画のリクエストの image_url に渡せば、次のショットを前のショットの終わりから始められます。
プロンプトガイドと実践のヒント
入力に合わせてエンドポイントを選ぶ
プロンプトだけならテキストから動画、開始フレームがあるなら画像から動画、画像・クリップ・声を使うならリファレンスから動画、手元の 4〜30 秒のクリップを直すなら動画編集、最大 60 秒のクリップに 4〜30 秒を足すなら動画延長を使います。5 つとも、480p/720p の範囲と
generate_audioのスイッチは共通です。createTask リクエストを送る
POST https://api.spicyapi.ai/api/v1/jobs/createTask に、ヘッダー Authorization: Bearer YOUR_SPICY_API_KEY と、ボディ {"model": "bytedance/seedance-2.5-flash/text-to-video", "input": {"prompt": "A lighthouse keeper climbs a spiral stair at dawn and wipes fog from the lamp glass. Audio: wind, boots on iron.", "
duration_seconds": 4, "resolution": "480p"}} を付けて送信します。完成したクリップをポーリングで取得する
レスポンスには、state が queued の taskId が入っています。state が succeeded になるまで GET /api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID を呼ぶか callBackUrl を渡し、完了したら output.assets から MP4 の URL を読み取ります。項目の詳細は、docs.spicyapi.ai/docs/tasks のタスクガイドにあります。
1 つの語句を変えて、次へ進む
バリエーションは 480p・4 秒で比べ、1 回の実行で変えるのは 1 つの語句だけにします。うまくいったテイクは、720p と目的の長さで再実行するか、1080p が必要なら同じ指示を Seedance 2.5 に送ってください。
Seedance 2.5 Flash の画像から動画:1 回の呼び出しで
Seedance 2.5 Flash の画像から動画は、ByteDance の Seedance 2.5 高速版で、1 枚の画像を動かす方法です。画像を image_url、動かしたい内容を書いたプロンプトを送ると、モデルは画像から始まる 4〜30 秒の MP4 を 480p か 720p で返し、音声も同じ処理の中で生成されます。last_image_url を加えると、クリップは 2 枚目の画像に着地するため、ループ、元のポーズへの復帰、A から B へのトランジションに使えます(最初と最後のフレームを指定する動画として、よく検索されます)。ByteDance のクラウドプラットフォームである BytePlus は、Flash が Seedance 2.5 に近い結果をほぼ 2 倍の生成速度で出せるとしています。
リクエスト例
Authorization: Bearer YOUR_SPICY_API_KEY と Content-Type: application/json を付けて POST https://api.spicyapi.ai/api/v1/jobs/createTask を送ります。このボディは私たちの陶芸家のテストで、1 枚のポートレートを開始フレームと終了フレームの両方に使っています。
{
"model": "bytedance/seedance-2.5-flash/image-to-video",
"input": {
"image_url": "https://example.com/potter-portrait.jpg",
"last_image_url": "https://example.com/potter-portrait.jpg",
"prompt": "The potter cups the spinning clay and slowly draws its wall upward, then lifts her eyes to the camera with a warm smile and settles back into the same pose. Locked-off medium shot, soft window light. Audio: the steady hum of the wheel and the wet squeak of clay, no music.",
"duration_seconds": 4,
"resolution": "480p",
"generate_audio": true
}
}
レスポンス例
送信するとすぐに、タスク ID が返ります。
{"code": 200, "msg": "success", "data": {"taskId": "task_abc123", "state": "queued"}}
GET /api/v1/jobs/recordInfo?taskId=task_abc123 をポーリングするか、callBackUrl を渡してください。完了したタスクには MP4 が含まれます(タスク API ガイドを参照)。
{"code": 200, "msg": "success", "data": {"taskId": "task_abc123", "state": "succeeded", "output": {"assets": [{"url": "https://example.com/potter.mp4"}]}}}
パラメーター
| パラメーター | 値 | 既定値 |
|---|---|---|
image_url | 開始フレーム | 必須 |
last_image_url | 終了フレーム(image_url と一緒に送る) | 任意 |
prompt | 動き、カメラ、音 | 必須 |
duration_seconds | 4〜30 | 5 |
resolution | 480p、720p | 720p |
generate_audio | true、false | true |
watermark | モデルの見える透かし | false |
return_last_frame | 最後のフレームも JPEG で返す | false |
output_format | mp4、mov | mp4 |
aspect_ratio の項目はありません。BytePlus のドキュメントによると、モデルは出力の画面比を開始フレームと一致させます。
課金の仕組み
課金は指定した秒数ごとで、単価は解像度で決まります。このページの価格に両方が表示されています。陶芸家のリクエストでは 4 秒を指定し、ファイルは 4.064 秒で、課金は 4 秒分でした。終了フレーム、音声のオン・オフ、透かし、最後のフレームの JPEG、ファイル形式は料金を変えません。生成に失敗したリクエストは請求されません。
うまくいかせるコツ
- 最初から開始シーンに見える画像を選ぶ。 画像で被写体、場所、光が決まるので、ショットを始めたい位置に被写体を置いてください。
- アップロード前にトリミングする。 私たちの縦長の元画像は、480p で 562×748 になって返りました。縦長なら 9:16、正方形なら 1:1、横長なら 16:9 に切ってください。
- 動きをプロンプトにする。 陶芸家のプロンプトには、服やスタジオの描写がありません。動作を順に並べ、そのあとにカメラと光を書いています。
Audio:の行で終える。 私たちの例の、ろくろの低い回転音や粘土の湿った音のように、画像から想像できる音を並べます。「no music」と書けば、自分の音楽を載せる余地が残ります。last_image_urlは 3 通りに使う。 ループや元のポーズへの復帰には、開始画像を繰り返します。私たちの陶芸家の実行は、元のポーズに戻って終わりました。A から B への動きには、構図と光が同じ関連画像を送り、その間の道筋を書きます。使わずに省くこともできます。- 2 枚のフレームをそろえる。 被写体の位置、トリミング、光を近づけてください。ループの実行は 1 件しか記録がないので、継ぎ目のない繰り返しに頼る前に、プレーヤーでつなぎ目を確認してください。
- ショットをつなぐ。
return_last_frameをオンにし、その JPEG を次のimage_urlとして送ります。
テストでわかったこと
2026 年 11 月 13 日、上記の陶芸家のリクエスト(4 秒、480p、音声オン)は、562×748・4.064 秒のクリップで返り、最初と最後のフレームは元のポーズに戻りました。同じリクエストが、1 回の実行では 84 秒、別の実行では 4.8 分かかったので、数分かかる前提で、ポーリングか callBackUrl を使ってください。720p や長めのクリップでは、さらに時間を見込んでください。
制限とエラー
- Flash の出力は 480p と 720p です。1080p、4K、動画延長のエンドポイントはありません。
image_urlとpromptはどちらも必須で、duration_secondsは 4〜30 の整数です。これに反するリクエストは無効になるので、項目を直して再送してください。- モデルは独自の著作権・肖像のチェックを行い、私たちのテキストから動画のリクエストの 1 件がそこで止まりました。失敗したタスクは課金されません。そのまま再送せず、画像か文言を変えてください。
- 自分で所有しているか、この用途のライセンスを持つ画像を送ってください。実在の人物の写真を、本人の許可なく動かしたり、実際の映像として見せたりしないでください。
兄弟モデルを選ぶとき
- Seedance 2.5 画像から動画:1080p、4K、ドラフトモード、クリップの延長が必要なとき。
- Seedance 2.0 Fast:480p と 720p の前世代。
- Flash リファレンスから動画:人物や商品を、冒頭ではなく新しいシーンに登場させたいとき。
- Flash テキストから動画:画像がないとき。Flash 動画編集:スタイルを変えたいクリップがあるとき。
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.5-flash/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"output_format": "mp4",
"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 リファレンスを参照してください。










