はじめに
video_url(最長 60 秒のクリップ)と、その後に起きることを書いたプロンプトを送ります。duration_seconds、resolution、generate_audio、last_image_url、watermark は任意です。プラットフォームがクリップの最後のフレームを取り出し、Flash の画像から動画で続きを描いて元の映像の後ろにつなぎます。フレームレートと元の音声はそのまま残ります。
| 項目 | 値 |
|---|---|
| 入力 | 動画 |
| 出力 | 動画 |
| 提供元 | 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 文字以内 |
video_url | はい | 必須です。MP4、MOV、WebM で、長さは 60 秒まで、長辺は 3840 ピクセルまでです。 1 文字以上 |
last_image_url | いいえ | 任意です。新しい区間を締めくくる画像で、決まったポーズや構図に着地させたいショットに使います。 |
resolution | いいえ | 新しい区間の解像度で、480p か 720p、既定値は 720p です。秒単価はこの選択で決まります。 |
duration_seconds | いいえ | 新しい区間の長さで、整数秒の 4〜30、既定値は 5 秒です。課金されるのはこの秒数だけで、元の映像はつないだファイルの前半に無料で入ります。 |
generate_audio | いいえ | 既定でオンです。Flash がプロンプトと画像から新しい区間の音を作り、つなぎ目で元のクリップの音とクロスフェードします。 デフォルト値: |
watermark | いいえ | 既定でオフです。オンにすると、モデルが新しい区間に見える形で AI 生成の印を入れます。 デフォルト値: |
料金
新しい区間だけが、Flash の画像から動画と同じ方法で課金されます。指定した秒数ごとに、選んだ解像度の単価がかかります。元のクリップとつなぎ合わせの処理は追加料金なしで、音声、終了フレーム、透かしも料金を変えません。延長に失敗した場合は課金されません。
| 仕様 | 料金 |
|---|---|
| $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 の動画延長は、手元のクリップに新しい映像を足す機能です。SpicyAPI が video_url の最後のフレームを取り出し、プロンプトと一緒に Flash の画像から動画へ開始画像として渡し、できあがった 4〜30 秒の映像を元のクリップの後ろにつなぎます。最初から最後まで通して再生できる MP4 が 1 本と、新しい区間だけのファイルが返り、どちらも 480p か 720p で音声付きです。
リクエスト例
Authorization: Bearer YOUR_SPICY_API_KEY を付けて POST https://api.spicyapi.ai/api/v1/jobs/createTask を送ります。6 秒のクリップに 5 秒を足す例です。
{
"model": "bytedance/seedance-2.5-flash/video-extend",
"input": {
"video_url": "https://example.com/cyclist.mp4",
"prompt": "The cyclist rests one foot on the curb, the light turns green, and she pushes off out of frame to the left while the camera holds still. Audio: idling traffic, a short bell ring.",
"duration_seconds": 5,
"resolution": "720p"
}
}
レスポンス例
{"code": 200, "msg": "success", "data": {"taskId": "task_abc123", "state": "queued"}}
GET /api/v1/jobs/recordInfo?taskId=task_abc123 をポーリングするか、callBackUrl を渡してください。output.assets には、つないだクリップ(video)が先に、新しい部分(segment)が次に並びます。実際の長さには小数が付きます。
{"code": 200, "msg": "success", "data": {"taskId": "task_abc123", "state": "succeeded", "output": {"assets": [{"url": "https://example.com/joined.mp4", "role": "video", "durationSeconds": 11.0}, {"url": "https://example.com/segment.mp4", "role": "segment", "durationSeconds": 5.0}]}}}
パラメーター
| パラメーター | 値 | 既定値 |
|---|---|---|
video_url | MP4、MOV、WebM、60 秒まで | 必須 |
prompt | 最後のフレームの後に起きること | 必須 |
duration_seconds | 4〜30(新しい区間) | 5 |
resolution | 480p、720p | 720p |
generate_audio | true、false | true |
last_image_url | 新しい区間が終わる画像 | 任意 |
watermark | 新しい区間に入るモデルの印 | false |
新しい区間はクリップの最後のフレームと同じ形になり、つないだファイルは常に MP4 です。
課金の仕組み
新しい区間の料金は Flash の画像から動画と同じで、指定した秒数ごとに解像度の単価がかかります。元のクリップとつなぎ合わせは無料で、音声、終了フレーム、透かしを使っても料金は変わりません。続きの生成やつなぎ合わせに失敗した場合は全額返金されます。
うまくいかせるコツ
- 元の映像は、はっきりと止まったフレームで終える。 最後のフレームのぶれ、カット、フェードは新しい区間に持ち越されるので、きれいな瞬間で切ってください。
- 場面ではなく、次に起きることを書く。 誰がいて、どう照らされているかはフレームがすでに決めています。
- 続けたい動きは書き直す。 静止画には速さがないので、「同じ速さで左へ歩き続ける」のように書いてください。
- 音を設計する。 元の映像の環境音に合う
Audio:の行で締めるか、generate_audioをオフにして後から音楽を付けてください。
制限とエラー
- 出力は 480p か 720p です。1080p の元映像も受け付けますが、新しい部分はその画面上でやわらかく見えます。
- 渡せるのはフレーム 1 枚だけなので、画面の外にあるもの、カメラの勢い、音のリズムは引き継がれません。つなぎ目で光が少し変わることもあるので、つなぎ目を確認してください。
- 60 秒を超える映像、長辺が 3840 ピクセルを超える映像、読み込めないファイルは、課金なしで拒否されます。
- エンドポイントの正式名で呼び出してください。ファミリー単位の呼び出しで
video_urlを送った場合、duration_seconds、last_image_url、watermarkのどれかがあるときだけここに届き、それ以外は動画編集として実行されます。 - 延長するのは、自分が権利を持つか使用を許された映像だけにし、実在の人物の映像は本人の同意なしに続けないでください。
フラッグシップの延長を選ぶとき
Seedance 2.5 の動画延長は 1080p まで出力でき、フレーム 1 枚ではなくクリップの最後の最大 30 秒を読み取るので、動きや声を途切れさせずに続けたいときに向いています。その参照秒数も課金対象です。
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/video-extend",
"input": {
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"video_url": "https://example.com/reference.mp4"
}
}'
# 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 リファレンスを参照してください。










