はじめに
Wan 2.6 テキストから動画 は、書いたショット、または番号付きのショットリストを、ちょうど 5 秒、10 秒、15 秒のいずれかの長さで、720p または 1080p のクリップにします。必須なのは prompt だけです。そのほかはすべて既定値があり、16:9、720p、5 秒、1 カットの連続撮り、プロンプト拡張オフになっています。クリップは映像と同時に生成された音声付きで返り、audio_url を使えば、録音したセリフや音楽のキューに合わせて動かすこともできます。
開始素材に応じてモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 書いたシーンや台本 | Wan 2.6 テキストから動画 |
| 承認済みの開始画像 | Wan 2.6 画像から動画 |
| 見た目、動き、音それぞれの参照素材 | Wan 2.6 参照から動画 |
主な機能とハイライト
5 種類の画面比を両方の解像度で
aspect_ratio は 16:9、9:16、1:1、4:3、3:4 を受け付け、どの比率も 720p と 1080p の両方で使えます。入力画像から何も引き継がないため、フィールドを 1 つ変えるだけで、同じブリーフを横長のマスターと縦型の短尺版の両方に書き出せます。解像度は秒単価とタスクの所要時間を決めるので、プロンプトを詰める段階では既定の 720p が向いています。
1 カットか、計画されたシーケンスか
shot_type は、1 カットの連続撮りである single と、同じクリップの中で複数のショットにカットを割れる multi を切り替えます。multi のリクエストは、enable_prompt_expansion の値にかかわらず必ずプロンプト拡張をオンにして実行されます。カット割りはブリーフを拡張する過程で計画されるためです。オチのある短い物語には multi、カバレッジよりも連続性が大事なときは single を選びます。
音も同じ生成で
音声は映像と一緒に生成されるため、プロンプトの最後に音について 1 文書くと、聞こえる音が変わります。音がすでにある場合は、audio_url に 3〜30 秒、15 MB までの WAV または MP3 を渡すと、口の動きや動作のテンポがそのファイルに合わせて進みます。長いトラックはクリップの長さで切られ、短いトラックの場合は残りの部分が無音になります。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | ショットそのものです。誰が、動作を 1 つ、カメラの動きを 1 つ、そして光と音を書きます。 1 文字以上 · 1500 文字以内 |
negative_prompt | いいえ | 入れてはいけないものです。字幕、ロゴ、余計な人物、何度も出てしまう色などを書きます。 500 文字以内 |
aspect_ratio | いいえ | 16:9、9:16、1:1、4:3、3:4 から選び、既定は 16:9 です。5 種類ともどちらの解像度でも使えます。 |
resolution | いいえ | 720p または 1080p で、既定は 720p です。秒単価と処理時間が変わります。 |
duration_seconds | いいえ | 5・10・15 のいずれかちょうどです。それ以外は丸めずに拒否されます。 |
audio_url | いいえ | クリップが追いかけるセリフや音楽のきっかけです。口の形と動きのテンポがこのファイルに合わせて進みます。 |
shot_type | いいえ | single はワンカットを保ち、multi ではモデルが複数ショットに切り分けます。カット割りはプロンプトを広げる段階で組まれるため、multi のリクエストでは |
enable_prompt_expansion | いいえ | 既定はオフです。オンにすると短い説明が生成前に詳しく書き直されます。 デフォルト値: |
seed | いいえ | 0 から 2147483647 までです。変更を 1 つずつ比べるときは固定し、バリエーションがほしいときは省略します。 |
料金
| 仕様 | 料金 |
|---|---|
| $0.09 / 秒 |
| $0.135 / 秒 |
ユースケース
音まで書き込んだ雰囲気のある 1 カット
公開済みの港の例は、1 カット撮りの型を示しています。黄色い防水コートの漁師が濡れたロープを巻き取り、通り過ぎるフェリーを見上げて手を挙げます。カメラは積まれた木箱の後ろからのゆっくりしたドリー 1 本だけです。プロンプトの最後に音の指定があるため、降り続く雨、長いフェリーの汽笛、ロープのきしみが、別トラックなしで映像の下に入ります。設定は 16:9、5 秒、720p です。
SNS 向けの縦型ショートストーリー
パン屋の例は、9:16、10 秒、1080p のクリップに番号付きのショットを 3 つ求めています。夜明けに上がるシャッター、パン生地を成形する粉だらけの手、天板を入れるとオレンジ色に光るオーブンの扉です。shot_type が multi なので番号付きの各行がそれぞれ 1 カットになり、固定した seed によって、言い回しを調整するあいだも結果のぶれが抑えられます。
撮影前のルック開発
まだ存在しないシーンの舞台、光、テンポを試すなら、書いたブリーフだけで十分です。ただし、特定の顔や製品を実行ごとに同じに保つことはできません。人物やパッケージを見分けられる状態で残す必要が出てきたら、先に画像を作り、開始画像が見た目を決める画像から動画へ作業を移してください。
プロンプトガイドと実践のヒント
1 カットは 4 つの要素で書く
single では、被写体を示し、動作を 1 つ、カメラの動きを 1 つ指定してから、光と音についての 1 行を加えます。港のプロンプトはこの順序どおりに書かれているので、結果を判断しやすくなっています。ドリーが木箱の後ろにとどまったまま、ロープ、視線、挙げた手がすべて起きているかどうかを見ればよいからです。
Late evening on a rain-soaked harbour quay. A fisherman in a yellow oilskin coils a wet rope, looks up at a passing ferry and raises a hand. Slow dolly from behind a stack of crates, sodium lights reflecting in the puddles. Audio: steady rain, a long ferry horn, the rope creaking.
multi ではショットに番号を振る
multi では、各行を「Shot 1:」「Shot 2:」のように始め、行ごとに画角と被写体を決めます。1 行に出来事は 1 つです。1 行で 2 つの出来事を書いた時点で、カットの境目をこちらで決められなくなります。複数ショットの編集には長めの尺が必要なので、10 秒か 15 秒を選んでください。
除外したいものはメインのブリーフから外す
字幕、ロゴ、余計な人物、何度も出てくる色は、最大 500 文字の negative_prompt に書き、プロンプト本体は 1,500 文字未満に収めます。1 カットの場合、プロンプトがショットを正確に記述できているなら enable_prompt_expansion はオフのままにし、1 行のアイデアをふくらませたいときにオンにします。
変更は 1 度に 1 つだけ比べる
seed は 0〜2147483647 を受け付けます。カメラの動き、画面比、single と multi の違いなど、変えるものを 1 つに絞るあいだは固定し、バリエーションがほしいときは省略します。比較を安定させる道具であって、フレーム単位で同一の再生成を約束するものではありません。5 秒、10 秒、15 秒以外の長さは丸められず、エラーとして拒否されます。
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/text-to-video",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"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 リファレンスを参照してください。




























