Skip to main content

概要

Wan3.0は、通義万相(Tongyi Wanxiang)のオールインワン動画モデルです。 4つのモデルID(t2v / i2v / r2v / videoedit)の切り替えが必要だったWan2.7とは異なり、Wan3.0は単一のモデルIDですべてのモードを処理します。送信するメディアに応じて動作が決定されます。テキストからの動画生成、画像からの動画生成、リファレンス動画生成、動画編集のすべてが1つのリクエストボディを共有します。 機能は同一で、速度と価格が異なる2つのバリアントがあります:
両バリアントともパラメータ、エンドポイント、メディアの仕様は完全に共通しており、異なるのは速度と単価のみです。まずはwan3.0-videoで構築を行い、レイテンシが重視される本番トラフィックをwan3.0-video-primeへと切り替えてください。

Wan2.7からの変更点

Wan2.7も引き続き完全に利用可能です。Wan2.7 動画生成をご参照ください。

主な機能

4つのモードを1つのモデルで

テキストからの動画生成、画像からの動画生成(最初/最後のフレーム)、リファレンスからの動画生成(画像、動画、音声)、および動画編集は、1つのモデルIDと1つのエンドポイントを共有しており、type(input.media[] 内)によって区別されます。

最大30秒

1リクエストあたり最大30秒(入力リファレンス動画と出力の合計)に対応 — Wan2.7の15秒の2倍であり、完全なナレーションセグメントやショートドラマの1カットに十分な長さです。

ネイティブオーディオ

出力にはデフォルトで soun トラックが含まれており、駆動用音声は不要です。特定の声質が必要な場合は reference_audio を使用してください。

3つの解像度ティア

新しい480Pティアは1080Pの4分の1のコストです — 低コストで下書きを作成し、最終レンダリングに向けてアップスケールできます。

グループの設定

Wan3.0 は Wan2.7 および HappyHorse と Wan&HappyHorse グループを共有しており、1つのキーですべてを呼び出すことができます。動画は秒単位で課金されるため、正常にルーティングするにはキーが次の2つの条件を満たしている必要があります。
  1. 課金モード:「従量課金優先(Pay-as-you-go priority)」または「従量課金(Pay-as-you-go)」を選択してください。秒単位の動画は呼び出し単位のキーではルーティングできません
  2. グループ:Wan&HappyHorse を含める
token 作成画面:課金モードが従量課金優先に設定され、グループドロップダウンが Wan&HappyHorse (0.14x) に設定されている状態

Create a key: set billing mode to pay-as-you-go priority and select the Wan&HappyHorse group (0.14x) to call every Wan3.0 / Wan2.7 / HappyHorse video model (the screenshot shows the old group name Wan)

料金

デフォルトでAlibaba公式価格の98% — 最高額のチャージボーナス適用で最安81.7%。 これにより、wan3.0-videoでは480Pが**$0.0245/秒**(≈ ¥0.17/秒)、720Pが**$0.049/秒**(≈ ¥0.34/秒)となります。

レート算出方法:デフォルトで0.98倍、ボーナス適用で最安0.817倍

コンソール上では、Wan&HappyHorseグループはCNY建てで0.14倍の倍率が表示されています。APIYIは1:7の固定為替レートによるUSDで決済されます:
したがって、APIYIの1秒あたりの価格(USD)= Alibaba公式の1秒あたりのCNY価格 × 0.14となり、これは公式レートの98%に相当します。

表1:APIYIの詳細料金(秒単位の課金)

「10% / 20%ボーナス適用時」は、チャージボーナスによって付与残高が増額された後の実質単価です。各呼び出し時に差し引かれる金額自体はデフォルト価格のままとなります。

表2:Alibaba公式価格とのティア別比較

wan3.0-videoには現在、公式の期間限定30%割引が適用されており(すべてのユーザーにデフォルトで適用)、APIYIの料金もこの割引レートに連動しています。wan3.0-video-primeには割引はありません。プロモーション終了時にはAPIYIの料金も調整されます。

表3:一般的な動画の長さにおける合計費用

チャージボーナスの併用

チャージボーナスを利用すると、付与残高が最大約1.2倍になり、実質レートがさらに低くなります:
1:7は固定決済レートであり(プロモーションレートではありません)、すべてのUSDチャージに適用されます。
価格はプロバイダーの公式レートに準拠しており、それに伴い変動する場合があります。上記の表は参考用であり、トップナビゲーションのモデル料金タブの内容が正式なものとなります:モデル料金。

⚠️ 課金ルール(他の動画モデルとは異なります)

課金対象秒数 = 入力参照動画の長さ + 出力動画の長さ。 Alibabaによると:「入力動画と出力動画の両方が再生時間に応じて課金され、単価は出力解像度によって決定されます。」
コストを削減するには、参照動画をトリミングしてください — durationを短くしても入力秒数は変わりません。例:10秒の参照動画と2秒の出力では12秒分が課金されますが、参照動画を3秒にトリミングすると5秒分のみの課金になります。

事前承認と決済

  • 参照動画がない場合: リクエストされたdurationが前払いで請求され、それが最終金額となります — 追加の精算エントリーはありません。
  • 参照動画がある場合: 送信時点ではゲートウェイは入力動画の長さを把握できないため、30秒の上限で事前承認を行い、その後実際の課金対象秒数に基づいて再計算され、差額が返金されます(請求明細にマイナスのエントリーとして個別に記録されます)。
上限に基づく保留により、一時的により多くの金額が凍結されます:480Pで$0.147、720Pで$0.294、1080Pで$0.588(wan3.0-video、30秒)。十分な残高を維持してください。返金はタスク完了後数秒以内に行われます。

⚠️ エンドポイントの選択(最重要)

APIYIは2つのパスを公開していますが、Wan3.0で完全に動作するのはDashScopeパススルーエンドポイントのみです:
Wanの動画ジョブを/v1/videosに送信するドキュメントやサンプルは無視してください。そのパスではmediaフィールドがドロップされ、解像度および再生時間のパラメータが無視され、過大に課金されます。Wan3.0のリクエストはすべて/wan/api/v1/...video-synthesisに送信してください。

非同期ワークフロー

1

タスクの作成

X-DashScope-Async: enableヘッダーを付けてPOST /wan/api/v1/services/aigc/video-generation/video-synthesisを実行します。即座にtask_idが返されます。
2

ステータスのポーリング

statusがcompletedになるまで、5〜10秒ごと(絶対に3秒未満にしないでください)にGET /v1/tasks/{task_id}(Authorization付き)を実行します。
3

動画のダウンロード

レスポンスのresult_urlを直接GETします — Authorizationヘッダーは含めないでください(署名付きOSSリンクであるため、認証情報を送信すると403が返されます)。有効期限は24時間です。

タスクステータス

終了状態の値は**completed / failed**であり、DashScopeネイティブのSUCCEEDED / FAILEDではありません。ネイティブの列挙型に合わせて書かれたコードは無限にポーリングし続けることになります。
無効なパラメータも最初はHTTP 200を返し、非同期に失敗します — 同期的な400ではありません。アクセスできないメディアURLや、入力と出力の合計が30秒を超える場合などは、終了状態までポーリングして初めて判明します。リクエスト送信時のステータスコードだけを信頼しないでください。

完全なPythonクライアント

パラメーターリファレンス

リクエストボディはネストされたDashScope構造を使用します:{ model, input: { prompt, media[] }, parameters: {...} }。

input フィールド

media[] のタイプと選択されるモード

first_frame / last_frame は reference_* / file / link と混在させることはできません — 2つのアセットファミリーは相互に排他的であり、混在させるとアップストリームで拒絶されます。
すべてのメディアオブジェクトには少なくとも type と url が必要です。url は一般にアクセス可能な https リンクである必要があります(ローカルファイルを事前にOSS / CDNにアップロードし、タスクが完了するまでアクセス可能な状態を維持してください)。

parameters フィールド

duration は整数("5" ではなく 5)である必要があり、resolution は大文字(720P)で指定する方が確実です。

選び方:Wan3.0 / Wan2.7 / HappyHorse

ベストプラクティス

480Pのコストは1080Pの4分の1です。promptとカメラワークを低コストで確定させましょう。5秒の1080Pレンダリング1回分の料金で、4回の下書きを作成できます。
入力動画の秒数に応じて課金されます。クリップのうち3秒しか必要ない場合は、30秒の元動画をアップロードしないでください。これはWan3.0において最も陥りやすいコストの罠です。
動画モデルは「誰が何をし、カメラがどのように動くか」に反応します。「窓辺で伸びをする茶トラ猫、ゆっくりドリーイン」のほうが、「かわいい茶トラ猫、日光、高解像度」よりも優れた結果を生みます。
5秒のクリップの実測配信時間:480Pで約100秒、720Pで約120秒、1080Pで約170秒です。5〜10秒ごとのポーリングで十分です。
失敗したタスクは全額返金されますが、再送信すると再度課金されます。モデレーション失敗の場合はpromptを変更し、アセットエラーの場合はまずURLへのアクセス可能性を確認してください。

よくある質問

課金秒数 = 入力参照動画の長さ + 出力の長さです。10秒の参照動画で2秒の出力の場合、12秒分が課金されます。参照画像、音声、ファイルは無料です。
参照動画を含むタスクは上限である30秒分で事前承認され、その後実際の課金秒数に基づいて精算され、差額が返金されます。請求明細にマイナスの調整項目が表示されます。
これはアップストリーム側のおおまかな進捗レポートであり、停止しているわけではありません。1080Pや長尺のクリップは3〜5分かかる場合があります。ポーリングを続けてください。
Authorization ヘッダーは送信しないでください — これは署名付きOSSリンクです。リンクは24時間後に期限切れとなるため、速やかに再ホストしてください。
パラメータやアセットのエラーは同期的な400ではなく、非同期に失敗します。一般的な原因:アクセスできないメディアURL(期限切れの署名付きリンクを含む)、入力 + 出力が30秒を超えている、コンテンツモデレーション。失敗したタスクは全額返金されます。
APIキーの課金モードが従量課金制(pay-as-you-go)(呼び出し回数単位のキーでは動画モデルをルーティングできません)になっていること、およびそのグループに Wan&HappyHorse が含まれていることを確認してください。

関連ドキュメント

動画生成 API リファレンス

ライブPlaygroundに加え、cURL / Python / Nodeのサンプルを提供

Wan2.7 動画生成

音声駆動によるリップシンクに対応した、前世代の4モデル

HappyHorse 動画生成

同グループ内のもうひとつの動画シリーズ

モデル料金

サイト全体の公式料金表
公式リファレンス: help.aliyun.com/zh/model-studio/wan3-video-generation-guide、help.aliyun.com/zh/model-studio/wan3-video-generation-api-reference