Skip to main content

概要

Wan (Tongyi Wanxiang) は Alibaba Cloud の動画生成モデルシリーズです。APIYI は DashScope パススルー・チャネル を通じて Alibaba Cloud Model Studio に直接接続するため、1つの APIYI キー(sk-で始まる)だけで、別途 Alibaba Cloud アカウントを用意することなく、すべての Wan 動画機能を利用できます。現在のフラッグシップは Wan2.7 で、次の4つの主要ユースケースをカバーします。
🎬 重要ポイント: 4つの機能はすべて同じ非同期エンドポイントと同じリクエスト構造を共有します。model フィールドを変更するだけでユースケースを切り替えられます。 720P / 1080P 解像度と 2-15 秒の整数再生時間をネイティブにサポートし、wan2.7-i2v もリップシンク用のドライビングオーディオに対応します。ショート動画制作、Eコマース素材、デジタルヒューマンのナレーション、クリエイティブなマーケティングに最適です。

テキストから動画生成 API

wan2.7-t2v は、純粋な prompt から動画を生成する、最もシンプルな入口です。

画像から動画生成 API

wan2.7-i2v は、最初のフレームと、リップシンク / ラップ用の任意のドライビングオーディオを受け取ります。

参照から動画生成 API

wan2.7-r2v は、参照画像/動画から被写体の特徴を保持し、音声参照に対応します。

動画編集 API

wan2.7-videoedit は、参照画像を使って動画を編集します: 衣装の差し替え、背景の差し替えなど。

Visual API テスト

iCover のビジュアルテストツールでこのエンドポイントを直接デバッグできます — コードは不要です。

非同期タスクの照会 / ダウンロード

APIYI コンソールで送信済みの動画タスクを表示し、動画リンクをダウンロードできます — API の外にある参照エントリです。

APIYI で Wan を使う理由

すべての機能に対応する1つの Key

Alibaba Cloud への登録も、リージョン設定も、環境変数も不要です。1つの APIYI Key で、Wan2.7 の4つすべての機能と HappyHorse シリーズ を利用できます。

VPN 不要の直接アクセス

api.apiyi.com に直接接続でき、中国本土のデータセンターからも家庭用ネットワークからも利用可能です。Alibaba Cloud のリージョナルエンドポイントを設定する必要はありません。

失敗時は課金なし

failed で終了するタスク(到達不能なメディア URL、センシティブな prompt、上流側の容量不足など)は 課金されません。そのため、自由に再試行できます。

DashScope プロトコルのパススルー

リクエストボディは Alibaba Cloud のネイティブな DashScope プロトコルに 1 対 1 でマッピングされるため、公式ドキュメントに従って移行できます。レスポンスは、ポーリングしやすいように正規化されています。

主な機能

4-in-1非同期エンドポイント

t2v / i2v / r2v / video-edit は POST /wan/api/v1/...video-synthesis を共有します。送信して task_id を取得し、ポーリングしてダウンロードできます。バッチ管理も簡単です。

音声駆動のリップシンク

wan2.7-i2vdriving_audio をサポートし、静止ポートレートを音声の口の動きとリズムに合わせます。ラップ / ナレーション / デジタルヒューマンに最適です。

複数被写体のリファレンス

wan2.7-r2v はリファレンス画像 + リファレンス動画(合計5件まで)を組み合わせ、prompt 内では「image 1 / video 1」として参照できます。音声リファレンスにも対応しています。

複数の解像度と長さ

720P / 1080P の解像度、2-15秒の整数指定の長さ。prompt_extendスマートリライトで、短い prompt の品質をさらに向上させます。

対応モデル

wan2.7-videoedit は、画像を使って動画を編集するためのものです。別の wan2.7-image-pro画像 モデル(/v1/images/generations を使用します)であり、この動画エンドポイントの対象外ですので、混同しないでください。従来の Wan2.6 シリーズについては、過去のバージョン をご覧ください。

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

APIYI は 2 つのパスをマウントしますが、Wan のすべての機能を完全にサポートするのは DashScope パススルーエンドポイントのみです
もしどのドキュメントやサンプルが Wan の動画タスクを /v1/videos 経由で送信するよう案内していても、無視してください。そのパスの i2v / r2v media フィールドへの対応は不完全で、上流のエラー [InvalidParameter] Field required: input.media を引き起こします。Wan の動画作成リクエストはすべて /wan/api/v1/...video-synthesis に送信されます。

非同期呼び出しフロー

全体のフローは 3 つの非同期ステップです: タスクを作成 → ステータスをポーリング → 動画をダウンロード
1

タスクを作成

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

ステータスをポーリング

GET /v1/tasks/{task_id}Authorization 付き)で、5-10 秒ごとに 1 回(3 秒未満には絶対にしないでください)、statuscompleted になるまで続けます。
3

動画をダウンロード

レスポンスの result_url から mp4 を直接 GET します。Authorization ヘッダーは送信しないでください(これは OSS 署名付きの直接リンクであり、Auth を追加すると 403 になります)。

タスクステータスの参照

status フィールドの GET /v1/tasks/{task_id} レスポンスのトップレベル(APIYI によりすでに正規化済み):

完全版 Python クライアント

主要パラメータの説明

送信時、リクエストボディは DashScope のネスト構造を使用します: { model, input: { prompt, media[] }, parameters: {...} }.

input のフィールド

media[] の種類

各メディアオブジェクトには少なくとも type + url が必要です。url は、GET で直接取得できる公開 https リンクである必要があります(ローカルファイルは先に OSS / CDN にアップロードしてください)。

parameters のフィールド

duration整数 5 でなければならず、文字列の "5" ではありません。そうしないと cannot unmarshal string into Go struct field ... of type int になります。resolution大文字 で書く(720P)ほうがより確実です。

Wan と HappyHorse の選び方

Wan と HappyHorse はどちらも Alibaba の動画モデルで、同じエンドポイントとスキーマを共有しています(モデル名の model を変えるだけで切り替え可能です)。ただし、強みは異なります。
リップシンク / ラップ / デジタルヒューマンのナレーションが必要wan2.7-i2v を選んでください(音声駆動に対応している唯一のモデルです)。 被写体の一貫性を保つために多くの参照画像が必要HappyHorse r2v(最大 9 画像) を検討してください。

ベストプラクティス

1

まずは 720P / 5 秒から試す

開発中は、低解像度の短いクリップで prompt とカメラ指示をすばやく検証し、確定後に 720P / 1080P やより長い再生時間へ段階的に引き上げて、コストと待ち時間を抑えます。
2

prompt_extend を常に有効にする

prompt_extend: true は、短い prompt の品質を明確に向上させますが、追加の生成時間は数秒だけです。
3

5〜10 秒ごとにポーリングする

3 秒未満にはしないでください(レート制限がかかります)。また、長時間タスクで無期限にブロックしないでください。720P / 5 秒は通常 70〜140 秒かかり、1080P / より長いクリップでは 5 分を超えることがあります。
4

保険として 20 分のクライアントタイムアウトを設定する

1080P や 10 秒を超えるクリップはかなり遅くなります。ポーリングループには 20 分の保険タイムアウトを設定してください。
5

result_url を受け取ったらすぐにダウンロードする

result_url はデフォルトで 24 時間で期限切れ になり、OSS の署名付き直リンクです。そのため、ダウンロード時に Authorization ヘッダーを送らないでください。本番では、必ず自前の OSS / CDN に再保存してください。
6

送信を冪等にする

失敗したタスクは課金されませんが、同じタスクを再送すると再度課金されます。誤課金を防ぐため、アプリ層で「業務 ID → task_id」の対応表を管理してください。

エラーコードと再試行

エラーは 2 つの段階から発生し、扱いが異なります。
推奨されるクライアントの挙動: HTTP 5xx / ネットワークエラーでは指数バックオフで再試行してください(1s / 4s / 16s)。HTTP 4xx は再試行せず即座に表面化してください。failed タスクで [InvalidImageUrl] がある場合は再試行できます(ネットワークの一時的な問題の可能性があります)が、[InvalidParameter] / センシティブワードは再試行しないでください。

FAQ

/v1/videos は OpenAI のフラットスタイルのエンドポイントで、Wan の i2v / r2v への対応が不完全です。media のようなメディアフィールドは削除され、上流の Alibaba Cloud は [InvalidParameter] Field required: input.media を返します。Wan の動画作成リクエストはすべて /wan/api/v1/services/aigc/video-generation/video-synthesis に送られます、クエリは常に /v1/tasks/{task_id} に送られます。
エンドポイントに「これは非同期タスクです。task_id をすぐ返し、ブロックしないでください」と伝えます。作成リクエストでは必須です。省略すると current user api does not support synchronous calls が返されます。クエリ呼び出し(GET)ではこのヘッダーは不要です。
APIYI はすべての動画タスクのクエリを /v1/tasks/{task_id} に正規化します。どのパスでタスクを作成しても、この 1 つのエンドポイント経由でクエリし、レスポンスのトップレベルの status / progress / result_url / error フィールドは一貫しています。
Authorization ヘッダーを外してください。result_url はすでに Alibaba Cloud OSS の事前署名済み直接リンクです。ここに APIYI Key を追加すると OSS が拒否します。
リンクの有効期間はデフォルトで 24 時間 です。期限切れ後に /v1/tasks/{task_id} を再度 GET すると、通常は新しい result_url が取得できますが、task_id 自体のクエリ有効期間も 24 時間です(その後は UNKNOWN が返ります)。長期保存する場合は、できるだけ早くご自身のストレージにダウンロードしてください。
いいえ。上流の Alibaba Cloud が報告する進捗は粗い粒度です(0% / 10% / 30% / 100% の区分のみ)。status がまだ in_progress である限り、待ち続けてください。通常は 30% から 100% に一気に進みます。
実際には 4〜8 件を一度に送信してもレート制限にかかりません。本番では、同時にアクティブなタスクは ≤10 にしてください。それ以上はキューに入ります。クエリ API のデフォルト RPS はかなり高めですが、5〜10 秒のポーリング間隔を推奨します。
status=failed は課金されません。ただし、同じタスクを再送信すると再度課金されるため、冪等にしてください。テスト時は prompt_extend をオフにして、720P / 5 秒 / 短い prompt を使うと単価を下げられます。
はい。Wan2.6 シリーズ(wan2.6-r2v-flash を含む)も引き続き呼び出し可能リストにあり、Wan2.7 と同じプロトコルです。変更するのは model 名だけです。過去のバージョン をご覧ください。

グループ設定

Wan と HappyHorse シリーズは、単一のWan&HappyHorseグループを共有します — 1つの Token で両方のシリーズを呼び出せます。動画モデルは1秒単位で課金されるため、Token が正常にルーティングされるには2つの条件を満たす必要があります:
  1. 課金モデル: Pay-as-you-go Priority または Pay-as-you-go を選択してください — 動画は1秒単位で課金されるため、Pay-per-request Token はルーティングできません
  2. グループ: Wan&HappyHorseを含むグループを選択してください
Token作成ダイアログ: 課金モデルを Pay-as-you-go Priority に設定し、グループのドロップダウンに Wan&HappyHorse(レート 0.14x)を表示、1つの Token で Wan2.7 と HappyHorse の両方に使用可能

Create Token: set billing model to Pay-as-you-go Priority and group to Wan&HappyHorse (0.14x) to call every Wan2.7 and HappyHorse video model (the screenshot shows the group's former name Wan, since renamed to Wan&HappyHorse)

価格

デフォルト価格 = アリババの公式価格の98%(理解しやすい)

コンソールでは Wan&HappyHorse グループに 0.14x のレートが表示されますが、これは内蔵の RMB 価格単位で表されています。APIYI は USD を1:7の固定為替レート で請求するため、実際の換算は次のとおりです:
言い換えると、デフォルト価格 = アリババ公式価格の98% です。アリババから直接購入するより安く、海外回線を自前で用意する必要もありません。
換算: 1秒あたりのUSD価格 = 公式RMB価格 × 0.14(つまり × 0.98 ÷ 7)。たとえば、1080P の公式価格が ¥1.0/秒 の場合、$0.14/秒 となり、コンソールに表示される 0.14x とまったく同じです。

価格の詳細(デフォルト価格、秒単位課金)

Wan2.7 のテキストから動画生成 / 画像から動画生成 / 参照から動画生成 は同一価格で、2つの階層 — 720P / 1080P(480P はサポートされません):
  • wan2.7-r2v のデフォルトは 1080P で、参照メディアに動画が含まれる場合、継続時間は最大10秒に制限されます。
  • wan2.7-videoedit(動画編集)の出力継続時間は元動画に従い、duration ではなく実際の出力秒数で課金されます。
  • 表示価格は**デフォルト(公式の98%)**です。最大チャージボーナスを適用すると、実質価格はおおむね表の値の ÷ 1.2 になります(例: 1080P 5 秒 $0.70 → 約 $0.58)。

さらに低い実質価格を実現するチャージボーナスの積み上げ

チャージボーナスプログラム に参加すると、付与残高は最大で約1.2倍まで増え、実質価格をさらに引き下げられます:
そのため、大口利用者は公式価格の約81.6% まで到達できます。
  • 課金単位 = 解像度階層 × 継続時間(秒)。失敗したタスクは課金されません。
  • 1:7 は固定精算レート(優遇レートではありません)で、すべてのUSDチャージに一律で適用されます。
  • 最高ボーナス階層と対象チャネルについては、チャージボーナスをご覧ください。最新レートは コンソール が正です。

関連ドキュメント

Text-to-Video Playground

wan2.7-t2v ライブデバッグ + コードサンプル

Image-to-Video Playground

wan2.7-i2v 先頭フレーム + 駆動音声

Reference-to-Video Playground

wan2.7-r2v 複数被写体の参照 + 音声

Video Edit Playground

wan2.7-videoedit 衣装 / 背景の入れ替え

過去のバージョン (Wan2.6)

Wan2.6 シリーズと移行ノート

HappyHorse シリーズ

こちらも Alibaba ベースで、並列比較の選定ガイド
Alibaba Cloud 公式ドキュメント(参照): help.aliyun.com/zh/model-studio/text-to-video-api-reference。ご質問やご提案がある場合は、APIYI consoleでチケットを開いてください。