Wan 3.0 Pro API

Wan 3.0 Pro 参照から動画 は、画像・動画・音声の参照素材を使って、顔、衣装、セット、動き、声をショットをまたいで保ち、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 本のマスターから複数のトリミング

参照素材で固定したショットを 4K でレンダリングすると、バナー用にも縦長のカットダウン用にもトリミングできるマスターになります。衣装のサンプルはコートの素材 1 枚を送り（「Keep the coat from the reference exactly — cut, colour and stitching」）、音声をオフにして 4k で 6 秒レンダリングしています。モデルが暗いステージで 1 回ターンし、裾がふわりと上がって落ち着きます。

納品サイズではずれが見えやすい

ショット間で顔が変わると、高解像度ではすぐに分かります。これはレビューに役立ちます。シーケンスの各ショットを納品サイズでレンダリングし、確定前に並べて比べてください。2k と 4k はネイティブの 1080p レンダリングを拡大したものなので、レンダリング由来の不一致を隠すのではなく、むしろ表に出します。

参照素材の枠

参照画像と参照音声は課金されず、参照動画の秒数は出力と一緒に課金されます。動画と音声の参照はそれぞれ合計 15 秒までで、各クリップは 1〜15 秒、参照動画と duration_seconds の合計は 30 秒以内でなければなりません。これらの上限は送信時ではなく生成中に適用されるので、先にクリップの長さを確認してください。

顔とセットに名前を付けたシリーズもののショット

顔とセットのサンプルは、素材 2 枚と動作の行 1 つを送っています。「The first image is the character — keep her face, hair and the black gown. The second image is the room.」彼女はゆっくりした横移動のカメラの中を戸口から窓まで歩きます。1080p で 8 秒、シードは 640117 です。1 話のすべてのショットで同じ素材とシードを使い、動作だけを変えてください。

同じ 2 人、違う光

1 日の 3 つの時間帯の例は、光が変わるあいだも 2 人と 1 つのアパートを保ちます。窓辺の朝、キッチンカウンターの夕暮れ、バルコニーの夜。光以外のすべてが保たれなければならないので、連続性としては厄介なケースです。人物と部屋は参照素材が運ぶので、プロンプトには違う部分だけを書きます。

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