Wan 3.0 Prime API

Wan 3.0 Prime 参照から動画 は、Prime のレンダリングで、最大で画像 10 枚、動画 5 本、音声 5 本の参照素材から 2〜30 秒のショットを組み立てます。フィールドは Wan 3.0 参照から動画と同じです。参照の配列、参照ファイル、ウェブリンクのうち少なくとも 1 つが必要で、プロンプトは省略できますが、書く場合は各参照素材が何を担うかを示すべきです。解像度は 480p・720p・1080p（既定は 720p）、aspect_ratio の既定値は 16:9 です。

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

人物の素材 1 枚と、文章から作る場面全体

素材 1 枚で人物を担い、それ以外はすべてプロンプトで作ることもできます。砂丘のサンプルは、無地のスタジオ背景でフラットに撮った人物の画像 1 枚だけを使い、月明かりの砂丘、風、彼女の頭上になびく数メートルのスカーフはすべて文章で書いています。テイクの終わりでもスカーフが同じ腕につながっている必要があるので、確認ポイントとして好都合です。

クリップから借りるカメラの動き

参照動画は顔ではなく、動きとカメラのスタイルのためのものです。動きのスタイルのサンプルは、参照クリップからゆっくりした手持ちの回り込みを取り出し、参照画像の女性に適用しています。何もないスタジオに立つ彼女を 720p で 6 秒。参照クリップは MP4 か MOV で、16 fps 以上、1 本 1〜15 秒、合計 15 秒以内である必要があります。

参照音声で声の連続性を保つ

WAV か MP3 の参照音声を合計 15 秒以内で 5 本まで使い、テイクをまたいで声を保てます。見た目は連続していても、ショットごとに声が違う司会者は連続していません。人物が複数のショットで話すなら、毎回同じ参照音声を送ってください。参照音声と参照画像は課金されません。

繰り返し登場する司会者

シリーズのすべてのリクエストで、顔とセットには同じ画像素材を、声には同じ参照音声を使います。司会者のサンプルは「the same presenter, the same studio」を保ち、動き（特定のフレーミングで終わるプッシュ）だけを書いています。人物の同一性はすでに参照素材が担っているからです。

スタイルをそろえたインサート

新しいショットを既存のショットと同じように動かしたいときは、そのクリップを動きの参照として、被写体には画像を渡します。動きのスタイルのサンプルのように、どちらが何かをプロンプトで明記してください。「Take the camera behaviour from the reference clip — a slow handheld orbit — and apply it to the woman in the reference image.」

# 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-prime/reference-to-video",
  "input": {
    "aspect_ratio": "16:9",
    "duration_seconds": 5,
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "reference_image_urls": [
      "https://example.com/reference.png"
    ],
    "resolution": "720p"
  }
}'

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