はじめに
Wan 3.0 Pro Prime テキストから動画 は、プロンプトから 2〜30 秒のショットを生成し、音声を同じファイルに収めて 1080p・2K・4K で納品します。フィールド一覧は Wan 3.0 Pro テキストから動画と完全に同じですが、ベースのレンダリングは Wan 3.0 Prime です。Alibaba は Prime を、同じ能力を持つ高速版と位置づけています。Prime のネイティブレンダリングは 1080p が上限なので、2k と 4k の段階はそこから拡大したもので、ネイティブにレンダリングしたものではありません。
開始素材に応じてモードを選ぶ
| 開始素材 | モード |
|---|---|
| 書いたブリーフから、場面、行動、カメラ、必要に応じて音を組み立てます。 | Wan 3.0 Pro Prime テキストから動画 |
| 承認済みの開始画像が被写体と構図を決め、指示文がその後の動きを導きます。 | Wan 3.0 Pro Prime 画像から動画 |
| 別々の参照素材に、人物、場所、動き、音の役割を明確に割り当てられます。 | Wan 3.0 Pro Prime 参照から動画 |
主な機能とハイライト
Wan 3.0 Pro と同じボディ
必須フィールドは prompt(最大 20,000 文字)だけで、resolution の既定は 1080p、aspect_ratio は adaptive、enable_prompt_expansion は true です。契約が同一なので、1 つの JSON ボディがモデル名を変えるだけで Pro と Pro Prime の両方で動きます。プロジェクトをどちらかに決める前に、同じシードでテストショットを両方に送ってみてください。
ブリーフにフレーミングを書き込む
地下聖堂のサンプルは、プロンプトの 3 分の 1 をフレーミングだけに使っています。頭全体を画面に入れ、髪の上に余白を取り、腰でフレームを切り、顔は常に見えていること。クローズアップでよくある失敗は、モデルが自分のフレームから顔を切り落としてしまうことで、フレーミングを名指しするのがその対策です。キーライトはろうそくの光だけで、音声(揺らぐ炎、遠くの鉄の扉)も同じ工程で届きます。
落ち着く場所のない動き
水中のサンプルには基準になる地面がありません。沈んでいく被写体のまわりで深紅のシルクのガウンが花のように広がり、髪が扇状に広がり、指先から泡が尾を引き、カメラは弧を描きながら同時にティルトします。解像度を指定していないので、既定の 1080p で実行されます。何も静止しないショットこそ、大きい納品段階の恩恵をいちばん受けます。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 被写体、動作 1 つ、カメラの動き 1 つ、そのあとに光と音。4K では曖昧なブリーフが実費になるので、雰囲気ではなくカットを書いてください。 1 文字以上 · 20000 文字以内 |
resolution | いいえ | 1080p、2k、4k、既定は 1080p です。Wan 3.0 Prime のネイティブ出力は最大 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.234 / 秒 |
| $0.252 / 秒 |
| $0.279 / 秒 |
ユースケース
縦長フレームで動く色の光
オーロラのサンプルは、凍った湖で 1 枚の毛布を分け合う 2 人の肌と髪の上を緑の光が流れていく様子を、9:16 のフレームで求めています。肌の上を動く色の光は、バンディングや色ノイズが最初に現れる場所です。こうした被写体で 2K や 4K を使うのは、場面が本当にそれを必要とするときだけにしてください。静止した被写体を 4K にしても、ファイルが大きくなるだけです。
手持ち・自然光の場面
夜のフェリーのサンプルは意図的に素朴です。手持ちのドキュメンタリー風フレーミング、デッキの投光器と遠くの港の明かり、船尾の手すりで額を寄せ合い、航跡が白く渦巻く下でキスをする成人男性 2 人。どのシーンもほかのプロンプトと同じように送れるので、設定すべきコンテンツフラグはありません。同意、権利、年齢、現地の法律については利用者が責任を負います。
プロンプトガイドと実践のヒント
小さく探して、大きく納品する
seed を固定し、1080p・5 秒でプロンプトを調整します。テイクが決まったら、まったく同じボディを resolution を 4k にして送り直してください。解像度とシードを同時に変えると 2 つのことを一度に変えることになり、どちらが結果を動かしたのか分からなくなります。
拡大したファイルでは硬い光を最初に確認する
夜の単一の硬い光源(吊り下げ電球 1 つ、デッキライト 1 つ)は、拡大した映像の限界が最初に現れるところです。減衰部のバンディング、ろう人形のような肌、灰色のにじみになる濡れた布。グレーディングやシーケンスの編集に入る前に、納品された 2K や 4K のファイルでその部分を確認してください。
最終レンダリングの前に文言を固める
このファミリーではプロンプト拡張が既定でオンで、細かいブリーフを書き換えます。プロンプトが正確なショットの記述になったら enable_prompt_expansion をオフにし、調整した版がそのまま実行されるようにします。被写体、動作を 1 つ、カメラの動きを 1 つ、そのあとに光と音を書いてください。
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-prime/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 リファレンスを参照してください。



























