すべてのプロダクト
Search
ドキュメントセンター

Alibaba Cloud Model Studio:Wanxiang-リファレンス動画 API リファレンス

最終更新日:Mar 28, 2026

Wanxiang-リファレンス動画モデルは、テキスト、画像、動画などのマルチモーダル入力をサポートします。人物または物体を主役とした単一キャラクターのパフォーマンスや、複数キャラクター間のインタラクションを生成できます。また、インテリジェントなシーンセグメンテーション機能により、マルチショット動画の作成も可能です。

関連ドキュメント: ユーザーガイド

適用範囲

API 呼び出しを正常に実行するには、モデル、エンドポイント URL、API キーがすべて同一リージョンに属していることを確認してください。クロスリージョン呼び出しは失敗します。

  • モデルの選択: ご利用のモデルのリージョンを確認します。

  • URL の選択: 対応するリージョンのエンドポイント URL を選択します。HTTP URL をサポートしています。

  • API キーの構成: リージョンを選択し、API キーを取得します。その後、API キーを環境変数として構成します。なお、この方法は非推奨となっており、今後は API キーの構成に統合されます。

説明

このトピックのサンプルコードは、シンガポール リージョンに適用されます。

HTTP 呼び出し

リファレンス動画タスクは処理に時間がかかるため(通常 1~5 分)、API では非同期呼び出しが採用されています。完全なワークフローは、以下の 2 つのコアステップで構成されます:タスクの作成 → 結果のポーリング

ステップ 1:タスクを作成してタスク ID を取得

シンガポール

POST https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis

米国 (バージニア)

POST https://dashscope-us.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis

北京

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis

説明
  • タスク作成後は、返された task_id を使用して結果を照会します。task_id の有効期限は 24 時間です。重複したタスクを作成しないでください。代わりに、ポーリングを使用して結果を取得してください。

  • 初心者向けチュートリアルについては、「Postman または cURL を使用した画像および動画生成 API の呼び出し」をご参照ください。

リクエストパラメーター

複数キャラクター間のインタラクション(リファレンス画像および動画を使用)

reference_urls に画像および動画の URL を渡します。shot_typemulti に設定すると、マルチショット動画が生成されます。

curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "wan2.6-r2v-flash",
    "input": {
        "prompt": "Character2 が窓際の椅子に座り、character3 を抱きかかえ、character4 の隣で心地よいアメリカン・カントリー・フォークソングを演奏します。Character1 が Character2 に向かって「とてもいいですね」と言います。",
        "reference_urls": [
            "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/en-US/20260205/aacgyk/wan-r2v-role1.mp4",
            "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/en-US/20260205/mmizqq/wan-r2v-role2.mp4",
            "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qpzxps/wan-r2v-object4.png",
            "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/wfjikw/wan-r2v-backgroud5.png"
        ]
    },
    "parameters": {
        "size": "1280*720",
        "duration": 10,
        "audio": true,
        "shot_type": "multi",
        "watermark": true
    }
}'

複数キャラクター間のインタラクション(リファレンス動画のみ使用)

reference_urls に複数の動画 URL を渡します。shot_typemulti に設定すると、マルチショット動画が生成されます。

curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "wan2.6-r2v",
    "input": {
        "prompt": "character1 が character2 に向かって「明日の朝はよろしくお願いします!」と言います。character2 は「お任せください!」と返答します。",
        "reference_urls": [
            "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251217/dlrrly/%E5%B0%8F%E5%A5%B3%E5%AD%A91%E8%8B%B1%E6%96%872.mp4",
            "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251217/fkxknn/%E9%93%83%E9%93%83.mp4"
        ]
    },
    "parameters": {
        "size": "1280*720",
        "duration": 10,
        "shot_type": "multi"
    }
}'

単一キャラクターのロールプレイ

reference_urls に 1 つの動画 URL を渡します。shot_typemulti に設定すると、マルチショット動画が生成されます。

# 注:中国 (北京) リージョンのモデルを使用する場合は、URL を以下に置き換えてください:https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "wan2.6-r2v",
    "input": {
        "prompt": "character1 がタピオカティーを飲みながら、音楽に合わせて即興ダンスを踊ります。",
        "reference_urls":["https://cdn.wanxai.com/static/demo-wan26/vace.mp4"]
    },
    "parameters": {
        "size": "1280*720",
        "duration": 5,
        "shot_type":"multi"
    }
}'

無音動画の生成

無音動画の生成をサポートするのは wan2.6-r2v-flash のみです。

無音動画を生成する場合、parameters.audio = false を明示的に設定する必要があります

curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "wan2.6-r2v-flash",
    "input": {
        "prompt": "character1 がタピオカティーを飲みながら、音楽に合わせて即興ダンスを踊ります。",
        "reference_urls":["https://cdn.wanxai.com/static/demo-wan26/vace.mp4"]
    },
    "parameters": {
        "size": "1280*720",
        "duration": 5,
        "audio": false,
        "shot_type":"multi"
    }
}'
リクエストヘッダー

Content-Type 文字列 (必須)

リクエストのコンテンツタイプ。値は必ず application/json である必要があります。

Authorization 文字列 (必須)

Model Studio API キーを使用した認証情報。

例: Bearer sk-xxxx

X-DashScope-Async 文字列 (必須)

非同期処理を有効化します。HTTP リクエストは非同期処理のみをサポートするため、値は必ず enable である必要があります。

重要

このヘッダーが含まれていない場合、「current user api does not support synchronous calls」エラーが返されます。

リクエスト本文

model 文字列 (必須)

モデル名。全モデルの一覧および料金詳細については、「モデル料金」をご参照ください。

例: wan2.6-r2v-flash。

input オブジェクト (必須)

プロンプトなど、基本的な入力情報。

プロパティ

prompt 文字列 (必須)

テキストプロンプト。生成される動画に期待される要素および視覚的特徴を記述します。

中国語および英語をサポートします。各漢字、英字、句読点は 1 文字としてカウントされます。上限を超えた文字は自動的に切り捨てられます。

  • wan2.6-r2v-flash: 最大 1,500 文字。

  • wan2.6-r2v: 最大 1,500 文字。

ロール参照: `character1` や `character2` などの識別子を使用して、リファレンスロールを指定します。各リファレンス(動画または画像)には、1 つのロールのみ含める必要があります。モデルは、これらの特定の識別子のみを通じてロールを認識します。

例: character1 がソファで映画を楽しく観ています。

プロンプト作成のヒントについては、「テキストから動画へ / 画像から動画へ プロンプトガイド」をご参照ください。

negative_prompt 文字列 (任意)

否定的なプロンプト。生成される動画に含めたくない内容を記述し、出力を制限するのに役立ちます。

中国語および英語をサポートし、最大 500 文字です。上限を超えた文字は自動的に切り捨てられます。

例: 低解像度、エラー、最悪の品質、低品質、不完全、余分な指、不適切な比率。

reference_urls 文字列配列 (必須)

重要

`reference_urls` は課金に直接影響します。詳細については、「課金およびレート制限」をご参照ください。

リファレンスファイルを指す URL の配列。動画および画像の両方をサポートします。これらのファイルは、キャラクターの外見および(存在する場合)音声を抽出し、その特徴に一致する動画を生成するために使用されます。

  • 各 URL は 1 つの画像 または 1 つの動画 を指します:

    • 画像は最大 5 枚まで。

    • 動画は最大 3 本まで。

    • 画像および動画の合計数は 5 を超えてはいけません。

  • 複数のリファレンスを指定する場合、配列内の URL の順序がロール順を定義します。最初の URL は `character1` に対応し、2 番目は `character2` に対応し、以降同様です。

  • 各リファレンスファイルには、1 つのメイン被写体のみ含める必要があります。たとえば、`character1` は小さな女の子、`character2` は目覚まし時計です。

サポートされる形式:

  1. 公開 URL:

    • HTTP または HTTPS プロトコルをサポートします。

    • 例: https://cdn.translate.alibaba.com/xxx.png。

リファレンス動画の要件:

  • 形式: MP4、MOV。

  • 再生時間: 1~30 秒。

  • ファイルサイズ: 最大 100 MB。

リファレンス画像の要件:

  • 形式: JPEG、JPG、PNG(alpha チャンネルなし)、BMP、WEBP。

  • 解像度: 幅および高さは 240~8,000 ピクセルの間。

  • ファイルサイズ: 最大 10 MB。

例: ["https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/xxx.mp4", "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/xxx.jpg"]。

非推奨フィールド

reference_video_urls 文字列配列

重要

reference_urls を使用してください。reference_video_urls は使用しないでください。

リファレンス動画ファイルを指す URL の配列。これらのファイルは、キャラクターの外見および(存在する場合)音声を抽出し、その特徴に一致する動画を生成するために使用されます。

  • 動画は最大 3 本まで。

  • 複数の動画を指定する場合、配列内の URL の順序がロール順を定義します。最初の URL は `character1` に対応し、2 番目は `character2` に対応し、以降同様です。

  • 各リファレンス動画には、1 人のキャラクターのみ含める必要があります。たとえば、`character1` は小さな女の子、`character2` は目覚まし時計です。

  • URL には HTTP または HTTPS プロトコルを使用する必要があります。

単一動画の要件:

  • 形式: MP4、MOV。

  • 再生時間: 2~30 秒。

  • ファイルサイズ: 最大 100 MB。

例: ["https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/xxx.mp4"]。

parameters オブジェクト (任意)

解像度設定などの動画処理パラメーター。

プロパティ

size 文字列 (任意)

重要
  • `size` は課金に直接影響します。料金は以下の式で計算されます:単価(解像度に基づく)× 持続時間(秒単位)。同一モデルの場合、1080P の方が 720P より高額です。呼び出しを行う前に、「モデル料金」をご確認ください。

  • `size` には 1280*720 のような具体的な値を設定する必要があります。1:1 のような比率や 720P のようなラベルは使用しないでください。

ターゲット動画の解像度を width*height 形式で指定します。デフォルト値および許容値は、`model` パラメーターによって異なります。

  • wan2.6-r2v-flash: デフォルト値は 1920*1080(1080P)です。720P および 1080P のすべてのオプションがサポートされます。

  • wan2.6-r2v: デフォルト値は 1920*1080(1080P)です。720P および 1080P のすべてのオプションがサポートされます。

720P のオプションおよびその縦横比:

  • 1280*720: 16:9。

  • 720*1280: 9:16。

  • 960*960: 1:1。

  • 1088*832: 4:3。

  • 832*1088: 3:4。

1080P のオプションおよびその縦横比:

  • 1920*1080: 16:9。

  • 1080*1920: 9:16。

  • 1440*1440: 1:1。

  • 1632*1248: 4:3。

  • 1248*1632: 3:4。

duration 整数 (任意)

重要

`duration` は課金に直接影響します。料金は以下の式で計算されます:単価(解像度に基づく)× 持続時間(秒単位)。呼び出しを行う前に、「モデル料金」をご確認ください。

ターゲット動画の持続時間(秒単位)。

  • wan2.6-r2v-flash: 2~10 の整数。デフォルト値は 5 です。

  • wan2.6-r2v: 2~10 の整数。デフォルト値は 5 です。

例: 5。

shot_type 文字列 (任意)

生成される動画のショットタイプを指定します。単一の連続ショットまたは複数の切り替えショットのいずれかを選択できます。

パラメーター優先度: `shot_type` > `prompt`。たとえば、`shot_type` を single に設定した場合、プロンプトに「マルチショット動画を生成」と記述されていても、モデルは単一ショット動画を出力します。

有効な値:

  • `single`: デフォルト値。単一ショット動画を出力します。

  • `multi`: マルチショット動画を出力します。

例: single。

説明

このパラメーターを使用して、ナラティブ構造を厳密に制御できます。たとえば、製品デモには単一ショットを、ストーリーショートには複数ショットを使用できます。

audio ブール値 (任意)

重要

`audio` は課金に直接影響します。音声付き動画と無音動画の価格は異なります。呼び出しを行う前に、「モデル料金」をご確認ください。

対応モデル: wan2.6-r2v-flash。

音声付き動画を生成するかどうかを指定します。

有効な値:

  • `true`: デフォルト値。音声付き動画を出力します。

  • `false`: 無音動画を出力します。

例: true。

watermark ブール値 (任意)

動画の右下隅にウォーターマークを追加するかどうかを指定します。ウォーターマークのテキストは「AI Generated」です。

  • `false`: デフォルト値。ウォーターマークは追加されません。

  • `true`: ウォーターマークが追加されます。

例: false。

seed 整数 (任意)

乱数シード。値は 0 から 2147483647 の間の整数である必要があります。

指定しない場合、ランダムなシードが生成されます。固定シードを使用すると再現性が向上しますが、モデルのランダム性により結果が異なる場合もあります。

例: 12345

レスポンスパラメーター

成功時のレスポンス

task_id を保存し、タスクのステータスおよび結果を照会します。

{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

エラー時のレスポンス

タスク作成に失敗しました。問題を解決するには、「エラーコード」をご参照ください。

{
    "code": "InvalidApiKey",
    "message": "API キーが提供されていません。",
    "request_id": "7438d53d-6eb8-4596-8835-xxxxxx"
}

output オブジェクト

タスクの出力情報。

プロパティ

task_id 文字列

タスク ID。最大 24 時間、タスクの照会に使用できます。

task_status 文字列

タスクのステータス。

列挙値

  • PENDING

  • RUNNING

  • SUCCEEDED

  • FAILED

  • CANCELED

  • UNKNOWN: タスクが存在しないか、ステータスが不明です

request_id 文字列

リクエストの固有識別子。トレースおよびトラブルシューティングに使用します。

code 文字列

エラーコード。リクエストが失敗した場合にのみ返されます。「エラーコード」をご参照ください。

message 文字列

詳細なエラーメッセージ。リクエストが失敗した場合にのみ返されます。「エラーコード」をご参照ください。

ステップ 2:タスク ID を使用して結果を照会

シンガポール

GET https://dashscope-intl.aliyuncs.com/api/v1/tasks/{task_id}

バージニア

GET https://dashscope-us.aliyuncs.com/api/v1/tasks/{task_id}

北京

GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

説明
  • ポーリングの推奨: 動画生成には数分かかることがあります。結果を取得するには、15 秒などの適切な照会間隔でポーリング機構を使用してください。

  • タスクステータスの遷移: PENDING → RUNNING → SUCCEEDED または FAILED。

  • [結果 URL]: タスクが成功すると、ビデオの URL が返されます。この URL は 24 時間 有効です。URL を取得した後は、ただちにビデオをダウンロードして、Object Storage Service (OSS) などの永続的なストレージサービスに保存する必要があります。

  • task_id の有効期限: 24 時間。この期間を過ぎると、結果を照会できなくなり、API は UNKNOWN ステータスを返します。

リクエストパラメーター

タスク結果の照会

{task_id} を、前の API 呼び出しで返された task_id の値に置き換えます。task_id は、24 時間以内の照会に有効です。

curl -X GET https://dashscope-intl.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"
リクエストヘッダー

Authorization 文字列 (必須)

Model Studio API キーを使用した認証情報。

例: Bearer sk-xxxx

URL パスパラメーター

task_id 文字列 (必須)

照会対象のタスク ID。

レスポンスパラメーター

タスク成功時

動画 URL は 24 時間のみ保持され、その後自動的にパージされます。生成された動画は速やかに保存してください。

{
    "request_id": "caa62a12-8841-41a6-8af2-xxxxxx",
    "output": {
        "task_id": "eff1443c-ccab-4676-aad3-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-12-16 00:25:59.869",
        "scheduled_time": "2025-12-16 00:25:59.900",
        "end_time": "2025-12-16 00:30:35.396",
        "orig_prompt": "character1 がソファで映画を楽しく観ています",
        "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx"
    },
     "usage": {
        "duration": 10.0,
        "size": "1280*720",
        "input_video_duration": 5,
        "output_video_duration": 5,
        "video_count": 1,
        "SR": 720
    }
}

タスク失敗時

タスクが失敗した場合、task_status は FAILED に設定され、エラーコードおよびメッセージが付与されます。「エラーコード」をご参照ください。

{
    "request_id": "e5d70b02-ebd3-98ce-9fe8-759d7d7b107d",
    "output": {
        "task_id": "86ecf553-d340-4e21-af6e-a0c6a421c010",
        "task_status": "FAILED",
        "code": "InvalidParameter",
        "message": "サイズが一致しません xxxxxx"
    }
}

タスク照会の有効期限切れ

task_id の有効期限は 24 時間です。この期間を過ぎると、照会は失敗し、以下のエラーメッセージが返されます。

{
    "request_id": "a4de7c32-7057-9f82-8581-xxxxxx",
    "output": {
        "task_id": "502a00b1-19d9-4839-a82f-xxxxxx",
        "task_status": "UNKNOWN"
    }
}

output オブジェクト

タスク出力情報。

プロパティ

task_id 文字列 (必須)

照会対象のタスク ID。

task_status 文字列

タスクステータス。

列挙値

  • PENDING

  • RUNNING

  • SUCCEEDED

  • FAILED

  • CANCELED

  • UNKNOWN: タスクが存在しないか、ステータスが不明です

submit_time 文字列

タスクの送信時刻。時刻は UTC + 08:00 です。形式: YYYY-MM-DD HH:mm:ss.SSS

scheduled_time 文字列

タスクの実行開始時刻。時刻は UTC + 08:00 です。形式: YYYY-MM-DD HH:mm:ss.SSS

end_time 文字列

タスクの完了時刻。時刻は UTC + 08:00 です。形式: YYYY-MM-DD HH:mm:ss.SSS

video_url 文字列

生成された動画の URL。task_status が SUCCEEDED の場合にのみ返されます。

URL の有効期限は 24 時間です。H.264 エンコーディングの MP4 形式で動画をダウンロードするために使用します。

orig_prompt 文字列

元の入力プロンプト。これは prompt リクエストパラメーターの値です。

code 文字列

エラーコード。リクエストが失敗した場合にのみ返されます。「エラーコード」をご参照ください。

message 文字列

詳細なエラーメッセージ。リクエストが失敗した場合にのみ返されます。「エラーコード」をご参照ください。

usage オブジェクト

使用量統計。これらは成功した結果に対してのみカウントされます。

プロパティ

input_video_duration 整数

入力リファレンス動画の持続時間(秒単位)。

output_video_duration 整数

出力動画の持続時間(秒単位)。

duration 浮動小数点数

総動画持続時間。これは課金に使用されます。

計算式: duration = input_video_duration + output_video_duration

SR 整数

生成された動画の解像度レベル。例: `720`。

size文字列

生成された動画の解像度。形式は `width*height` です。例: `1280*720`。

video_count 整数

生成された動画の数。値は固定で 1 です。

request_id 文字列

リクエストの固有識別子。トレースおよびトラブルシューティングに使用します。

制限事項

  • データの有効期限: task_id および video_url は、どちらも 24 時間後に有効期限切れになります。有効期限が切れた後は、照会およびダウンロードができなくなります。

  • コンテンツモデレーション: 入力プロンプトおよび出力動画はコンテンツモデレーションを経ます。禁止されているコンテンツを含むリクエストは、`IPInfringementSuspect` や `DataInspectionFailed` などのエラーを返します。詳細については、「エラー情報」をご参照ください。

エラーコード

モデル呼び出しが失敗してエラーメッセージが返された場合、「エラーメッセージ」をご参照ください。

よくある質問

Q: 動画ストレージへのアクセスに必要なドメイン名のホワイトリストをどのように取得できますか?

A: モデルによって生成された動画は OSS に保存されます。API は一時的な公開 URL を返します。このダウンロード URL のファイアウォールホワイトリストを構成するには、以下の点にご注意ください:基盤となるストレージは動的に変更される可能性があります。このトピックでは、古くなった情報によるアクセス障害を防ぐため、固定の OSS ドメイン名ホワイトリストを提供していません。セキュリティ制御の要件がある場合は、アカウントマネージャーにお問い合わせいただき、最新の OSS ドメイン名リストを取得してください。