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

Alibaba Cloud Model Studio:Wan - reference-to-video API リファレンス

最終更新日:Feb 13, 2026

`Wan - reference-to-video` モデルは、テキスト、画像、動画などのマルチモーダル入力に対応しており、1 人または複数のキャラクターが登場する動画を生成します。シングルキャラクターのパフォーマンスや、複数キャラクターがインタラクションするシーンの生成が可能です。また、マルチショット動画のインテリジェントなショット分割もサポートしています。

リファレンスユーザーガイド

利用可能リージョン

API 呼び出しを正常に実行するには、モデル、エンドポイント URL、API キーが同じリージョンに属している必要があります。リージョンをまたいだ呼び出しは失敗します。

  • モデルの選択:対象リージョンでモデルが利用可能であることを確認します。

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

  • API キーの設定:リージョンを選択し、API キーを取得して、環境変数に設定します。

説明

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

HTTP

`reference-to-video` タスクは時間がかかるため (通常 1~5 分)、API は「タスクの作成 → 結果のポーリング」の 2 つのステップからなる非同期呼び出しを使用します。

ステップ 1:タスクの作成

シンガポール

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」をご参照ください。

リクエストパラメーター

複数キャラクターのインタラクション (参照画像と動画)

マルチショット動画を生成するには、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": "キャラクター2が窓際の椅子に座り、キャラクター3を抱き、キャラクター4の隣で心地よいアメリカンカントリーフォークソングを演奏しています。キャラクター1がキャラクター2に「いいね」と言います。",
        "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
    }
}'

複数キャラクターのインタラクション (参照動画)

複数の動画 URL を reference_urls に指定し、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 says to character2: “I’ll rely on you tomorrow morning!” character2 replies: “You can count on me!”",
        "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"
    }
}'

単一文字ロールの仮定

単一の動画URLを reference_urls に指定し、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 drinks bubble tea while dancing impromptu to the music.",
        "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 drinks bubble tea while dancing impromptu to the music.",
        "reference_urls":["https://cdn.wanxai.com/static/demo-wan26/vace.mp4"]
    },
    "parameters": {
        "size": "1280*720",
        "duration": 5,
        "audio": false,
        "shot_type":"multi"
    }
}'
リクエストヘッダー

Content-Type string (必須)

リクエストのコンテンツ タイプ。application/json でなければなりません。

Authorization string (必須)

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

例:Bearer sk-xxxx

X-DashScope-Async string (必須)

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

重要

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

リクエストボディ

model string (必須)

モデル名です。モデルのリストとその料金については、「モデルの料金」をご参照ください。

例:wan2.6-r2v-flash

input object (必須)

プロンプトを含む基本的な入力情報です。

プロパティ

prompt string (必須)

生成される動画の要素と視覚的特徴を記述するテキストプロンプトです。

中国語と英語をサポートしています。各文字、アルファベット、句読点は 1 文字としてカウントされます。制限を超えたテキストは自動的に切り捨てられます。

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

  • wan2.6-r2v:最大長は 1,500 文字です。

キャラクター参照の指示:リファレンスファイル内のキャラクターを参照するには、「character1」や「character2」などの識別子を使用します。各リファレンスファイル (動画または画像) には、キャラクターを 1 つだけ含める必要があります。

例: キャラクター1はソファで楽しそうに映画を見ています。

プロンプトの使用方法については、「Text-to-Video/Image-to-Video プロンプトガイド」をご参照ください。

negative_prompt string (任意)

動画フレーム内の不要なコンテンツを記述して、出力を制約します。

中国語と英語をサポートしています。最大 500 文字です。制限を超えたテキストは自動的に切り捨てられます。

例:low resolution, error, worst quality, low quality, deformed, extra fingers, bad proportions

reference_urls array[string] (必須)

重要

`reference_urls` パラメーターは課金に直接影響します。課金ルールについては、「課金とレート制限」をご参照ください。

アップロードされたリファレンスファイル (動画および画像) の URL の配列です。キャラクターの外見と音声を抽出し、リファレンスの特徴に一致する動画を生成するために使用されます。

  • 各 URL は画像 1 枚または動画 1 本を指すことができます。

    • 画像数:0~5 枚

    • 動画数:0~3 本

    • 合計制限:画像 + 動画 ≤ 5

  • 複数のリファレンスファイルを提供する場合、その順序がキャラクターの順序を定義します。最初の URL が character1 に、2 番目の URL が character2 に対応し、以下同様です。

  • 各リファレンスファイルには、主要なキャラクターを 1 つだけ含める必要があります。例えば、character1 は少女、character2 は目覚まし時計です。

サポートされているフォーマット:

  1. パブリックネットワーク URL:

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

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

参照動画の要件:

  • フォーマット:MP4、MOV

  • 時間:1~30 秒

  • 動画サイズ:最大 100 MB

参照画像の要件:

  • フォーマット:JPEG、JPG、PNG (アルファチャンネルは非対応)、BMP、WEBP

  • 解像度:幅と高さの両方が 240~5,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 array[string]

重要

reference_video_urls ではなく、reference_urls の使用を推奨します。

アップロードされた参照動画の URL の配列です。キャラクターの外見と音声を抽出し、参照の特徴に一致する動画を生成するために使用されます。

  • 最大 3 本の動画がサポートされています。

  • 複数の動画を提供する場合、その順序がキャラクターの順序を定義します。最初の URL が character1 に、2 番目の URL が 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 object (任意)

動画の解像度、プロンプトの再書き込み、ウォーターマークのパラメーターです。

プロパティ

size string (任意)

重要
  • `size` パラメーターは課金に直接影響します。コスト = 単価 (解像度別) × 時間 (秒)。同じモデルの場合、1080P は 720P よりも高価です。API を呼び出す前に、モデルの料金を確認してください。

  • サイズは、1280*720 などの特定の値である必要があります。1:1 などの比率や、720P などのレベルではありません。

動画の解像度は、width*height フォーマットで指定します。デフォルト値および利用可能な値は、モデルによって異なります。

  • 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 integer (任意)

重要

`duration` パラメーターは課金に直接影響します。コスト = 単価 (解像度別) × 時間 (秒)。API を呼び出す前に、モデルの料金を確認してください。

動画の長さを秒単位で指定します。

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

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

例:5

shot_type string (任意)

ショットの種類:単一の連続したショットか、複数の変化するショットか。

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

任意の値:

  • single (デフォルト)

  • multi

例:single

説明

このパラメーターを使用して、動画の物語構造を厳密に制御します。例えば、製品ショーケースにはシングルショット、ショートストーリーにはマルチショットシーケンスなどです。

audio boolean (任意)

重要

`audio` パラメーターは課金に直接影響します。音声ありと音声なしの動画では料金が異なります。API を呼び出す前に、モデルの料金を確認してください。

サポートされているモデル:wan2.6-r2v-flash

音声付きの動画を生成するかどうか。

任意の値:

  • true (デフォルト)

  • false

例:true

watermark boolean (任意)

ウォーターマーク (右下に「AI Generated」) を追加するかどうか。

  • false (デフォルト)

  • true

例:false

seed integer (任意)

乱数シードです。 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": "No API-key provided.",
    "request_id": "7438d53d-6eb8-4596-8835-xxxxxx"
}

output object

タスクの出力です。

プロパティ

task_id string

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

task_status string

タスクのステータスです。

列挙

  • PENDING

  • RUNNING

  • SUCCEEDED

  • FAILED

  • CANCELED

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

request_id string

リクエストの一意の識別子です。問題の追跡とトラブルシューティングに使用します。

code string

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

message string

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

ステップ 2:結果のクエリ

シンガポール

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 の値で置き換えます。

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

Authorization string (必須)

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

例:Bearer sk-xxxx

URL パスパラメーター

task_id string (必須)

クエリ対象のタスクの 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 is happily watching a movie on the sofa",
        "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": "The size is not match xxxxxx"
    }
}

タスククエリの期限切れ

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

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

output object

タスクの出力です。

プロパティ

task_id string (必須)

クエリ対象のタスクの ID です。

task_status string

タスクのステータスです。

列挙

  • PENDING

  • RUNNING

  • SUCCEEDED

  • FAILED

  • CANCELED

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

submit_time string

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

scheduled_time string

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

end_time string

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

video_url string

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

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

orig_prompt string

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

code string

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

message string

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

usage object

出力統計です。成功したタスクに対してのみカウントされます。

プロパティ

input_video_duration integer

入力参照動画の長さを秒単位で示します。

output_video_duration integer

出力動画の長さを秒単位で示します。

duration float

合計動画時間です。課金はこの時間に基づきます。

計算式:duration = input_video_duration + output_video_duration

SR integer

生成された動画の解像度ティアです。例:720

sizestring

生成された動画の解像度を "width*height" 形式で示します。例:1280*720

video_count integer

生成された動画の数です。1 に固定されています。

request_id string

リクエストの一意の識別子です。問題の追跡とトラブルシューティングに使用します。

制限事項

  • データの有効性: task_id および動画 video_url は 24 時間のみ保持されます。有効期限が切れると、クエリもダウンロードもできません。

  • コンテンツモデレーション:入力プロンプトと出力動画の両方がコンテンツモデレーションの対象となります。非準拠のコンテンツを含むリクエストは、`IPInfringementSuspect` または `DataInspectionFailed` エラーを返します。詳細については、「エラーメッセージ」をご参照ください。

  • ネットワークアクセス設定:動画リンクは Object Storage Service (OSS) に保存されます。セキュリティポリシーにより、ご利用のシステムが外部の OSS リンクにアクセスできない場合は、次の OSS ドメインをネットワークアクセスのホワイトリストに追加してください。

    # OSS ドメイン名リスト
    dashscope-result-bj.oss-cn-beijing.aliyuncs.com
    dashscope-result-hz.oss-cn-hangzhou.aliyuncs.com
    dashscope-result-sh.oss-cn-shanghai.aliyuncs.com
    dashscope-result-wlcb.oss-cn-wulanchabu.aliyuncs.com
    dashscope-result-zjk.oss-cn-zhangjiakou.aliyuncs.com
    dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com
    dashscope-result-hy.oss-cn-heyuan.aliyuncs.com
    dashscope-result-cd.oss-cn-chengdu.aliyuncs.com
    dashscope-result-gz.oss-cn-guangzhou.aliyuncs.com
    dashscope-result-wlcb-acdr-1.oss-cn-wulanchabu-acdr-1.aliyuncs.com

エラーコード

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