はじめに
Wan 3.0 Spicy 画像から動画へ は Wan 3.0 Spicy ファミリーの画像から動画へのエンドポイントで、標準版が抑える表現を描画するよう調整されています。image_url の開始フレームと、任意の prompt から、480p・720p・1080p の 2〜30 秒の動画が生成音声つきで作られます。静止画が人物、衣装、セット、光を、プロンプトが動き、カメラ、音を担います。終わりの画を固定するには last_image_url を追加してください。
リクエストボディにコンテンツのフラグはなく、リクエストごとの申告もありません。2026-09-30 の 6 段階のコンテンツテストでは、全段階が指示どおりに出力されました。
主な機能とハイライト
6 段階をテストし、6 段階とも描画
私たちは標準の内容テストを 480p・5 秒で実施しました。6 つのプロンプトを強度レベル 5 段階(軽め〜最大)にまたがって使っています(テストに使ったプロンプトは公開していません)。拒否されたもの、隠されたもの、別人にすり替えられたものは一つもなく、どのプロンプトも和らげる必要はありませんでした。
プロンプト以上に、自分から先へ進む
ここは計画に織り込むべき部分です。例として撮影したショットでは、衣装はそのままと書いたプロンプトに対して開始フレームを六つ送りましたが、そのうち四つは衣装が変わって返ってきました。人物が二人以上写っているフレームはすべて含まれます。プロンプトは要望であって保証ではないと考え、クリップ全体を確認してください。
1 回のリクエストで最長 30 秒
duration_seconds は 2〜30 の任意の整数で、既定は 5 です。5 秒のリクエストで、30 フレーム/秒・約 5.04 秒の映像が返ります。resolution は 480p、720p(既定)、1080p で、尺と解像度はどちらも料金と所要時間に影響します。
形、音声、最終フレーム
aspect_ratio は 16:9、9:16、1:1、4:3、3:4 を取り、省略するとクリップは静止画の形に従います。generate_audio は既定でオンです。last_image_url は最終フレームを固定します。テストでは、クリップは渡した画像で終わりました(指定の比率にクロップされた形)。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | いいえ | 任意ですが、書く価値があります:動作を一つ、カメラの動きを一つ、音についての一文を一つ。このモデルでは、衣装を変えないよう頼んでも確実には変わりません。 1 文字以上 |
image_url | はい | 必須です。人物、衣装、部屋、光はすべてこの開始フレームから引き継がれます。 |
last_image_url | いいえ | 任意の最終フレームです。クリップはこの画像で終わり、指定のアスペクト比にクロップされます。 |
aspect_ratio | いいえ | 16:9・9:16・1:1・4:3・3:4。省略するとクリップは開始フレームの形に従い、異なる比率を指定するとフレームがクロップされます。 |
resolution | いいえ | 480p・720p・1080p で、既定は 720p です。解像度が高いほど 1 秒あたりの料金が上がり、時間もかかります。 |
duration_seconds | いいえ | 2〜30 の任意の整数で、既定は 5 です。指定した秒数で課金されます。 |
generate_audio | いいえ | 既定でオンで、追加料金はありません。映像に合った音声付きでクリップが返ります。 デフォルト値: |
enable_prompt_expansion | いいえ | 既定でオフで、追加料金はありません。オンにすると、短いプロンプトが生成前に長い文へ書き換えられます。 デフォルト値: |
seed | いいえ | 0〜2147483647。解像度や尺を比較するあいだ固定しておきます。 |
料金
| 仕様 | 料金 |
|---|---|
| $0.057 / 秒 |
| $0.114 / 秒 |
| $0.228 / 秒 |
ユースケース
他の API が断る場面
他の API が断ったり和らげたりする場面:静止画を送り、動きを書けば、クリップが手に入ります。使えるのは、同意した成人と、適切にライセンスされた素材だけです。写っている全員について、権利、年齢、現地の法律に従う責任はあなたにあります。
コンパニオン/ロールプレイのキャラクター
キャラクターの静止画を 1 枚決め、全クリップの開始フレームに使い回し、変えるのは動きだけにします。顔と衣装は静止画が持つので、クリップをまたいでも同じ人物のままです。
終わりを決めたロングテイク
最長 30 秒を指定し、last_image_url を加えると、次のショットが始まるポーズで長回しが終わります。
プロンプトガイドと実践のヒント
スタイリングはフレームに任せる
衣装、部屋、光は静止画に入れ、プロンプトは動くものだけにします。このページの窓辺の作例は duration_seconds が 5、resolution が 720p でした。
She turns from the rainy window toward the camera; the loose strap slides a little further down her shoulder and she lets it rest there, a slow half smile. Pink and cyan neon ripples over the wet glass and her collarbone. She stays in the velvet dress the whole time. Slow push-in. Rain on the glass, distant traffic hum.
このエンドポイントで、隣に示した開始フレームから生成したクリップの、実際のリクエストそのものです。
480p で下書きし、それから本番
5 秒の 480p クリップは実測で約 1 分半でした。そこでアイデアを固め、seed を固定してから、720p か 1080p で再レンダリングします。比較が意味を持つように、1 回の実行で変えるフィールドは 1 つだけにしてください。
衣装を着たままにしたいとき
どんな書き方のプロンプトでも、このモデルが被写体の衣装を変えるのを確実に止めることはできません。衣装を最後まで残す必要があるクリップには、標準の Wan 3.0 画像から動画へを使い、Spicy は、その傾向そのものが目的のシーンのために取っておいてください。
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-3.0-spicy/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"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 リファレンスを参照してください。



























