> ## Documentation Index > Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt > Use this file to discover all available pages before exploring further. # Wan 2.7・Wan 3.0 動画生成API：料金と使い方 > Wan 2.7とWan 3.0で、テキスト・画像・参照素材からの動画生成と動画編集のタスクを作成してMP4を保存し、1秒あたりの料金を確認できます。 Wan 2.7とWan 3.0は、DashScope互換の非同期タスクとして呼び出します。`Wan` グループのトークンが必要で、動画の秒数に応じて課金されます。 | 項目 | 内容 | | - | - | | Wan 3.0のモデル | `wan3.0-video`（標準）と `wan3.0-video-prime`（高速）。どちらも1つのモデルで、テキスト・画像・参照素材からの動画生成と動画編集に対応 | | Wan 2.7のモデル | `wan2.7-t2v`（テキストから動画）、`wan2.7-i2v`（画像から動画）、`wan2.7-r2v`（参照素材から動画）、`wan2.7-videoedit`（動画編集） | | Wan 2.6のモデル | 2026年10月14日に提供終了。Wan 2.7かWan 3.0を使う | | タスクの作成 | `POST /wan/api/v1/services/aigc/video-generation/video-synthesis` | | タスクの照会 | `GET /v1/tasks/{task_id}`。完了後に `result_url` からMP4をダウンロード | | トークングループ | `Wan`（下の「Wanのトークンを作成する」を参照） | | 課金 | 動画の秒数に応じた課金で、Alibaba Cloudの定価の約1.2倍。モデルごとの価格は下の「課金と料金」を参照 | | 結果の保存期間 | Alibaba Cloudは `task_id` と動画URLを24時間保持する。タスクが完了したらすぐ動画を保存する | | リクエストの決まり | ベースURL、認証、非同期ヘッダー、ポーリング間隔、タイムアウトは下の「エンドポイントとリクエストの決まり」を参照 | > [!WARNING] > > **Wanのリクエストを `/v1/videos` に送らないでください。** 画像から動画、参照素材から動画、動画編集のタスクにはDashScopeの `input.media[]` ペイロードが必要なため、Wanのタスクはすべて上の表のエンドポイントで作成します。 ## Wanのトークンを作成する | 設定 | 値 | | - | - | | コンソール | [トークン管理](https://api.laozhang.ai/token)でトークンを作成 | | グループ | `Wan` | | 課金方式 | 従量優先（推奨。コンソールの表示は「按量优先」）または従量課金（「按量计费」） | | リクエストヘッダー | `Authorization: Bearer $LAOZHANG_API_KEY` | Wanのモデルは `Wan` グループでのみ利用できるため、トークンもこのグループにしてください。`default` や `SeeDance2` など他のグループのトークンでは呼び出せず、チャネルがないというエラーになります。Wan専用のトークンを作っておくと、モデルやタスクごとのログと課金の確認も楽になります。 ## 課金と料金 Wanの動画は秒単位の課金で、Alibaba Cloud Model Studioの定価に20%を上乗せしています。上乗せ分は、税金、通貨換算と国際決済、プラットフォームの運用、技術サポートなどのコストに充てています。2026年10月14日以降の換算は次のとおりです。 * USDの秒単価 = Alibaba Cloudの人民元の秒単価 × 0.1714（`Wan` グループの倍率） * 固定レート1:7では 0.1714 × 7 ≈ 1.2 となり、定価の約1.2倍を支払います 呼び出しログの金額には倍率がすでに含まれているため、重ねて掛けないでください。1秒あたりの価格は次のとおりです。 | モデル | 解像度 | Alibaba Cloudの定価 | 1秒あたり | | - | - | -: | -: | | `wan3.0-video` | 480P / 720P / 1080P | ¥0.3 / ¥0.6 / ¥1.2 | \$0.0514 / \$0.1028 / \$0.2057 | | `wan3.0-video-prime` | 480P / 720P / 1080P | ¥0.45 / ¥0.9 / ¥1.8 | \$0.0771 / \$0.1543 / \$0.3085 | | Wan 2.7の4モデルすべて | 720P / 1080P | ¥0.6 / ¥1.0 | \$0.1028 / \$0.1714 | Wan 2.7のテキストから動画、画像から動画、参照素材から動画、動画編集の各モデル（`wan2.7-t2v`、`wan2.7-i2v`、`wan2.7-r2v`、`wan2.7-videoedit`）は同じ料金です。Alibaba Cloudの価格は、[Model Studioの料金](https://help.aliyun.com/zh/model-studio/model-pricing)（中国語）にある華北2（北京）リージョンのものです。 課金される秒数の数え方は次のとおりです。 * **出力のみ**（テキストから動画、画像から動画、参照画像のみ）：生成した動画の秒数。 * **入力動画あり**：入力の秒数と出力の秒数の合計。Alibaba Cloudと同じルールです。 * `wan2.7-videoedit`：元の動画と出力の合計。`duration` を2〜10秒にすると、元の動画が先頭から切り詰められ、切り詰めた部分だけが数えられます。 * 参照動画を使う `wan2.7-r2v`：参照動画の最大5秒分と出力の合計。 * `reference_video` を使うWan 3.0（参照、編集、延長）：入力動画の全秒数と出力の合計。 * **`resolution` の指定なし**：Wan 2.7、Wan 3.0とも既定値は1080Pで、1080Pとして課金されます。 費用の例です。 * `wan2.7-i2v`、720P、5秒：5 × \$0.1028 ≈ \$0.51 * `wan3.0-video`、1080P、10秒：10 × \$0.2057 ≈ \$2.06 * `wan2.7-videoedit` で5秒のクリップを720Pで編集：(5 + 5) × \$0.1028 ≈ \$1.03 タスクの作成時に、リクエストした長さの分が先に課金されます。タスクが終わると、Alibaba Cloudが報告した秒数で精算され、差額が返金または追加課金されます。入力動画のあるWan 3.0のタスクは、先に30秒分が課金され、あとで差額が返金されるため、残高にはその分の余裕が必要です。 失敗したタスクは課金されませんが、同じタスクを2回送ると2回分課金されます。自社の業務IDと各 `task_id` を対応づけ、無条件の自動リトライは避けてください。 各タスクの実際の課金額は[呼び出しログ](https://api.laozhang.ai/log)で確認できます。失敗したタスクに課金が表示されている場合は、タスクIDを添えて[サポート](mailto:hi@laozhang.ai)に連絡してください。 費用は出力の長さと解像度で決まります。`duration` と `resolution` を明示し、タスクを作成する前に上の表で費用を見積もってください。Wanのモデルとグループは[AIモデルのAPI料金一覧](https://docs.laozhang.ai/ja/models.md)にも掲載しています。 > [!TIP] > > 720p前後で音声付きの短いクリップなら、[MiniMax H3](https://docs.laozhang.ai/ja/api-capabilities/minimax-h3-video-generation.md)は768Pの5秒で\$0.25、[Muse](https://docs.laozhang.ai/ja/api-capabilities/muse-video-generation.md)は10秒で\$0.30です。どちらも `default` グループのトークンで呼び出せます。全モデルの比較は[動画APIの比較](https://docs.laozhang.ai/ja/api-capabilities/video-generation-guide.md)を参照してください。 ## Wanのタスクの流れ **1. タスクを作成する** JSONボディと `X-DashScope-Async: enable` ヘッダーを付けて、`POST /wan/api/v1/services/aigc/video-generation/video-synthesis` を送ります。レスポンスの `output.task_id` を保存してください。 **2. タスクをポーリングする** 5〜10秒おきに `GET /v1/tasks/{task_id}` を送ります。分岐には、ネストされた上流のフィールドではなく、トップレベルの `status` を使います。 **3. 動画をダウンロードする** `status` が `completed` になったら、トップレベルの `result_url` からMP4をダウンロードします。署名付きのオブジェクトストレージURLなので、LaoZhang APIの `Authorization` ヘッダーは付けないでください。 リクエストの決まり、タスクの状態、フィールドの詳細は、コード例のあとの「エンドポイントとリクエストの決まり」から順に説明しています。 ## 環境の準備 シェルの例は `curl` と `jq` を使います（jqは `brew install jq` または `sudo apt-get install jq` でインストールできます）。キーとベースURLを一度だけ設定します。 ```bash theme={null} export LAOZHANG_API_KEY="YOUR_API_KEY" # 自分のLaoZhang APIキーに置き換える export BASE_URL="https://api.laozhang.ai" ``` 以下の作成リクエストの例はいずれも、レスポンスを `create.json` に保存します。後の「タスクをポーリングして動画をダウンロードする」で、このファイルを読み取ります。 ## テキストから動画を生成する ```bash theme={null} curl -sS -X POST "$BASE_URL/wan/api/v1/services/aigc/video-generation/video-synthesis" \ -H "Authorization: Bearer $LAOZHANG_API_KEY" \ -H "Content-Type: application/json" \ -H "X-DashScope-Async: enable" \ --data-raw '{ "model": "wan2.7-t2v", "input": { "prompt": "A lighthouse at sunset, slow cinematic push-in, ocean waves hitting rocks, seabirds in the distance" }, "parameters": { "resolution": "720P", "duration": 5, "prompt_extend": true, "watermark": true } }' | tee create.json ``` 作成のレスポンスでは、タスクIDが `output.task_id` に入っています。 ```json theme={null} { "output": { "task_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "task_status": "PENDING" }, "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" } ``` レスポンスに `output.task_id` がない場合は、`create.json` のエラーメッセージを読み、下の「トラブルシューティング」の表を確認してください。 ## 画像から動画を生成する ```bash theme={null} curl -sS -X POST "$BASE_URL/wan/api/v1/services/aigc/video-generation/video-synthesis" \ -H "Authorization: Bearer $LAOZHANG_API_KEY" \ -H "Content-Type: application/json" \ -H "X-DashScope-Async: enable" \ --data-raw '{ "model": "wan2.7-i2v", "input": { "prompt": "A graffiti character comes alive and performs energetic rap under a railway bridge at night", "media": [ { "type": "first_frame", "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png" }, { "type": "driving_audio", "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/ozwpvi/rap.mp3" } ] }, "parameters": { "resolution": "720P", "duration": 10, "prompt_extend": true, "watermark": true } }' | tee create.json ``` `driving_audio` は任意です。上のラップの例のように、Alibaba Cloudは音声に合わせて口の動きやビートに乗った動きを生成します。`first_frame` の画像と組み合わせたときだけ使え、ほかの素材と同じく公開HTTPSのURLが必要です。 使える音声の形式、長さ、ファイルサイズは、Alibaba Cloudの[Wan 2.7 画像から動画APIリファレンス](https://help.aliyun.com/zh/model-studio/image-to-video-general-api-reference)（中国語）を参照してください。 ## 参照素材から動画を生成する ```bash theme={null} curl -sS -X POST "$BASE_URL/wan/api/v1/services/aigc/video-generation/video-synthesis" \ -H "Authorization: Bearer $LAOZHANG_API_KEY" \ -H "Content-Type: application/json" \ -H "X-DashScope-Async: enable" \ --data-raw '{ "model": "wan2.7-r2v", "input": { "prompt": "A girl wearing the referenced dress walks slowly through a sunset garden with cinematic lighting", "media": [ { "type": "reference_image", "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260402/fwjpqf/wan2.7-videoedit-change-clothes.png" } ] }, "parameters": { "resolution": "720P", "duration": 5, "prompt_extend": true, "watermark": true } }' | tee create.json ``` ## 動画を編集する ```bash theme={null} curl -sS -X POST "$BASE_URL/wan/api/v1/services/aigc/video-generation/video-synthesis" \ -H "Authorization: Bearer $LAOZHANG_API_KEY" \ -H "Content-Type: application/json" \ -H "X-DashScope-Async: enable" \ --data-raw '{ "model": "wan2.7-videoedit", "input": { "prompt": "Dress the girl in the video in the outfit shown in the reference image", "media": [ { "type": "video", "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260403/nlspwm/T2VA_22.mp4" }, { "type": "reference_image", "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260402/fwjpqf/wan2.7-videoedit-change-clothes.png" } ] }, "parameters": { "resolution": "720P", "prompt_extend": true, "watermark": true } }' | tee create.json ``` ## Wan 3.0で動画を生成する Wan 3.0は、タスクの種類ごとにモデルIDを分けていません。1つのモデルが `input.media[]` の内容を読み、テキストから動画、画像から動画、参照素材から動画、動画編集のどれかを判断します。2つのモデルの機能は同じです。 * `wan3.0-video`：標準モデル * `wan3.0-video-prime`：高速なモデル。1秒あたりの料金は高め どちらも同じ作成エンドポイントを使い、ポーリングとダウンロードの方法もWan 2.7と同じです。 | タスク | `input.media[]` | | - | - | | テキストから動画 | `media` を省略 | | 先頭フレーム、または先頭・末尾フレーム | `first_frame` を1つ。`last_frame` は任意 | | 参照素材から動画 | `reference_image` を最大10個。`reference_video` と `reference_audio` は各最大5個で、種類ごとに合計15秒まで | | 動画の編集・延長 | `reference_video` を1つ。編集や延長の内容は `prompt` に書く。延長では `ratio` を `adaptive` にする | 参照素材から動画を作るプロンプトでは、入力を "image 1"、"video 1"、"audio 1"（中国語では 图1、视频1、音频1）のように指定できます。番号は、同じ種類の入力の中での順番です。 Wan 2.7と動作が異なる `parameters` があります。 | フィールド | 値 | | - | - | | `resolution` | `480P`、`720P`、`1080P`。既定値は `1080P` | | `duration` | 2〜30の整数（秒）。既定値は5。入力動画がある場合、入力と出力の合計は30秒まで | | `ratio` | `adaptive`（既定値。入力から比率を決める）、`21:9`、`16:9`、`4:3`、`1:1`、`3:4`、`9:16` | | `audio` | 既定値は `true` で音声付き。`false` にすると無音の動画で、料金は同じ | テキストから動画を生成する最小のリクエストです。 ```bash theme={null} curl -sS -X POST "$BASE_URL/wan/api/v1/services/aigc/video-generation/video-synthesis" \ -H "Authorization: Bearer $LAOZHANG_API_KEY" \ -H "Content-Type: application/json" \ -H "X-DashScope-Async: enable" \ --data-raw '{ "model": "wan3.0-video", "input": { "prompt": "A kitten runs across moonlit rooftops while neon signs flicker in the distance, cinematic, smooth camera movement" }, "parameters": { "resolution": "720P", "ratio": "16:9", "duration": 5 } }' | tee create.json ``` 既存のクリップのスタイルを変えるときは、そのクリップを `reference_video` として渡します。課金される秒数には入力動画も含まれます（上の「課金と料金」を参照）。 ```bash theme={null} curl -sS -X POST "$BASE_URL/wan/api/v1/services/aigc/video-generation/video-synthesis" \ -H "Authorization: Bearer $LAOZHANG_API_KEY" \ -H "Content-Type: application/json" \ -H "X-DashScope-Async: enable" \ --data-raw '{ "model": "wan3.0-video-prime", "input": { "prompt": "Turn the whole scene into claymation", "media": [ { "type": "reference_video", "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260402/ldnfdf/wan2.7-videoedit-style-change.mp4" } ] }, "parameters": { "resolution": "720P", "ratio": "adaptive" } }' | tee create.json ``` これまでと同じく `create.json` から `TASK_ID` を読み取り、次の節のとおりポーリングとダウンロードを行います。ドキュメント（`file`）やWebページ（`link`）などほかの入力については、Alibaba Cloudの[Wan3.0 動画生成APIリファレンス](https://help.aliyun.com/zh/model-studio/wan3-video-generation-api-reference)（中国語）を参照してください。 ## タスクをポーリングして動画をダウンロードする `create.json` からタスクIDを読み取り、タスクを確認します。 ```bash theme={null} TASK_ID=$(jq -r '.output.task_id' create.json) curl -sS "$BASE_URL/v1/tasks/$TASK_ID" \ -H "Authorization: Bearer $LAOZHANG_API_KEY" | tee task.json | jq '{status, progress}' ``` `status` が `submitted` でも `in_progress` でもなくなるまで、5〜10秒おきにこのリクエストを繰り返します。 完了したタスクは次のようになります。判断にはトップレベルの `status` と `result_url` を使ってください。 ```json theme={null} { "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "task_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "object": "task", "platform": "wan", "action": "text_to_video", "task_type": "text_to_video", "status": "completed", "progress": "100%", "result_url": "https://dashscope-xxx.oss-accelerate.aliyuncs.com/...", "result": { "data": { "model": "wan2.7-t2v", "parameters": { "resolution": "720P", "duration": 5, "prompt_extend": true, "watermark": true } } } } ``` 動画は `Authorization` ヘッダーを付けずにダウンロードします。`result_url` は署名付きのオブジェクトストレージURLで、認証ヘッダーを余分に付けると403エラーになることがあります。 ```bash theme={null} RESULT_URL=$(jq -r '.result_url' task.json) curl -L -o wan-output.mp4 "$RESULT_URL" ``` ## Pythonクライアント Pythonの標準ライブラリだけを使うクライアントです（Python 3.8以降）。テキストから動画を生成するタスクを作成し、最大20分ポーリングして、MP4を保存します。 ```python theme={null} import json import os import time import urllib.request from urllib.error import HTTPError BASE_URL = "https://api.laozhang.ai" API_KEY = os.environ["LAOZHANG_API_KEY"] POLL_INTERVAL = 10 # 状態を確認する間隔（秒） TIMEOUT = 20 * 60 # 20分で待機を打ち切る def request(method, path, body=None, extra_headers=None): headers = {"Authorization": f"Bearer {API_KEY}"} if extra_headers: headers.update(extra_headers) data = None if body is not None: headers["Content-Type"] = "application/json" data = json.dumps(body).encode("utf-8") req = urllib.request.Request(BASE_URL + path, data=data, method=method, headers=headers) try: with urllib.request.urlopen(req, timeout=60) as resp: return json.loads(resp.read().decode("utf-8")) except HTTPError as exc: error_body = exc.read().decode("utf-8", errors="replace") raise RuntimeError(f"HTTP {exc.code}: {error_body}") from exc created = request( "POST", "/wan/api/v1/services/aigc/video-generation/video-synthesis", { "model": "wan2.7-t2v", "input": {"prompt": "A lighthouse at sunset, cinematic light, slow push-in"}, "parameters": {"resolution": "720P", "duration": 5, "prompt_extend": True}, }, {"X-DashScope-Async": "enable"}, ) task_id = created["output"]["task_id"] print("タスクID:", task_id) deadline = time.monotonic() + TIMEOUT while True: task = request("GET", f"/v1/tasks/{task_id}") status = str(task.get("status", "")).lower() print("状態:", status, task.get("progress", "")) if status == "completed": # result_url は署名付きURLなので、Authorizationヘッダーを付けずにダウンロードする urllib.request.urlretrieve(task["result_url"], "wan-output.mp4") print("保存しました: wan-output.mp4") break if status not in ("submitted", "in_progress"): # failed またはその他の最終状態 detail = task.get("error") or task.get("fail_reason") or task raise RuntimeError(f"タスク {task_id} は状態 {status!r} で終了しました: {detail}") if time.monotonic() > deadline: raise TimeoutError(f"タスク {task_id} が20分以内に完了しませんでした") time.sleep(POLL_INTERVAL) ``` ## エンドポイントとリクエストの決まり ```text theme={null} タスクの作成 POST /wan/api/v1/services/aigc/video-generation/video-synthesis タスクの状態の取得 GET /v1/tasks/{task_id} MP4のダウンロード GET {result_url} （署名付きURL。Authorizationヘッダーは付けない） ``` | 設定 | 値 | | - | - | | ベースURL | `https://api.laozhang.ai` | | 認証 | `Authorization: Bearer $LAOZHANG_API_KEY` | | 作成リクエストのボディ | `application/json` | | 作成時に必須のヘッダー | `X-DashScope-Async: enable` | | ポーリング間隔 | 5〜10秒 | | クライアントのタイムアウト | 20分 | ## タスクの状態 `GET /v1/tasks/{task_id}` が返すトップレベルの `status` で分岐します。 | 状態 | 最終状態 | 対応 | | - | - | - | | `submitted` | いいえ | タスクが受け付けられた。ポーリングを続ける | | `in_progress` | いいえ | 動画を生成中。ポーリングを続ける | | `completed` | はい | `result_url` からMP4をダウンロードする | | `failed` | はい | `error.message` または `fail_reason` を読み、ポーリングをやめる | | その他の値 | はい | ポーリングをやめ、レスポンス全体を保存する。動画がまだ必要なら新しいタスクを作成する | 作成のレスポンスにも `output.task_status` があります。これはDashScopeの生の状態で、新しいタスクでは通常 `PENDING` です。タスクが受け付けられたことの確認だけに使い、その後は `GET /v1/tasks/{task_id}` のトップレベルの `status` で分岐してください。 ポーリングを続けるのは、状態が `submitted` か `in_progress` の間だけです。タスクがキャンセルされた場合や、24時間を過ぎてから照会した場合など、それ以外の値はすべて最終状態として扱います。こうすれば、想定外の状態でクライアントがポーリングを続けることはありません。 Wanの進捗は大まかです。`progress` がしばらく `30%` のまま止まり、そのあと `100%` に跳ぶことがあります。 ## モデルと入力モード | モデルID | タスク | `input.media[]` | | - | - | - | | `wan2.7-t2v` | テキストから動画 | `media` を省略 | | `wan2.7-i2v` | 画像から動画（音声による駆動も可） | `first_frame` を1つ。`last_frame` と `driving_audio` は任意 | | `wan2.7-r2v` | 参照素材から動画 | `reference_image` と `reference_video` を合計1〜5個 | | `wan2.7-videoedit` | 動画編集 | `video` を1つ（2〜10秒）。`reference_image` は任意で最大4個 | | `wan3.0-video`、`wan3.0-video-prime` | テキスト・画像・参照素材から動画、動画の編集と延長 | タスクによる。上の「Wan 3.0で動画を生成する」を参照 | Wan 2.6のモデル（`wan2.6-t2v`、`wan2.6-i2v`、`wan2.6-r2v`、`wan2.6-r2v-flash`）は、2026年10月14日に提供を終了しました。まだ呼び出している場合は、対応するWan 2.7のモデルかWan 3.0に切り替えてください。 モデルIDは2026年10月14日時点のLaoZhang APIの公開価格に基づきます。`wan2.7-image-pro` は画像モデルなので、この動画エンドポイントでは使えません。 ## リクエストボディ | フィールド | 型 | 必須 | 説明 | | - | - | - | - | | `model` | string | 必須 | モデルID。例：`wan2.7-t2v` | | `input.prompt` | string | モデルによる | 自然言語のプロンプト。テキストから動画と参照素材から動画では必須、画像から動画と動画編集では任意 | | `input.media` | array | モデルによる | テキストから動画では省略し、ほかのタスクでは必須 | | `parameters.resolution` | string | 任意 | Wan 2.7は `720P` または `1080P`。Wan 3.0は `480P` も可。`P` は大文字で書く | | `parameters.duration` | integer | 任意 | 整数の秒数。`wan2.7-t2v` は2〜15。文字列ではなく数値で送る | | `parameters.prompt_extend` | boolean | 任意 | モデルにプロンプトを拡張させる | | `parameters.watermark` | boolean | 任意 | AI生成であることを示すウォーターマークを付ける | | `parameters.seed` | integer | 任意 | 結果の再現性を高めるシード | 使える値はモデルによって異なります。上の範囲は、Alibaba Cloudの[テキストから動画APIリファレンス](https://help.aliyun.com/zh/model-studio/text-to-video-api-reference)によるものです。ほかのモデルは、それぞれのAlibaba Cloudのリファレンス（中国語）を参照してください。 * [Wan 2.7 画像から動画](https://help.aliyun.com/zh/model-studio/image-to-video-general-api-reference) * [Wan 2.7 参照素材から動画](https://help.aliyun.com/zh/model-studio/wan-video-to-video-api-reference) * [Wan 2.7 動画編集](https://help.aliyun.com/zh/model-studio/wan-video-editing-api-reference) * [Wan 3.0 動画生成](https://help.aliyun.com/zh/model-studio/wan3-video-generation-api-reference) ### 素材の入力 | `type` | 用途 | | - | - | | `first_frame` | 画像から動画の先頭フレーム。`wan2.7-r2v` でも1つ使える | | `last_frame` | 末尾フレーム（選んだモデルが対応している場合） | | `reference_image` | 参照素材から動画、または動画編集の参照画像 | | `reference_video` | 参照動画。`wan2.7-r2v` では被写体と声を提供し、Wan 3.0では編集・延長するクリップにもなる | | `reference_audio` | Wan 3.0の参照音声 | | `driving_audio` | `wan2.7-i2v` の画像から動画のタスクを駆動する音声 | | `video` | `wan2.7-videoedit` で編集する元の動画 | | `file`、`link` | Wan 3.0の参照ドキュメント、または公開Webページ。どちらか一方だけを送る | 素材の `url` は、Alibaba Cloudが直接取得できる公開HTTPSリンクでなければなりません。ログインやCookieが必要なリンク、プライベートネットワークのアドレス、タスクの実行前に期限が切れるリンクでは、タスクが失敗することがあります。 ## 本番運用のヒント * **最初にタスクIDを保存する。** 作成の呼び出しが返ったらすぐ、`output.task_id` を自社のジョブIDと一緒に保存します。ワーカーが再起動しても、重複したタスクを作らずにポーリングを再開できます。 * **作成のリトライ前に確認する。** 受け付けられた作成リクエストは、それぞれ別のタスクになります。作成リクエストがタイムアウトしたら、再送する前に自社の記録と呼び出しログを確認します。 * **ポーリングに上限を設ける。** 5〜10秒おきに確認し、20分で打ち切り、`submitted` と `in_progress` 以外の状態はすべて最終状態として扱います。 * **すぐにダウンロードする。** Alibaba CloudはタスクIDと動画URLを24時間保持します。MP4を自社のストレージにコピーし、ユーザーには署名付きリンクではなく自社のURLを渡します。 * **入力に到達できる状態を保つ。** 素材は、タスクが終わるまで公開HTTPSのURLで取得できるようにしておきます。 * **費用を管理する。** `duration` と `resolution` を明示し、各タスクの課金額を呼び出しログで確認します。 * **アプリごとにトークンを分ける。** アプリケーションや環境ごとに専用の `Wan` トークンを使うと、ログと課金の確認が楽になります。 ## トラブルシューティング | 症状 | 考えられる原因 | 対処 | | - | - | - | | `未提供令牌`（トークンなし） | `Authorization` ヘッダーがない | `Authorization: Bearer $LAOZHANG_API_KEY` を送る | | `Current group Wan has no available channels for model ...` | モデルIDの誤り、Wan 2.6などの提供終了モデル、または `Wan` グループでそのモデルが使えない | モデルの表とIDを照合する。正しい場合は、モデルIDとリクエスト時刻を添えて[サポート](mailto:hi@laozhang.ai)に連絡する | | `[InvalidParameter] Field required: input.media` | `media` がない、またはリクエストを `/v1/videos` に送った | Wanのタスクエンドポイントを使い、`input.media[]` を送る | | `任务不存在`（タスクが存在しない） | タスクIDの誤り、またはタスクが24時間より前のもの | `output.task_id` をそのまま使う。期限切れなら新しいタスクを作成する | | ダウンロードで403が返る | `Authorization` ヘッダーを送った、またはURLが24時間より前のもの | `Authorization` を付けずにダウンロードする。URLが期限切れなら新しいタスクを作成する | ## よくある質問 ### 5秒の動画はいくらですか？ 2026年10月14日時点の価格で、動画を出力するだけのタスクの場合です。 * `wan3.0-video`：720Pで約\$0.51、1080Pで約\$1.03 * `wan3.0-video-prime`：720Pで約\$0.77、1080Pで約\$1.54 * Wan 2.7：720Pで約\$0.51、1080Pで約\$0.86 費用は長さに比例するため、10秒ならおよそ2倍です。`resolution` を指定しないと1080Pとして課金され、入力動画があるタスクでは入力の秒数が加わります。詳しくは「課金と料金」を参照してください。 ### `X-DashScope-Async: enable` は必須ですか？ はい。すべての作成リクエストに必要です。WanのHTTP APIは非同期でしか動作せず、このヘッダーのない作成の `POST` は `current user api does not support synchronous calls` で失敗します。 `GET /v1/tasks/{task_id}` でのポーリングと `result_url` のダウンロードには不要です。 ### `resolution` と `duration` を省略すると？ 1080Pで出力されます。Alibaba CloudのAPIリファレンスによると、Wan 2.7の4モデル（`wan2.7-t2v`、`wan2.7-i2v`、`wan2.7-r2v`、`wan2.7-videoedit`）とWan 3.0は、どれも既定値が1080Pです。 * テキストから動画、画像から動画、参照素材から動画は、既定で5秒です。 * Wan 2.7の動画編集は、元の動画の長さを保ちます。 そのため、パラメーターを指定しないテキストから動画のタスクは、1080Pの5秒として課金されます。 * Wan 2.7：約\$0.86 * `wan3.0-video`：約\$1.03 * `wan3.0-video-prime`：約\$1.54 このページの例は `720P` を明示しています。費用を予測しやすくするため、すべてのリクエストで `resolution` と `duration` を指定し、「課金と料金」から価格を見積もってください。 ### 縦長や正方形の動画を作るには？ テキストから動画と参照素材から動画では `parameters.ratio` を指定します。ほかのタスクは入力の形に従います。 * **テキストから動画、参照素材から動画：** 次のいずれかの比率。 * `16:9`（既定値） * `9:16`（たとえば720Pなら720×1280の動画になる） * `1:1` * `4:3` * `3:4` * **画像から動画：** `ratio` は使えず、先頭フレームの形に従います。 * **動画編集：** `ratio` を指定しない限り、元の動画の形を保ちます。 * **Wan 3.0：** 既定値は `adaptive` で入力から比率を決め、`21:9` も指定できます。 料金は解像度の段階と出力の秒数だけで決まるため、同じ段階なら横長、縦長、正方形の動画は同じ料金です。モデルごとに使える値は、Alibaba Cloudの[テキストから動画APIリファレンス](https://help.aliyun.com/zh/model-studio/text-to-video-api-reference)（中国語）を参照してください。 ### 動画の音声と、自分の音声でのリップシンク どちらも可能です。Alibaba Cloudによると、Wan 2.7は既定で音声付きの動画を出力し、映像に合わせたBGM、効果音、声を生成します。 自分の音声に口の動きを合わせるには、`wan2.7-i2v` を使い、上の「画像から動画を生成する」の例のように `input.media[]` に `driving_audio` を追加します。音声はWAVまたはMP3で2〜30秒の長さが必要で、`duration` を超えた部分は切り捨てられます。 Wan 3.0も既定で音声付きです。無音の動画にするには `"audio": false` を送ります。料金は同じです。 参照素材から動画では参照動画の声を再利用でき、動画編集では元の動画の音声を残せます。これらのパラメーターは、[Wan 2.7 参照素材から動画APIリファレンス](https://help.aliyun.com/zh/model-studio/wan-video-to-video-api-reference)と[Wan 2.7 動画編集APIリファレンス](https://help.aliyun.com/zh/model-studio/wan-video-editing-api-reference)（いずれも中国語）を参照してください。 ### 「AI 生成」のウォーターマークを消すには？ `parameters` で `"watermark": false` を送るか、`watermark` を省略します。Alibaba Cloudは既定ではウォーターマークを付けません。このページの例は `true` を送っているため、動画の右下にウォーターマークが入ります。本番で例を使う前に変更してください。 ### タイムアウト後や失敗後に再送できますか？ まずタスクを確認してください。クライアントのタイムアウトは、タスクの失敗を意味しません。新しい作成リクエストは2つ目のタスクになり、再び課金されるため、24時間以内は同じ `task_id` のポーリングを続けます。 新しいタスクを作成するのは、`status` が `failed` などの最終状態になってからにし、先にリクエストを修正してください。失敗したタスクは課金されず、各タスクの実際の課金額は[呼び出しログ](https://api.laozhang.ai/log)で確認できます。詳しくは「課金と料金」と「タスクの状態」を参照してください。 ### 1つのタスクで課金が2行になる理由 タスクの作成時にリクエストした長さの分が課金され、タスクの完了時に精算されるためです。 * Alibaba Cloudが報告した秒数が同じなら、ログの課金は1行です。 * 秒数が異なる場合は、2行目（「Wan 任务完成，按实际时长调整」）で差額が返金または追加課金されます。 よくある原因は入力動画で、その秒数も課金の対象になります。入力動画のあるWan 3.0のタスクは、先に30秒分が課金され、あとで差額が返金されます。タスクの実際の費用は2行の合計です（「課金と料金」を参照）。 ### `progress` が30%のまま止まっていますか？ いいえ。上流のサービスは進捗を大まかな段階で報告するため、`30%` でしばらく止まるのは正常です。トップレベルの `status` が `in_progress` の間は、ポーリングを続けてください（「タスクの状態」を参照）。 ## 関連ドキュメント * [Seedance 2.0 / 2.5](https://docs.laozhang.ai/ja/api-capabilities/seedance2-video-generation.md)：LaoZhang APIのもう1つの動画モデルファミリー * [Sora 2 APIの提供終了：WanまたはSeedanceへの移行](https://docs.laozhang.ai/ja/api-capabilities/sora2/official-forward.md) * [AIモデルのAPI料金一覧](https://docs.laozhang.ai/ja/models.md) * [モデルの利用可否の確認](https://docs.laozhang.ai/en/faq/model-availability.md) * [呼び出しログの確認方法](https://docs.laozhang.ai/en/faq/call-logs.md) * [データとログの取り扱い](https://docs.laozhang.ai/en/faq/data-security.md) * Alibaba Cloud（中国語）：[テキストから動画APIリファレンス](https://help.aliyun.com/zh/model-studio/text-to-video-api-reference)、[Wan 2.7 画像から動画APIリファレンス](https://help.aliyun.com/zh/model-studio/image-to-video-general-api-reference)、[Model Studioの料金](https://help.aliyun.com/zh/model-studio/model-pricing) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.