Wan 3.0 Pro Prime API

Wan 3.0 Pro Prime 画像から動画 は Prime のレンダリングで開始フレームを動かし、1080p・2K・4K で 2〜30 秒のクリップとして納品します。image_url は必須で、そのまま最初のフレームになります。プロンプトは省略でき、書くなら動きとカメラを書きます。任意の last_image_url で最後のフレームを固定できます。フィールドは Wan 3.0 Pro 画像から動画と完全に同じなので、そちら用に組んだリクエストはモデル名を変えるだけでここでも動きます。

開始素材に応じてモードを選ぶ

フォーカス送りのような 2 フレームの指示

フォーカス送りは本来 2 つのフレームで成り立つもので、last_image_url はまさにそのためにあります。つぼみのサンプルは花のつぼみにピントの合ったフレームで始まり、その奥のボタンを外したシャツにピントが合った、渡したフレームで終わります。4k で 6 秒です。プロンプトが言うのは、ピントがいつ移るかだけです。被写界深度がとても浅いと、終わりを固定しなければ正しい面に着地する余地がほとんどありません。

上限を決めるのは段階ではなく元画像

解像度が決めるのはレンダリングで、入力ではありません。2k と 4k はネイティブの 1080p レンダリングを拡大したものなので、手元でいちばんシャープな静止画を渡してください。JPEG、透過なしの PNG、BMP、WEBP で、1 辺 240〜8000 ピクセル、最大 20 MB、縦横比 8:1 以内です。

音楽を後付けする前提のホールド

路地の光のホールドのサンプルは、2k で 4 秒、音声とプロンプト拡張の両方をオフにしたホールドです。「Nobody moves. Only the neon tube above her stutters and the rain keeps falling, dragging its reflection across the wet plastic. Locked camera.」自前の音を持たず、編集で音楽を付けるショットのためのリクエストの形です。

動かない被写体のまわりで変わる環境

ネオンの路地のサンプルは、路地、雨、透明なレインコートがすでに写った素材から始まるので、プロンプトは変わるものだけを書いています。強まる雨、一度だけちらつくネオン管、通気口から噴き出す湯気、そしてそのすべての間レンズを見つめ続ける被写体。音声の行は、鉄板を打つ雨、うなるネオン管、シューッという通気口と、音源を 1 つずつ挙げています。

終わりを固定したクローズアップ

シャツのサンプルは、つぼみのサンプルと同じ 2 枚のフレームを 1080p・4 秒で再利用しています。斜めから差す金色の光の中で手が開いたシャツをゆっくり脇へ寄せ、また落とし、そのあいだに折り目の間のつぼみが少し開きます。両端を固定することで、ごく浅い被写界深度でも狙った面に着地させられます。

# 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-pro-prime/image-to-video",
  "input": {
    "aspect_ratio": "adaptive",
    "duration_seconds": 5,
    "image_url": "https://example.com/reference.png",
    "resolution": "1080p"
  }
}'

# 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 リファレンスを参照してください。