Wan 2.5 API

Wan 2.5 テキストから動画 は、書いたプロンプトだけから音声つきの 5 秒または 10 秒のクリップを生成します。必須フィールドは prompt（最大 1,500 文字）だけで、ほかはすべて既定値があります。16:9、720p、5 秒、プロンプト拡張オフです。承認済みの静止画がまだなく、場所・動作・カメラのすべてをテキストで決める必要があるときに使います。開始フレームがすでにある場合は、画像から始めるエンドポイントがそのフレームの被写体と縦横比を保ちます。

開始素材で Wan 2.5 のモードを選ぶ

映像と音声を一度に生成

クリップは音声が入った状態で返ります。環境音、効果音、声が映像と同時に生成されるため、「Audio: gulls, a splash, her breath」のような音の一文を書く価値があります。手元の録音に動きと口の形を合わせたい場合は、audio_url に WAV または MP3（3〜30 秒、15 MB まで）を渡します。クリップより長い音声は末尾が切られ、短い場合は残りの部分が無音になります。

5 つの比率、3 つの解像度、2 つの長さ

aspect_ratio は 16:9、9:16、1:1、4:3、3:4、resolution は 480p、720p、1080p を受け付けます。この 2 つは連動しており、480p では横長・縦長・正方形しか描画されないため、4:3 と 3:4 には 720p 以上が必要です。duration_seconds はちょうど 5 か 10 で、7 のような値は丸められずに拒否されます。解像度は秒単位の料金と処理時間も決めます。

除外指定と比較のための固定

negative_prompt は最大 500 文字で、字幕、ロゴ、余計な人物、繰り返し出てくる色などを入れる場所です。seed（0〜2147483647）は、一度に 1 つの項目だけを変えて比べるあいだ乱数源をそろえますが、同一のフレームを保証するものではありません。enable_prompt_expansion は既定でオフで、オンにすると短いブリーフが生成前により詳しい内容に書き直されます。

音声入りの縦型クリップ

aspect_ratio を 9:16 にして 5 秒のままにすれば、別の音声作業が要らないフィード用の下書きになります。公開例のレコード店のショットはさらに進めて、1080p・9:16 で 10 秒、レコードの箱から男性の顔へゆっくりティルトし、ネガティブプロンプト「text on screen, logos, extra people」で字幕や通行人が入らないようにしています。

見える動作に音が合っているかを確かめる

サックスの例は 1080p・16:9 で 10 秒を指定し、ホーンの音が運指と一致することを求めています。キー、水しぶき、ターンテーブルのノイズのように目に見えるものに音を結びつけると、雰囲気だけで判断するのではなく、再生時に具体的に確認できます。

自分のタイミングで話すセリフ

セリフを録音して audio_url に渡し、誰がどこで話しているかを書きます。動きと口の形がファイルのタイミングに従うので、確認は演技そのものに集中できます。特定の顔や製品が必要な場合、テキストだけでは実行ごとにその見た目を保てないため、画像から動画のエンドポイントで静止画から始めてください。

# 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-2.5/text-to-video",
  "input": {
    "aspect_ratio": "16:9",
    "duration_seconds": 5,
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "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 リファレンスを参照してください。