Wan 3.0 API

Wan 3.0 参照から動画 は、渡した参照素材から新しい 2〜30 秒のショットを組み立てます。1 リクエストで画像 10 枚、動画クリップ 5 本、音声クリップ 5 本まで使えます。reference_image_urls、reference_video_urls、reference_audio_urls、reference_file_url、reference_link_url のうち少なくとも 1 つが必要で、プロンプトは省略できます。顔、衣装、ロケーション、声を、別々にレンダリングしたショットのあいだで同じに保ちたいときに使います。text-to-video は実行のたびに新しい顔を作り出すので、これはできません。出力は 480p・720p・1080p で、既定は 720p です。

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

画像は人物、衣装、セットのために

reference_image_urls には 1〜10 枚の画像（人物、衣装、セットの素材）を渡せます。形式は JPEG、透過なしの PNG、BMP、WEBP で、1 辺 240〜8000 ピクセル、1 枚あたり最大 20 MB です。参照画像は課金されません。それぞれが何かをプロンプトで名指ししてください。そうしないと、モデルは画像を平均し、どれにも似ていない被写体にしてしまいます。

動画は動きのために、音声は声のために

参照動画が運ぶのは顔ではなく、動きとカメラのスタイルです。MP4 か MOV のクリップを 5 本まで、1 本 1〜15 秒・合計 15 秒以内、16 fps 以上で渡せます。参照音声が運ぶのは声、セリフの読み方、ルームトーンで、WAV か MP3 のクリップを 5 本まで、こちらも合計 15 秒以内です。これらの上限はタスクの受け付け時ではなく生成中にチェックされるので、送信前にクリップの長さを測っておいてください。

出力と共有する 30 秒の枠

参照動画の秒数は出力と合わせて課金され、参照動画の長さと duration_seconds の合計は 30 秒を超えられません。たとえば 12 秒の動き参照を使うと、出力は最大 18 秒になります。参照画像と参照音声はこの枠に含まれません。

決まった部屋で同じ人物を撮り直す

人物と部屋のサンプルは 2 枚の画像を送り、プロンプトで役割を名指ししています。「Image 1 is the character — keep her face, hair and the black slip dress exactly. Image 2 is the room.」そのうえで、ゆっくりした横移動のカメラの中を彼女が窓辺まで歩きます。720p で 8 秒、シードは 771120 です。2 枚の素材とシードを固定し、動作の行だけを変えるのが、シリーズものに向いたリクエストの形です。

声まで合わせた話し手

独白のサンプルは、話し手の顔と衣装のための画像 1 枚と、声のための参照音声 1 本を組み合わせています。プロンプトは両者の役割を分けたうえで、朝の光が入るキッチンテーブルでの固定のミディアムショットを書いています。720p で 10 秒です。テイクをまたいで同じ声でなければならない司会者、ナレーター、繰り返し登場する人物は、この形に従います。

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