Skip to main content
Wan
Wanは単一のMixRoute動画エンドポイントを使用します。modelをルートに置き、プロバイダーのinputオブジェクトとparametersオブジェクトをmetadata内に配置してください。モデルのバージョンごとに入力プロトコルが異なるため、以下から正確なIDとスキーマを選択してください。 POST https://api.mixroute.ai/v1/video/generations

モデル

利用可能なモデルは、アカウントのモデルリストによって異なります。アカウントのリストに返されないベンダーモデルや日付付きスナップショットが利用可能であると想定しないでください。

リクエストの全体構造

Authorization: BearerとMixRouteキーで認証してください。Alibabaキー、ワークスペースID、リージョン別エンドポイント、X-DashScope-Asyncヘッダーは不要です。input/parametersをルートに置いたり、その内容を平坦化してmetadataに直接入れたりしないでください。
プロンプトにはmetadata.input.promptを使用してください。互換性のためのフォールバックはmetadata.prompt、次にトップレベルのpromptの順です。metadata.input.promptがある場合は、それが優先されます。プロンプトまたは有効なメディア入力を指定し、選択したモデル固有の必須入力ルールに従ってください。 ネイティブフィールドは名前を変更せずに転送されます。新しいプロバイダーフィールドは、本来のinput/parameters内の位置に指定できます。モデル固有の組み合わせは上流サービスが検証します。これは、すべてのモデルがそのフィールドに対応するという意味ではありません。

Wan 3.0

wan3.0-video-primeはwan3.0-videoと同じinput/parametersスキーマを使用し、より高速に生成します。このセクションのルールは両方に適用されます。

メディアの種類

  • フレームモード(first_frame/last_frame)は、reference_*、file、linkと併用できません。Wan 2.7 I2Vとは異なり、Wan 3.0のフレームモードには動作を駆動する音声を含めることができません。
  • 参照画像、動画、音声は組み合わせて使用できます。fileとlinkは相互排他ですが、どちらもreference_*メディアと併用できます。種類ごとのすべての上限と、メディア項目全体で20件という上限を守ってください。
  • メディアは、種類ごとの順序に従ってImage 1、Video 1、Audio 1、または图1、视频1、音频1として参照してください。
  • 編集と延長には、reference_videoとそれに対応するプロンプトが必要です。延長にはratio=adaptiveを使用してください。編集では、adaptiveとduration=-1を指定すると元のフレーミングが保持され、モデルが長さを決定します。いずれの場合も、入力動画の長さと出力の長さの合計は30秒以内に収める必要があります。
Wan 3.0は、size、negative_prompt、template、img_url、first_frame_url、last_frame_url、audio_urlを使用しません。ゲートウェイは従来のフィールドを削除し、audio_urlをreference_audio項目に変換できます。新しいリクエストではinput.mediaを直接使用してください。

Wan 2.7

入力モード

first_clipを使用するI2Vの継続生成では、durationは追加秒数だけではなく、元のクリップを含む最終的な合計の長さを指定します。R2VではImage 1 / Video 1形式の参照を使用し、画像と動画を別々に数えます。Wan 2.7では、Wan 2.6 T2V/R2Vのsizeフィールドではなくresolution/ratioを使用します。shot_typeは使用されなくなりました。I2Vの出力は元のアスペクト比に従い、ratioは省略します。

Wan 2.6

T2V / R2Vのサイズ

Wan 2.6 R2Vでは、Wan 2.7のImage/Videoラベルではなく、reference_urlsの順序に従ってcharacter1、character2などを使用します。参照には、公開されたHTTP/HTTPSまたはアクセス可能なOSS URLが必要です。標準のWan 2.6モデルではaudio=falseは使用できません。音声なしの出力にはI2V FlashまたはR2V Flashを使用してください。従来のエフェクトテンプレートは、これらのモデルに共通する機能ではありません。 Flashの各バリアントは、対応するI2V/R2Vの入力プロトコルを維持しています。I2V Flashはinput.img_urlとparameters.resolutionを、R2V Flashはinput.reference_urlsとparameters.sizeを使用します。I2V Flashの動作を駆動する音声には、WAV/MP3形式、3~30秒、最大15 MBの音声を使用してください。

メディアの制約

環境に依存しないリクエストには公開URLを使用してください。OSSの一時リンクとプロバイダーのアセットIDは、上流のアカウントとリージョンにスコープが限定されており、選択したチャネルからアクセスできる必要があります。サードパーティのCDNの結果URLからデータを取得する際は、MixRouteキーを送信しないでください。

リクエスト例

Wan 3.0 Video Prime

MIXROUTE_API_KEYを設定し、example.comのメディアURLをアクセス可能なソースファイルに置き換えてください。POSTごとに別のタスクが作成されます。タイムアウトした送信を自動的に繰り返さないでください。

Wan 3.0 Video

Wan 2.7 T2V

Wan 2.7 I2V

Wan 2.7 R2V

Wan 2.7 VideoEdit

Wan 2.6 T2V

Wan 2.6 I2V

Wan 2.6 R2V

最初と最後のフレーム

プロンプトなしのファイル入力

レスポンスとポーリング

送信するとMixRouteのtask_id(およびその別名id)が返されます。これは上流のタスクIDではありません。
GET https://api.mixroute.ai/v1/video/generations/{task_id}
result_urlはSUCCESSの後にのみ読み取ってください。失敗時、ゲートウェイがresult_urlにエラーテキストを格納することがあるため、必ずしもURLとは限りません。code=“success”のエンベロープは、照会が成功したことだけを意味し、生成の成功を意味するものではありません。
上流の完全な結果はdata.dataに保持されます。usageとrequest_idはそこから読み取ってください。UNKNOWNは、上流のタスクが存在しないか有効期限切れであることを意味し、必ずしも生成エラーではありません。約15秒ごとにポーリングし、レート制限や一時的なエラーが発生した場合は間隔を延ばしてください。上流のタスク照会と結果リンクには保持期間の制限があり、通常は24時間です。完了した出力は速やかに保存してください。

Pythonのワークフロー

最終的な請求額はコンソールの請求明細で確認してください。送信時に、完了前にクォータが確保されることがあります。リクエストの見積もりと最終精算額は異なる場合があります。入力された長さ、負の長さ、ゼロの長さを、無料のタスクを取得する方法とみなさないでください。