概要
Wan (Tongyi Wanxiang) は Alibaba Cloud の動画生成モデルシリーズです。APIYI は DashScope パススルー・チャネル を通じて Alibaba Cloud Model Studio に直接接続するため、1つの APIYI キー(sk-で始まる)だけで、別途 Alibaba Cloud アカウントを用意することなく、すべての Wan 動画機能を利用できます。現在のフラッグシップは Wan2.7 で、次の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 テスト
非同期タスクの照会 / ダウンロード
APIYI で Wan を使う理由
すべての機能に対応する1つの Key
VPN 不要の直接アクセス
api.apiyi.com に直接接続でき、中国本土のデータセンターからも家庭用ネットワークからも利用可能です。Alibaba Cloud のリージョナルエンドポイントを設定する必要はありません。失敗時は課金なし
failed で終了するタスク(到達不能なメディア URL、センシティブな prompt、上流側の容量不足など)は 課金されません。そのため、自由に再試行できます。DashScope プロトコルのパススルー
主な機能
4-in-1非同期エンドポイント
POST /wan/api/v1/...video-synthesis を共有します。送信して task_id を取得し、ポーリングしてダウンロードできます。バッチ管理も簡単です。音声駆動のリップシンク
wan2.7-i2v は driving_audio をサポートし、静止ポートレートを音声の口の動きとリズムに合わせます。ラップ / ナレーション / デジタルヒューマンに最適です。複数被写体のリファレンス
wan2.7-r2v はリファレンス画像 + リファレンス動画(合計5件まで)を組み合わせ、prompt 内では「image 1 / video 1」として参照できます。音声リファレンスにも対応しています。複数の解像度と長さ
prompt_extendスマートリライトで、短い prompt の品質をさらに向上させます。対応モデル
⚠️ エンドポイントの選択(最重要)
APIYI は 2 つのパスをマウントしますが、Wan のすべての機能を完全にサポートするのは DashScope パススルーエンドポイントのみです。非同期呼び出しフロー
全体のフローは 3 つの非同期ステップです: タスクを作成 → ステータスをポーリング → 動画をダウンロード。タスクを作成
POST /wan/api/v1/services/aigc/video-generation/video-synthesis ヘッダー X-DashScope-Async: enable を付けてください。すると task_id が即座に返されます。ステータスをポーリング
GET /v1/tasks/{task_id}(Authorization 付き)で、5-10 秒ごとに 1 回(3 秒未満には絶対にしないでください)、status が completed になるまで続けます。動画をダウンロード
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 のフィールド
Wan と HappyHorse の選び方
Wan と HappyHorse はどちらも Alibaba の動画モデルで、同じエンドポイントとスキーマを共有しています(モデル名のmodel を変えるだけで切り替え可能です)。ただし、強みは異なります。
ベストプラクティス
まずは 720P / 5 秒から試す
prompt_extend を常に有効にする
prompt_extend: true は、短い prompt の品質を明確に向上させますが、追加の生成時間は数秒だけです。5〜10 秒ごとにポーリングする
保険として 20 分のクライアントタイムアウトを設定する
result_url を受け取ったらすぐにダウンロードする
result_url はデフォルトで 24 時間で期限切れ になり、OSS の署名付き直リンクです。そのため、ダウンロード時に Authorization ヘッダーを送らないでください。本番では、必ず自前の OSS / CDN に再保存してください。送信を冪等にする
エラーコードと再試行
エラーは 2 つの段階から発生し、扱いが異なります。failed タスクで [InvalidImageUrl] がある場合は再試行できます(ネットワークの一時的な問題の可能性があります)が、[InvalidParameter] / センシティブワードは再試行しないでください。FAQ
なぜ /v1/videos を使って Wan のタスクを送信できないのですか?
なぜ /v1/videos を使って Wan のタスクを送信できないのですか?
/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} に送られます。X-DashScope-Async: enable ヘッダーは何をしますか?必須ですか?
X-DashScope-Async: enable ヘッダーは何をしますか?必須ですか?
current user api does not support synchronous calls が返されます。クエリ呼び出し(GET)ではこのヘッダーは不要です。なぜ /wan/api/v1/tasks/{id} ではなく /v1/tasks/{id} でクエリするのですか?
なぜ /wan/api/v1/tasks/{id} ではなく /v1/tasks/{id} でクエリするのですか?
/v1/tasks/{task_id} に正規化します。どのパスでタスクを作成しても、この 1 つのエンドポイント経由でクエリし、レスポンスのトップレベルの status / progress / result_url / error フィールドは一貫しています。result_url のダウンロードで 403 / SignatureDoesNotMatch が返る場合はどうすればよいですか?
result_url のダウンロードで 403 / SignatureDoesNotMatch が返る場合はどうすればよいですか?
Authorization ヘッダーを外してください。result_url はすでに Alibaba Cloud OSS の事前署名済み直接リンクです。ここに APIYI Key を追加すると OSS が拒否します。result_url の有効期限が切れたらどうなりますか?
result_url の有効期限が切れたらどうなりますか?
/v1/tasks/{task_id} を再度 GET すると、通常は新しい result_url が取得できますが、task_id 自体のクエリ有効期間も 24 時間です(その後は UNKNOWN が返ります)。長期保存する場合は、できるだけ早くご自身のストレージにダウンロードしてください。progress が 30% で止まっているのですが、ハングしていますか?
progress が 30% で止まっているのですが、ハングしていますか?
status がまだ in_progress である限り、待ち続けてください。通常は 30% から 100% に一気に進みます。1つの Key で同時にいくつのタスクを実行できますか?
1つの Key で同時にいくつのタスクを実行できますか?
失敗したタスクは課金されますか?
失敗したタスクは課金されますか?
status=failed は課金されません。ただし、同じタスクを再送信すると再度課金されるため、冪等にしてください。テスト時は prompt_extend をオフにして、720P / 5 秒 / 短い prompt を使うと単価を下げられます。wan2.6 はまだ利用できますか?
wan2.6 はまだ利用できますか?
wan2.6-r2v-flash を含む)も引き続き呼び出し可能リストにあり、Wan2.7 と同じプロトコルです。変更するのは model 名だけです。過去のバージョン をご覧ください。グループ設定
Wan と HappyHorse シリーズは、単一のWan&HappyHorseグループを共有します — 1つの Token で両方のシリーズを呼び出せます。動画モデルは1秒単位で課金されるため、Token が正常にルーティングされるには2つの条件を満たす必要があります:
- 課金モデル: Pay-as-you-go Priority または Pay-as-you-go を選択してください — 動画は1秒単位で課金されるため、Pay-per-request Token はルーティングできません
- グループ:
Wan&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の固定為替レート で請求するため、実際の換算は次のとおりです:
換算: 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倍まで増え、実質価格をさらに引き下げられます:関連ドキュメント
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)
HappyHorse シリーズ
help.aliyun.com/zh/model-studio/text-to-video-api-reference。ご質問やご提案がある場合は、APIYI consoleでチケットを開いてください。