はじめに
Wan 3.0 Pro テキストから動画 は、プロンプトからショットを書き起こし、1080p・2K・4K で 2〜30 秒のクリップとして納品します。生成音声も同じファイルに入ります。必須フィールドは prompt だけで、最大 20,000 文字まで書けます。Wan 3.0 のネイティブレンダリングは 1080p が上限なので、2k と 4k の段階はそのレンダリングを拡大したもので、そのサイズで描き直したものではありません。このエンドポイントには 480p と 720p の段階はなく、そのサイズは Wan 3.0 が担います。
開始素材に応じてモードを選ぶ
| 開始素材 | モード |
|---|---|
| 書いたブリーフから、場面、行動、カメラ、必要に応じて音を組み立てます。 | Wan 3.0 Pro テキストから動画 |
| 承認済みの開始画像が被写体と構図を決め、指示文がその後の動きを導きます。 | Wan 3.0 Pro 画像から動画 |
| 別々の参照素材に、人物、場所、動き、音の役割を明確に割り当てられます。 | Wan 3.0 Pro 参照から動画 |
主な機能とハイライト
1 回のネイティブレンダリングから 3 つの納品サイズ
resolution は 1080p(既定)、2k、4k から選びます。大きい 2 つの段階は、モデルが描いたものを引き伸ばすだけで新たに描き足すわけではないので、トリミング、トラッキング、投影を前提とした素材に向いています。そして品質は元のレンダリング以上にはなりません。まず 1080p でショットを決め、4K は納品の工程として扱ってください。
プロンプト拡張は最初からオン
このファミリーでは enable_prompt_expansion の既定値が true です。薄いブリーフを補ってくれるので下書き段階では便利ですが、細かいブリーフは書き換えてしまいます。プロンプトが正確なショットの記述になったら false にして、調整した文言がそのまま実行されるようにしてください。
指定しなければフレームはアダプティブ
aspect_ratio の既定値は adaptive で、フレームをモデルが選びます。納品フォーマットが決まっているなら 16:9、4:3、1:1、3:4、9:16 を指定します。フェンスのサンプルは縦長の 9:16 を指定し、香水、モノクロ、タトゥーのサンプルはいずれも 16:9 を指定しています。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 被写体、動作 1 つ、カメラの動き 1 つ、そのあとに光と音。4K では曖昧なブリーフが実費になるので、雰囲気ではなくカットを書いてください。 1 文字以上 · 20000 文字以内 |
resolution | いいえ | 1080p、2k、4k、既定は 1080p です。Wan 3.0 のネイティブ出力は最大 1080p なので、それより上の段である 2k と 4k は、その解像度でネイティブにレンダリングしたものではなく、レンダリングを拡大して納品されます。 |
aspect_ratio | いいえ | 16:9、4:3、1:1、3:4、9:16、または adaptive。既定は adaptive でモデルに選ばせます。 |
duration_seconds | いいえ | 2〜30 の任意の整数秒、既定 5。-1 はスマート尺で、モデルが長さを決め、上限の 30 秒分を先に確保して、実際に出力された長さで精算します。 |
generate_audio | いいえ | 既定でオン。音は映像と一緒に生成され、同じファイルに入って届きます。 デフォルト値: |
enable_prompt_expansion | いいえ | この家族では既定でオン。薄いブリーフを埋め、詳細なブリーフは書き直します。 デフォルト値: |
seed | いいえ | 0〜2147483647。解像度や尺を詰めるあいだは固定してください。 |
料金
| 仕様 | 料金 |
|---|---|
| $0.144 / 秒 |
| $0.16 / 秒 |
| $0.184 / 秒 |
ユースケース
硬い光の香水・ビューティー広告
香水のサンプルは 5 秒のスローモーション広告です。背中の開いた黒いガウンの成人女性が雨の打ちつける窓から振り向き、硬いキーライト 1 灯が背筋をなぞり、髪から水滴が跳ね、サウンドトラックには低いチェロの音と雨。光沢のある生地、硬い単一光源、小さく速い粒子は、映像を拡大したときに最初に破綻する要素なので、2K や 4K の納品ではまさにそこを確認してください。
1 つの外力で動く布
2 つのサンプルは、服がどう収まっているかを書く代わりに、1 つの力で服を動かしています。モノクロのファッションフィルムでは、工業用の送風機の前で 3 メートルのシルクシフォンが体に巻き付き、黒い背景の前の硬いキーライトの中で片方の肩にまとわりついていきます。フェンスのサンプルでは、着陸する飛行機のジェット噴流が 2 人の服を体に押し付けます。力を名指しすると、布が従うべき原因が生まれます。
プロンプトガイドと実践のヒント
1080p で探し、選んだシードで再レンダリングする
seed を固定して 5 秒・1080p でショットを探し、再実行ごとに 1 つのフィールドだけを変えます。決まったら、同じプロンプトとシードのまま resolution を 4k にして送り直してください。解像度と文言を同じ再実行で変えると、どちらが結果を動かしたのか分からなくなります。
ムードではなくショットを書く
被写体、動作を 1 つ、カメラの動きを 1 つ、そのあとに光と音。タトゥースタジオのプロンプトがよい手本です。光源はろうそくとデスクランプ 1 つだけ、手袋の手が肋骨の上の図柄に陰影を入れ、顔をしかめ、ゆっくり息を吐き、肩越しにニヤリと笑う。マシンのうなる音、ごくゆっくりしたプッシュイン。4K であいまいなブリーフを送るのは、自分の意図を確かめる方法としては高くつきます。
聞きたい音を名指しする
音は映像と一緒に生成されるので、その音源を並べて書きます。香水の広告は「low cello note and rain」、送風機のフィルムは「the roar of the fan and snapping cloth」を求めています。作曲家が音楽を付ける場合は generate_audio を false にしてください。このファミリーはリクエストごとの申告なしで無検閲のプロンプトを受け付けますが、映っている全員の同意、権利、年齢、現地の法律については利用者が責任を負います。
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-pro/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "1080p",
"aspect_ratio": "adaptive",
"duration_seconds": 5
}
}'
# 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 リファレンスを参照してください。



























