はじめに
Veo 3.1 の動画の延長：クリップを送ると、その最後のフレームが 4〜8 秒の新しい画像から動画セグメントの最初のフレームになり、元のクリップとつないで返ります。
| 項目 | 値 |
|---|---|
| 入力 | 動画 |
| 出力 | 動画 |
| 提供元 | |
| 長さ | 4、6、8 秒 |
| 解像度 | 720p（横長 1280x720、縦長 720x1280） |
| アスペクト比 | 16:9、9:16 |
| フレームレート | 24 fps |
| 音声 | すべてのクリップに生成 |
主な機能とハイライト
書いた順番どおりに組み立てられる一つのショット
プロンプトでは、ドームが開き、望遠鏡が現れ、カメラが手すりに沿って動くように指定しました。9:16 の 4 秒で、シャッターは閉じた状態から全開まで滑り、内部は真鍮の望遠鏡の周りで琥珀色に照らされ、カメラは曲がった手すりに沿って前進しました。指定した順番どおりです。
最後のフレームにぴたりと着地
開始フレームは、望遠鏡の前で後ろ姿を見せる女性。終了フレームは、腕を組んで手すりにもたれる女性です。4 秒で彼女は振り返り、手すりまで歩いて終了のポーズに収まり、ドームの上では星が増えていきました。
4 秒なら一つの動作がちょうど収まる
一枚の開始フレームから、「He folds the map and looks up.」というプロンプトを使いました。4 秒で男性は両手で地図をたたみましたが、終了フレームではまだ下を見ていました。4 秒ごとに一つの動作を指定するか、2 つ入れるなら 8 秒を選んでください。
どのモデルのクリップでも続きを作れる
別のモデルで作った 5 秒のクリップを送り、「The road continues along the sea.」と指定して 4 秒を追加しました。新しい部分は海岸道路の空撮を引き継ぎ、車がカーブをたどりました。元のクリップと同じサイズの 9 秒のファイルが一本返ってきて、課金されたのは新しく加えた 4 秒だけでした。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 必須。続きのひと場面を書きます。 1 文字以上 · 4000 文字以内 |
video_url | はい | 元になる映像で、最長 60 秒です。最後のフレームが新しいセグメントの起点になるので、くっきりしたフレームで切ってください。 1 文字以上 |
last_image_url | いいえ | 任意。新しいセグメントの結びに使う画像です。 1 文字以上 |
duration_seconds | いいえ | 追加する長さは 4・6・8 秒（既定は 8 秒）です。長いセグメントほど料金が上がります。 |
料金
新しいセグメント単位で、4、6、8 秒に応じた画像から動画の料金です。元のクリップは課金されません。失敗または拒否されたリクエストは無料です。
| 仕様 | 料金 |
|---|---|
| $1.44 / リクエスト |
| $2.16 / リクエスト |
| $2.88 / リクエスト |
ユースケース
安い下書きの後に最終レンダー
プロンプト、構図、タイミングは Veo 3.1 Fast（4 秒あたり $0.36）や Lite（$0.18）で詰め、残すバージョンだけ同じリクエストを Veo 3.1 に送ってください。3 つとも同じフィールドを受け付けます。
撮影現場の静止画で始まり終わる、商品や場所のショット
開始の静止画と終了の静止画を渡し、その間の動きを説明します。当社のテストでは、4 秒でクリップが最後のフレームに着地しました。
8 秒を超えるシーン
最初の 8 秒を生成し、動画延長で続けます。クリップの最後のフレームから新しい 4〜8 秒のセグメントが始まり、つなげた 1 本のファイルが返ってきます。元のクリップ（最長 60 秒）には課金されません。
ソーシャル投稿用の縦型・音声付きクリップ
720x1280 のクリップには 9:16 を選びます。音声は映像と一緒に生成されるので、別の音声作業なしに短い動画がすぐ使えます。
プロンプトガイドと実践のヒント
起きる順番どおりに書く
場所と光、被写体、動作、カメラの動き、最後に音。当社の天文台のプロンプトはこの順で書き、クリップも同じ順番でビートを再生しました。
セリフと音を演出する
「Sound: wind over sand, the dome's motor」のように、欲しい音を書きます。話す言葉は引用符で囲みます。Google は、ごく短いセリフの自然な音声はまだ改善途上としているため、話すシーンには数秒の余裕を持たせてください。
動作を長さに合わせる
4 秒ごとに明確な動作は一つにしてください。当社の 4 秒のテストでは、「folds the map and looks up」は折るところまでしか届きませんでした。
Veo 3.1 は採用する 1 本に使う
同じ長さなら Veo 3.1 は Fast の 4 倍、Lite の 8 倍の料金です。言葉選びと構図は安い段階で固め、最終版をここで一度だけ生成してください。
概要
Veo 3.1 動画の延長 は、SpicyAPI 独自の方法で手元の映像を Veo 3.1 でつなげる機能です。クリップ（最長 60 秒）の最後のフレームから、Veo 3.1 の画像から動画で新しい 4、6、8 秒のセグメントを作り、両方をつなげた 1 本の MP4 を返します。Google 標準のシーン延長機能ではありません。Google がプロンプトと画像を審査し、拒否されたリクエストは失敗扱いで課金されません。
Veo 3.1 のモードを選ぶ
| 手元にあるもの | 使うモード |
|---|---|
| 文章だけで書いたシーン | Veo 3.1 テキストから動画 |
| 始まりまたは終わりに使いたい静止画 | Veo 3.1 画像から動画 |
| 続きを作りたい映像 | Veo 3.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": "google/veo-3.1/video-extend",
"input": {
"duration_seconds": 8,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"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 リファレンスを参照してください。