動画を作成
プラットフォームの共通フィールドで Wan 3.0 のテキスト・画像・マルチモーダル参照動画を作成します。
プラットフォーム形式はトップレベルの共通パラメーターと metadata を使用します。ネイティブの input/parameters をそのまま渡さないでください。作成は非同期で行われ、送信後に結果を照会します。
/v1/videos認証
bearerAuth プラットフォーム API Key を使用：Authorization: Bearer your-api-key。
指定位置: header
リクエストボディ
application/json
TypeScript 型定義
TypeScript で request body 型を使用します。
プロンプトまたは空でない metadata.media を指定します。JSON を使用し、multipart/input_reference/image/images は使用しません。
レスポンスボディ
application/json
application/json
application/json
パラメーターと優先順位
| 設定 | 指定方法と優先順位 |
|---|---|
| プロンプトと素材 | prompt または空でない metadata.media が必要です。画像にトップレベルの image/images/input_reference は使用しません |
| 解像度 | 空でない size → 空でない metadata.resolution → 空でない metadata.size → 1080P。ピクセル寸法ではなく段階を指定します |
| 時間 | 明示した duration → 空でない seconds → metadata.duration → 5。duration は整数、seconds は整数字符列です |
| シード | 明示したトップレベルの seed は metadata.seed より優先されます。0 も有効です |
| その他の設定 | 比率、音声、書き換え、透かしは metadata に指定します。明示した false は保持されます |
各設定の指定方法は一つを推奨します。解像度と seconds の空白文字列は未指定扱いです。素材があれば prompt は省略できます。無効な上位パラメーターはエラーになり、下位値にはフォールバックしません。
シナリオと素材
リクエスト例はテキスト、開始フレーム、開始・最終フレーム、混合参照、ファイル、ウェブページ、編集、延長の八種類です。素材を使う場合は、例の URL をアクセス可能な独自の URL に置き換えてください。
開始・最終フレームに参照素材は併用できず、最終フレームには開始フレームが必要です。ファイルとウェブページはどちらか一方を選び、プロンプト書き換えを有効にします。形式、数量、寸法、時間は素材と組み合わせのルールを参照してください。プラットフォーム形式にも同じルールが適用されます。
作成結果と互換パス
作成時は video オブジェクトが返ります。id を保存し、プラットフォーム照会 APIで結果を取得します。互換フィールド task_id は id と同じです。queued は受付済みであり、生成完了ではありません。
POST /v1/video/generations と POST /v1/videos/generations も同じパラメーター・応答構造で利用できます。新規連携には本ページの POST /v1/videos を使用してください。
よくあるエラー
HTTP 400 では、返されたエラーに従って型、解像度、素材の組み合わせ、metadata のフィールド名を確認します。エラーは code/message/data または入れ子の error オブジェクトで返る場合があります。