Wan 3.0 Pro Prime API

Wan 3.0 Pro Prime 参照から動画 は、画像・動画・音声の参照素材で顔、衣装、セット、動き、声を固定し、Prime のレンダリングで 1080p・2K・4K の 2〜30 秒のショットを作ります。reference_image_urls（順序付きの画像 1〜10 枚）、reference_video_urls、reference_audio_urls（それぞれクリップ 5 本まで）、reference_file_url（資料 1 件）、reference_link_url（ウェブページ 1 件）のうち少なくとも 1 つが必要です。各参照素材をプロンプトで名指ししてください。そうしないと、モデルはそれらを平均し、どれにも一致しない被写体にしてしまいます。

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

1 つのショットに 2 人の人物

2 人の人物のサンプルは、素材 2 枚を送ってラベルを付けています。「The first image is the woman, the second is the man — keep both faces and both haircuts.」2 人は薄暗いガレージの作業台の両側に立ち、明かりは吊り下げ電球 1 つ。1080p で 6 秒、シードは 220913、音はルームトーンだけです。1 話を通してカップルの一貫性を保つためのパターンです。

人のいないセット素材

参照素材は人物でなくてもかまいません。セットの連続性のサンプルは、ボクシングジム（ロープ、ロッカー、吊り下げ照明 1 つ）の素材を 1 枚だけ送り、光の中をほこりが漂い電球がゆっくり揺れる無人のフレームを、固定カメラ、4k・5 秒、音声オフで求めています。こうすれば、シーケンスのすべてのショットで同じ部屋を共有できます。

動きは書く代わりに参照する

画像、動画、音声の参照素材は一緒に渡せるので、動きを段落で書く代わりにクリップから持ってこられます。参照動画は MP4 か MOV、16 fps 以上、1 本 1〜15 秒、合計 15 秒までです。その秒数は出力と一緒に課金され、参照動画と出力の合計は 30 秒以内に収まります。

複数のステージをまたぐ衣装

ダンサーのサンプルは、1 人のパフォーマーと 1 着の重ねたシフォンの衣装を 3 つ目のステージへ運びます。今回はフォロースポットが背後から当たり、彼女が回るにつれて布が透けていきます。ダンサーと衣装は参照素材が運ぶので、プロンプトは新しい照明のセットアップだけを書いています。逆光で透ける布は、大きな納品サイズではほとんど何も隠してくれません。

再編集されるマスターファイル

参照素材で固定したヒーローショットを 16:9・4K でレンダリングし、同じマスターから 9:16 のカットダウンと正方形のバナーを切り出します。参照素材とシードの固定で、セット内のどの派生版でもキャストが同じに保たれます。

# 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/reference-to-video",
  "input": {
    "aspect_ratio": "adaptive",
    "duration_seconds": 5,
    "reference_image_urls": [
      "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 リファレンスを参照してください。