はじめに
Wan 3.0 Prime テキストから動画 は、書いたプロンプトだけから音声付きの 2〜30 秒のクリップを生成します。フィールドは Wan 3.0 テキストから動画と完全に同じで、prompt が必須、duration_seconds、resolution(480p・720p・1080p、既定は 720p)、aspect_ratio(既定は 16:9)、generate_audio、enable_prompt_expansion、seed は任意です。そのため、既存の Wan 3.0 のリクエストはモデル名を変えるだけでそのまま使えます。Alibaba は Prime を、同じ能力を持つ Wan 3.0 の高速版と位置づけています。
開始素材に応じてモードを選ぶ
| 開始素材 | モード |
|---|---|
| 書いたブリーフから、場面、行動、カメラ、必要に応じて音を組み立てます。 | Wan 3.0 Prime テキストから動画 |
| 承認済みの開始画像が被写体と構図を決め、指示文がその後の動きを導きます。 | Wan 3.0 Prime 画像から動画 |
| 別々の参照素材に、人物、場所、動き、音の役割を明確に割り当てられます。 | Wan 3.0 Prime 参照から動画 |
主な機能とハイライト
そのまま差し替えられるリクエストで、より速く
スキーマ、既定値、列挙値がすべて同じなので、Wan 3.0 と Prime のあいだでジョブを移すのは 1 語の変更で済みます。締め切りのある仕事はこちらに送り、ターンアラウンドより秒単価を重視するジョブは Wan 3.0 に残してください。両方のモデルでシードを固定すれば、2 つのファイルを直接比べられます。
連続性を確かめられる長いテイク
灯台のサンプルは 720p・音声付きで 10 秒です。回転する光が数秒ごとに 2 人を照らし、通り過ぎるたびに闇に戻します。サウンドトラックには霧笛と海。周期的な被写体は、長いクリップが途切れずに続いているか、それとも気づかないうちにリセットしているかを見極める、正直なテストになります。
逆光、薄い布、風
屋上のサンプルは 720p で 5 秒です。ゴールデンアワーの地中海の屋上の縁で、女性の背後に薄いリネンのシャツが持ち上がり、ゆっくり回り込むカメラ、暖かい逆光とレンズのにじみ、潮風とカモメの声。逆光の薄い布と揺れる髪は難しい被写体なので、自分のレンダリングでも念入りに確認する価値があります。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | カットそのものです。被写体、動作 1 つ、カメラの動き 1 つ、そのあとに光と音。 1 文字以上 |
aspect_ratio | いいえ | 16:9、9:16、1:1、4:3、3:4、adaptive から選びます。adaptive はモデルに選ばせる指定です。 |
enable_thinking | いいえ | 生成の前に、指示と参照素材をモデルにじっくり読み込ませます。長いドキュメントや Web ページ、複雑な参照画像に向いていますが、処理は遅くなります。 デフォルト値: |
resolution | いいえ | 480p、720p、1080p。既定は 720p。 |
duration_seconds | いいえ | 2〜30 の任意の整数秒、または -1 でスマート尺です。スマート尺ではモデルが長さを決め、上限の 30 秒分を先に確保して、実際に出力された長さで精算します。 |
generate_audio | いいえ | 既定でオン。映像に固定された音付きでクリップが返ります。 デフォルト値: |
enable_prompt_expansion | いいえ | 既定でオフ。オンにすると生成前にプロンプトが書き直され、薄いブリーフには効き、詳細なブリーフとは喧嘩します。 デフォルト値: |
seed | いいえ | 0〜2147483647。1 フィールドずつ比べるときは固定し、幅が欲しいときは外してください。 |
料金
| 仕様 | 料金 |
|---|---|
| $0.0612 / 秒 |
| $0.126 / 秒 |
| $0.252 / 秒 |
ユースケース
一貫性が求められる幻想的な場面
塩湖のサンプルは、空と地面の境目が見えない鏡のような水面、カメラに向かって歩く女性と、その下を逆さまに歩く映り込み、そして彼女が回ったときに水面に広がる波紋を求めています。フレームは最初固定で、あとからゆっくりプッシュインするだけなので、確認すべき対象として映り込みだけが浮かび上がります。
声まで同じ工程で生成するパフォーマンス
レコーディングブースのサンプルでは、リボンマイクの前で歌手が長く低い音を伸ばし、片方のイヤーカップを外してコントロールルームのガラス越しに微笑みます。マイクのメッシュから彼女の顔へのラックフォーカスもプロンプトに書かれています。声は映像と同じ工程で生成されるので、両方が 1 つのファイルで返ってきます。
プロンプトガイドと実践のヒント
カメラの変化は出来事として書く
ショットの途中でカメラが何かをするときは、順番のある出来事として書きます。ブースのプロンプトは「rack focus from the microphone mesh to her face」、塩湖のプロンプトは「wide static frame that then pushes slowly in」と書いています。1 つのビートに 1 つのカメラ指示にしておけば、結果を確認しやすくなります。
長いクリップにはリズムを与える
5 秒より長いクリップでは、繰り返すもの、進んでいくもの(数秒ごとの光、潮の満ち引き、人で埋まっていく部屋など)を与えて、連続性を判断できるようにします。尺は 2〜30 の任意の整数秒、または -1 でモデルに任せられます。まず 5 秒で見た目を固めてください。
シードを固定して Prime と Wan 3.0 を比べる
同じ seed で 1 つのボディを両方のモデルに送り、そのあと 1 回に 1 つのフィールドだけを変えます。シードを固定すれば比較は公平になりますが、同じフレームになる保証はありません。細かいプロンプトでは enable_prompt_expansion を既定の false のままにし、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-3.0-prime/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"aspect_ratio": "16:9",
"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 リファレンスを参照してください。



























