はじめに
Wan 3.0 Spicy 動画延長は、手元にあるクリップの続きを作ります。video_url にクリップを渡します。次に起きることをプロンプトに書くと続きを指定でき、書かなければモデルが自動で場面を続けます。クリップの最後のフレームが 2〜30 秒の新しい Wan 3.0 Spicy 画像から動画ショットの開始フレームになり、両者は 1 本の MP4 につながります。元の動画が先、続きが後で、つなぎ目で重複するフレームは取り除かれます。新しい区間も単独のファイルとして返るので、さらに延長したり、部分ごとに編集したりできます。
主な機能とハイライト
連続性は最後のフレームから生まれます。衣装、セット、光、人物の立ち位置が引き継がれるのは、新しい区間が文字どおりあなたの最後のフレームから始まるからです。動きは同じようには引き継がれません。モデルが見るのはクリップ全体ではなく静止画 1 枚なので、速さや向きがそのまま続くと考えず、続けたい動きを書いてください。このモデルは、プロンプトで指示していてもクリップの途中で衣装を勝手に変えることがあります。次の延長に進む前に、新しい区間を最後まで確認してください。
終わり方も任意で決められます。last_image_url を渡すと、新しい区間はその画像でちょうど終わるので、ショットを決めのアングルに戻したり、決まった構図にたどり着かせたりできます。渡さない場合は終わり方をモデルが決めます。開始は常にクリップの最後のフレームです。
返るのは 1 本のファイルと、新しい部分の単体です。つないだ MP4 は元の動画のフレームレートと画面の構図を保ち、黒帯は入りません。つなぎ目を合わせるため、画面の端が数パーセント切り取られたり調整されたりすることがあります。モデルが返した映像の縦横比が大きく異なる場合は、新しい区間を画面いっぱいに拡大して中央に合わせ、はみ出した部分を切り取ります。H.264 と AAC の音声で書き出されます。元の音声は残り、新しい区間で生成した音声がそのあとに続きます。片方が無音のときは無音で埋めるので、つなぎ目で映像と音がずれません。出力の 2 つ目のアセットは role が segment の新しい区間だけで、次の延長にそのまま使えます。
それ以外はすべて Wan 3.0 Spicy 画像から動画と同じです。新しい区間は画像から動画のエンドポイントと同じルート、同じ内容の許容範囲、同じ秒単価で生成され、音声、プロンプト拡張、シードの設定も使えます。生成に失敗したときの返金も同じです。last_image_url を付けると、新しい区間を選んだフレームで終わらせられます。生成は成功したのにつなぎ合わせだけができなかった場合は、タスクが失敗となり料金は返金されます。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | いいえ | 任意ですが、書く価値があります。次に起きること、カメラの動き、音を書いてください。 1 文字以上 |
video_url | はい | 続けたいクリップです。MP4、MOV、WebM で 60 秒まで。 1 文字以上 |
last_image_url | いいえ | 任意の目標の最終フレームです。新しい区間はこの画像で終わり、区間のアスペクト比に合わせてトリミングされます。 |
resolution | いいえ | 新しい区間を生成するときの解像度です。480p、720p、1080p から選び、既定は 720p です。 |
duration_seconds | いいえ | 新しい区間の長さです。2〜30 の任意の整数秒で、既定は 5 です。 |
generate_audio | いいえ | 既定でオンで、新しい区間に生成した音が付きます。元の動画の音はどちらの場合も残ります。 デフォルト値: |
enable_prompt_expansion | いいえ | 既定でオフ。オンにすると生成前にプロンプトが書き直され、薄いブリーフには効き、詳細なブリーフとは喧嘩します。 デフォルト値: |
seed | いいえ | 0〜2147483647。1 フィールドずつ比べるときは固定し、幅が欲しいときは外してください。 |
料金
新しい区間の秒数を、選んだ解像度で課金します。送った元のクリップは課金されません。
| 仕様 | 料金 |
|---|---|
| $0.057 / 秒 |
| $0.114 / 秒 |
| $0.228 / 秒 |
ユースケース
終わるのが早すぎたショットを伸ばせます。ラベルがカメラを向く前に止まった商品の回転台や、人物がドアに着く前に切れた歩きのカットです。数秒延長して、残りの動きだけを書いてください。
長いシーケンスを一段ずつ組み立てられます。最初のショットを作って延長し、つないだ結果をさらに延長します。どの段も課金されるのは追加した秒数だけです。各段は 1 枚のフレームから始まるので、次を重ねる前につなぎ目を確認してください。
プロンプトガイドと実践のヒント
シーン全体ではなく、次の一拍を書いてください。誰がどこにいるかはフレームが決めているので、プロンプトはその後の動作、カメラの動き、音に使います。クリップの終わりと同じカメラの言葉、たとえばゆっくりしたプッシュインや固定ショットを繰り返すと、つなぎ目が 1 テイクに見えます。プロンプトは省略できます。書かなければモデルがフレームからそのまま続けるので、雰囲気重視のショットや、演出の指定が少ないショットならそれで足ります。
延長の前にトリミングしてください。モデルが見るのは最後のフレームだけなので、ぶれたフレーム、カットの途中、圧縮の強い終わり方はそのまま続きに持ち込まれます。先にクリーンでシャープなフレームで切ってください。元の動画は 60 秒まで、MP4、MOV、WebM に対応しています。
解像度はそろえてください。1080p のクリップを 480p で延長すると、元の動画の隣でぼやけて見えます。元の解像度に合わせ、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": "alibaba/wan-3.0-spicy/video-extend",
"input": {
"duration_seconds": 5,
"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 リファレンスを参照してください。
