はじめに
Wan 2.6 Spicy 画像から動画 は、モデルシリーズ Wan 2.6 Spicy の唯一のエンドポイントです。使用を許可された開始画像が、ちょうど 5 秒、10 秒、15 秒のいずれかの、720p または 1080p の音声付きクリップになります。衣装、体、セット、光、画面の形は画像が担い、動きはプロンプトが担います。リクエストにはクリップを区別する項目がなく、リクエストごとの申告も必要ありません。
必須なのは image_url だけです。プロンプト、ネガティブプロンプト、音声トラック、ショットタイプ、プロンプト拡張、シードはすべて任意です。
主な機能とハイライト
3 つの固定の長さ
duration_seconds は 5、10、15 から選ぶ列挙値で、範囲ではありません。7 を送ると丸められたクリップではなく検証エラーが返るので、何秒分を支払うのかが常にわかり、編集も 3 つの長さを前提に組めます。水、髪、手は 5 秒ではよく保たれ、15 秒ではずれやすくなるので、いちばん長い尺を選ぶ前に考慮してください。
audio_url で自分のトラックを使う
クリップは常に音声付きで返り、音を切るスイッチはありません。セリフや音楽のキューを特定のフレームに合わせたいときは audio_url で送ると、クリップはリップシンクとテンポをそれに合わせます。ファイルは WAV または MP3、長さ 3〜30 秒、15 MB 以下にしてください。
除外専用のフィールド
negative_prompt は、2 人目の人物、小道具、画面上の文字、画像が繰り返し再現してしまう透かしなどを、最大 500 文字で締め出す場所です。最大 1,500 文字のプロンプトは動きのために空けておけます。衣装やセットをプロンプトで改めて説明すると、画像がすでに決めているものをモデルが描き直すきっかけになります。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
image_url | はい | 開始フレームです。衣装、身体、セット、光の向き、クリップのアスペクト比まですべてここから来るので、先に納品する形へ切っておいてください。 |
prompt | いいえ | 任意です。フレームのあとに何が起きるかを書きます。 1500 文字以内 |
negative_prompt | いいえ | 現れてはいけないものを書きます。2 人目、小道具、画面上の文字、プレートが繰り返し再現してしまう透かしなどです。 500 文字以内 |
duration_seconds | いいえ | 指定できるのはちょうど 5、10、15 です。それ以外は丸められずに拒否されるので、支払う長さが想定外になることはありません。 |
resolution | いいえ | 720p か 1080p で、既定は 720p です。料金と、タスクが返るまでの時間の両方が動きます。 |
audio_url | いいえ | クリップが追従する音声トラックで、口の動きとテンポを導きます。台詞や音楽のキューを特定のフレームに乗せたいときに使ってください。 |
seed | いいえ | 0〜2147483647 の整数です。同じプレートで解像度や長さを比べるあいだは固定してください。 |
shot_type | いいえ | シングルは全編ワンカットです。マルチはモデルがカットを割ります。 |
enable_prompt_expansion | いいえ | 既定はオフで、プロンプトは書いたとおりに送られます。薄いブリーフを補いたいときにオンにしてください。 デフォルト値: |
料金
| 仕様 | 料金 |
|---|---|
| $0.095 / 秒 |
| $0.1425 / 秒 |
ユースケース
水と光
公開しているプールの例は、ブルーアワーに屋上のプールから上がってくる泳ぎ手の静止画から始まります。フレームに衣装、水、背後の街が写っているため、プロンプトは彼女がさらに立ち上がり、髪を後ろになでつけ、カメラに向けて目を開く、と書くだけです。720p で 5 秒です。
2 人のシーン
二人が写るフレームも、ほかの続きと同じように扱われます。クリップは開始フレームに写っているものをそのまま続け、その後に審査は一切行われません。グリーンルームの例では、一人がもう一人の後ろで動く間、クリップ全体で同じ構図を保ち、1080p で 5 秒描画しています。
自分の声のトラックで話すコンパニオンキャラクター
キャラクターの画像を開始画像として使い回し、録音したセリフを audio_url でアップロードします。唇の動きとテンポがあなたのテイクに合わせて進むので、同じ顔が汎用的な口の動きではなく台本どおりに話せます。
1 回の呼び出しで作る 15 秒スポット
15 秒あれば、プレロール 1 本やストーリーカード 1 枚を編集なしでまかなえます。開始画像 1 枚、動作の 1 行、リクエスト 1 回です。長さは 3 つの固定値のいずれかなので、送信前に確定しています。
プロンプトガイドと実践のヒント
画像を納品形式に切り抜く
人物、衣装、場所、光、クリップの縦横比は静止画が決めます。アスペクト比のフィールドはないので、送る前に 16:9、9:16、正方形のいずれかに切り抜いてください。あとから構図を直すと再レンダリングが必要になります。JPEG、透過なしの PNG、BMP、WEBP のいずれかで、各辺 240〜8,000 ピクセル、20 MB 以下の画像を送ってください。
小さな動きでクリップを組み立てる
すだれ状の光の例は、足が曲がり膝が伸びるという二つの小さな動きから成ります。その下でシルクが揺れます。残りは光が担い、ブラインドが揺れるとすだれ状の光が這うように移動します。カメラは移動ではなく、手持ちの一人称視点の揺れです。こうした小さくて具体的な動きは、フレームに変化を求めずに、やるべきことを与えます。
カメラを固定するなら、境界をプロンプトに書く
10 秒のグリーンルームの例では、注目すべきものはすべて一本の水平線上にあり、プロンプトにはフレームの外に出してはいけないものを明示しています。カメラが動かないとき、制約はフレームで避けようとするよりも、プロンプトに書いたほうが確実に保たれます。クリップ全体で保つ必要があるからです。
同梱の例を応用する
公開済みの例、duration_seconds: 5、image_url: a publicly accessible URL、resolution: 720p から始めてください。このモードの入力の約束事は保ったまま、被写体と動きを入れ替えます。
She rises further out of the water, sheets of it running off her shoulders and swimsuit, slicks her wet hair straight back with both hands and opens her eyes toward camera, droplets scattering. Blue-hour city towers glow behind, slow-motion water detail, ambient pool lap and distant traffic.
このエンドポイントのクリップを生成した実際のリクエストで、横に表示している開始画像から生成しています。
720p で詰めてから、採用版を 1080p で書き出す
解像度によって料金もタスクの所要時間も変わります。動きは 720p で詰め、選んだバージョンを同じ画像と同じ seed（0〜2147483647）で 1080p として再レンダリングしてください。5 秒と 15 秒を比べるときも両方を固定します。そうしないと、2 つの設定ではなく 2 本の別のクリップを比べることになります。シードは結果を安定させますが、まったく同じクリップになる保証はありません。
API クイックスタート
# 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.6-spicy/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"resolution": "720p",
"shot_type": "single"
}
}'
# 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 リファレンスを参照してください。
