Skip to main content
POST
Wan 3.0 オールインワン動画生成
中国本土のユーザー向け: 中国本土のユーザーは https://toapis.cn を API エンドポイント(Base URL)としてご利用ください。本ドキュメント内の例では https://toapis.com を https://toapis.cn に置き換えてください。
Wan 3.0 の公開モデル名は wan3.0-video です。1つのモデルで以下の生成方式をサポートします:
  • テキストから動画生成
  • 最初フレームまたは最初/最後フレーム制御
  • 参照画像・参照動画・参照音声の組み合わせ生成
  • ファイルまたは公開 Web ページの参照
API は非同期タスクです。送信が成功するとタスク ID が返され、動画タスクステータスエンドポイントで進捗と結果を照会できます。
最初/最後フレームモードと参照素材モードは併用できません。リクエストに first_frame または last_frame が含まれる場合、参照画像・参照動画・参照音声・ファイル・Web リンクを同時に渡すことはできません。参照画像・参照動画・参照音声同士は組み合わせて使用できます。

認証

string
必須
Bearer Token 認証を使用します:

リクエストパラメータ

string
デフォルト:"wan3.0-video"
必須
モデル名。wan3.0-video 固定です。
string
動画の内容、被写体の動作、カメラワーク、音声の説明。prompt とメディア素材の少なくとも一方を指定する必要があります。マルチモーダル参照を使用する場合、配列の順序に合わせてプロンプトに「画像1」「動画1」「音声1」と記述できます。
integer
デフォルト:"5"
出力時間。2 〜 30 秒をサポートします。-1 を指定するとスマート時間モードになり、モデルがプロンプトと素材に応じて出力の長さを自動決定します。
string
デフォルト:"adaptive"
出力アスペクト比。以下をサポートします:
  • adaptive:参照素材に応じて自動調整
  • 16:9
  • 9:16
  • 1:1
  • 4:3
  • 3:4
互換フィールド aspect_ratio も使用できます。両方を同時に渡す必要はありません。
string
デフォルト:"1080p"
出力解像度。480p、720p、1080p をサポートします。
boolean
デフォルト:true
音声を生成するかどうか。デフォルトで有効です。
boolean
デフォルト:false
ウォーターマークを追加するかどうか。デフォルトで無効です。
integer
オプションの乱数シード。同じパラメータとシードで類似した結果を再現しやすくなります。
object[]
最初/最後フレーム制御の配列。各項目には以下が含まれます:
  • url:公開アクセス可能な画像 URL
  • role:first_frame または last_frame
最初フレームと最後フレームはそれぞれ最大1つまで指定できます。last_frame を使用する場合は first_frame も必ず指定してください。
string[]
参照画像 URL の配列。最大 10 枚。image_with_roles の最初/最後フレームと併用できません。
object[]
参照動画の配列。最大 5 本、合計 15 秒以内。各項目は以下の構造を使用します:
object[]
参照音声の配列。最大 5 本、合計 15 秒以内。各項目には以下が含まれます:
  • url:公開アクセス可能な音声 URL
  • role:reference_audio 固定
object
ファイルまたは Web ページの参照は metadata.media で渡します。
ローカルの画像や動画は、事前にアップロードして公開 URL を取得してください。生成リクエストにローカルファイルパスや base64 データを直接渡さないでください。

素材の組み合わせルール

以下のエラーが返された場合:
最初/最後フレームを削除して参照素材を残すか、すべての参照素材を削除して最初/最後フレームのみを残してください。

リクエスト例

テキストから動画

最初/最後フレームから動画生成

参照動画から動画生成

このリクエストでは first_frame や last_frame を同時に渡さないでください。

画像・動画・音声の組み合わせ参照

ファイル参照

レスポンス

string
動画タスク ID。タスクステータスの照会に使用します。
string
オブジェクトタイプ。通常は generation.task です。
string
このリクエストで使用されたモデル名。
string
タスクステータス:queued、in_progress、completed、または failed。
integer
タスクの進捗。0 〜 100 の範囲。
integer
タスク作成タイムスタンプ。