はじめに
Vidu Q4 Preview 動画延長は、手元にあるクリップの続きを作ります。video_url にクリップを渡し、次に起きることをプロンプトに書いてください。クリップの最後のフレームが 3〜16 秒の新しい Vidu Q4 Preview 画像から動画ショットの開始フレームになり、両者は 1 本の MP4 につながります。元の動画が先、続きが後で、つなぎ目で重複するフレームは取り除かれます。新しい区間も単独のファイルとして返るので、さらに延長したり、部分ごとに編集したりできます。
主な機能とハイライト
連続性は最後のフレームから生まれます。衣装、セット、光、人物の立ち位置が引き継がれるのは、新しい区間が文字どおりあなたの最後のフレームから始まるからです。動きは同じようには引き継がれません。モデルが見るのはクリップ全体ではなく静止画 1 枚なので、速さや向きがそのまま続くと考えず、続けたい動きを書いてください。
返るのは 1 本のファイルと、新しい部分の単体です。つないだ MP4 は元のクリップのフレームレートと構図を保ち、黒帯は入りません。つなぎ目を合わせるため、画面の端が数パーセント程度切り取られたり調整されたりすることがあります。モデルが返した映像の縦横比が大きく異なる場合は、新しい区間を画面いっぱいに拡大して中央に合わせ、はみ出した部分を切り取ります。ファイルは H.264 の MP4 と AAC の音声で書き出されます。元の音声は残り、新しい区間で生成した音声はその後に続きます。片方が無音のときは無音で埋めるので、つなぎ目で映像と音がずれません。出力の 2 つ目のアセットは新しい区間だけで、次の延長や編集にそのまま使えます。
それ以外はすべて Vidu Q4 Preview の画像から動画への生成と同じです。新しいセグメントは同じ経路で動き、コンテンツの範囲も画像から動画へのエンドポイントと同じ、秒単位の価格も同じです。失敗した生成は同じ方法で返金されます。拒否も含まれます。かなり強めのレベルのリクエストは拒否され、拒否されたリクエストには課金されません。生成は成功したのにつなぎ合わせ自体が作れなかった場合は、タスクは失敗し、課金は返金されます。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 必須、最大 20,000 文字です。次に起きること、つまり続く動作、カメラの動き、音を書きます。 1 文字以上 · 20000 文字以内 |
video_url | はい | 続けたいクリップです。MP4、MOV、WebM で 60 秒まで。 1 文字以上 |
resolution | いいえ | 生成される新しい区間の精細さです。540p、720p、1080p、2k、4k から選び、既定は 720p です。 |
duration_seconds | いいえ | 新しい区間の長さです。3〜16 の整数秒で指定し、既定は 5 です。 |
generate_audio | いいえ | 既定でオンで、新しい区間に生成した音が付きます。元の動画の音はどちらの場合も残ります。 デフォルト値: |
enable_prompt_expansion | いいえ | 既定でオフ。オンにすると生成前にモデルがプロンプトを書き直して広げます。 デフォルト値: |
seed | いいえ | 0〜2147483647。1 フィールドずつ比べるときは固定し、幅が欲しいときは外してください。 |
料金
新しい区間の秒数を、選んだ解像度で課金します。送った元のクリップは課金されません。拒否されたリクエストは課金されません。
| 仕様 | 料金 |
|---|---|
| $0.045 / 秒 |
| $0.095 / 秒 |
| $0.12 / 秒 |
| $0.19 / 秒 |
| $0.39 / 秒 |
ユースケース
終わるのが早すぎたショットを伸ばせます。ラベルがカメラを向く前に止まった商品の回転台や、人物がドアに着く前に切れた歩きのカットです。数秒延長して、残りの動きだけを書いてください。
長いシーケンスを一段ずつ組み立てられます。最初のショットを作って延長し、つないだ結果が 60 秒の上限に収まる間はさらに延長できます。どの段も課金されるのは追加した秒数だけです。各段は 1 枚のフレームから始まるので、次を重ねる前につなぎ目を確認してください。
プロンプトガイドと実践のヒント
シーン全体ではなく、次の一拍を書いてください。誰がどこにいるかはフレームが決めているので、プロンプトはその後の動作、カメラの動き、音に使います。クリップの終わりと同じカメラの言葉、たとえばゆっくりしたプッシュインや固定ショットを繰り返すと、つなぎ目が 1 テイクに見えます。
延長の前にトリミングしてください。モデルが見るのは最後のフレームだけなので、ぶれたフレーム、カットの途中、圧縮の強い終わり方はそのまま続きに持ち込まれます。先にクリーンでシャープなフレームで切ってください。元の動画は 60 秒まで、MP4、MOV、WebM に対応しています。
解像度をそろえてください。解像度が決めるのは新しい区間をどれだけ精細に生成するかだけなので、低く設定すると新しい部分が元より甘く見えます。元のクリップに解像度を合わせ、duration_seconds は本当に必要な長さにしてください。課金は新しい区間だけに対して行われます。
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": "vidu/q4-preview/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 リファレンスを参照してください。
