Skip to main content
POST

認証

string
必須
すべてのエンドポイントで Bearer Token 認証が必要ですAPI キー管理ページ から API キーを取得してください:

生成モード

モデル名は wan3.0-video で固定。リクエストフィールドによってモードが決まります:

リクエストパラメータ

基本

string
必須
固定値:wan3.0-video
string
テキスト説明。メディアフィールドと少なくともどちらか一方が必須
  • 最大 20,000 文字。超過分はエラーなく自動切り捨て
  • 参照モードでは「图N / 视频N / 音频N」で素材を指定。番号は各メディア種別内の順序に従う
string
デフォルト:"1080P"
出力解像度(大文字小文字を区別しない)
  • 480P
  • 720P
  • 1080Pデフォルト、最上位価格)
resolution を省略すると 1080P で課金されます。コストを抑えたい場合は 480P または 720P を明示してください。
string
デフォルト:"adaptive"
アスペクト比。aspect_ratio も受け付けます。
  • adaptive(デフォルト)
  • 16:9 / 4:3 / 1:1 / 3:4 / 9:16
integer
デフォルト:"5"
生成秒数、2–30、デフォルト 5
duration: -1(スマート尺)は非対応です。 2–30 の整数を指定してください。
参照動画入力がある場合、入力動画の合計尺 + 出力 duration は 30 秒以下である必要があります。
boolean
デフォルト:"true"
出力に音声トラックを含めるか。デフォルト true音声の有無で価格は変わりません。
integer
乱数シード、範囲 [0, 2147483647]
boolean
デフォルト:"false"
透かしを付けるか。デフォルト false
string
素の image_urls の帰属先:
  • frame — 先頭・最終フレーム族
  • reference — 参照族
省略時は自動判定(相互排他ルールを参照)。

メディア入力

string[]
画像 URL 配列。ロール割当は相互排他ルールに従います。公開 URL または Base64(data:image/png;base64,...)。
object[]
ロール付き画像配列。各項目:
  • url:画像アドレス
  • rolefirst_frame / last_frame / reference_image(一般的な別名も可)
string[]
参照動画、最大 5 本。各 1–15 秒、合計 ≤ 15 秒
string[]
参照音声、最大 5 本。各 1–15 秒、合計 ≤ 15 秒
string
単一の参照音声(audio_urls の単値形式)
string
参照ドキュメント URL、最大 1 個。link_url と同時指定不可。対応形式:docx / doc / xlsx / xls / pptx / ppt / pdf / txt / key / pages / numbers / md など、≤100MB、≤50 ページ。
公開 Web ページ URL、最大 1 個。ログイン不要のページのみ。file_url と同時指定不可。

メディア族の相互排他

メディアは 2 族のいずれかで、混在不可(送信前に検証 → 400、タスク未作成・課金なし):

素の image_urls の割当

  1. generation_type が指定されている → それに従う(frame / reference
  2. 未指定だが、リクエストに参照族入力がある(video_urls / audio_urls / audio_url / file_url / link_url)→ reference_image として扱う
  3. どちらでもない → フレーム族:1 枚目 first_frame、2 枚目 last_framewan2.7 と同じ)
精密に制御する場合は image_with_roles を使用してください。

メディア上限と形式

リクエスト例

テキストから動画

先頭フレームから動画

先頭・最終フレーム

または image_with_roles を使用:

マルチモーダル参照

video_urls がある場合、素の image_urls は参照画像に自動分類されます。generation_type: "reference" を明示するとより明確です。

ファイル参照から動画

prompt は省略可。ドキュメント内容で生成が駆動されます:

Web ページ参照から動画

課金

秒数 × 解像度(公式リスト価格に準拠)。音声のオン/オフは価格に影響しません:
  • デフォルトは 1080P(最上位価格)。コスト重視なら 480P / 720P を指定
  • 課金秒数 = リクエストの duration
  • audio: true/false価格に影響しません

制限と注意

よくあるエラー

いずれも同期 400(タスク未作成・課金なし):

Response

integer
ステータスコード。成功時は 200
array
レスポンスデータ配列
結果の照会動画生成は非同期です。タスク状態の取得 または GET /v1/videos/generations/{task_id} でポーリングしてください。推奨間隔は 5–10 秒。生成には通常 1–5 分かかります。成功後は result.videos 内の URL を使用します。