Wan リファレンス動画モデルは マルチモーダル入力 を受け取り、人物または物体を主人公として単一キャラクターまたは複数キャラクターのインタラクション動画を生成します。
関連情報: ユーザーガイド
利用可能なリージョン
モデル、エンドポイント URL、API キーはすべて同一リージョンに属している必要があります。リージョンをまたいだ呼び出しは失敗します。
-
モデルの選択: モデルが配置されているリージョンを確認します。
-
URL の選択: 対応するリージョンのエンドポイント URL を使用します。HTTP URL がサポートされています。
-
API キーの設定: リージョンを選択し、API キーを作成してから、API キーを環境変数としてエクスポートします。
このトピックのサンプルコードは シンガポールリージョン に適用されます。
シンガポールリージョン向けのレガシードメイン https://dashscope-intl.aliyuncs.com はまもなく非推奨になります。できるだけ早く新しいドメイン https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com に移行してください。
HTTP
これは レガシー API であり、wan2.6 モデル のみをサポートしています。
動画生成タスクには通常 1~5 分かかります。この API は非同期呼び出しを使用し、「タスク作成 → 結果のポーリング」 の 2 ステップで構成されています。詳細は以下のとおりです。
ステップ 1: タスクの作成
シンガポール
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
呼び出す際は、WorkspaceId を実際のワークスペース ID に置き換えてください。
米国 (バージニア)
POST https://dashscope-us.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
Frankfurt
POST https://{WorkspaceId}.eu-central-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
WorkspaceId をご利用のワークスペース ID に置き換えてください。
中国 (北京)
POST https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
-
タスク作成後、返された
task_idを使用して結果を照会します。task_idの有効期間は 24 時間です。重複したタスクを作成しないでください。代わりにポーリングを使用して結果を取得してください。 -
初心者向けのガイドについては、「Postman」をご参照ください。
リクエストパラメーター |
複数キャラクターのインタラクション(リファレンス画像および動画)
複数キャラクターのインタラクション(リファレンス動画)
単一キャラクター
音声なし動画の生成
音声なし動画を生成するには、明示的に
|
ヘッダー |
|
|
Content-Type リクエストのコンテンツタイプです。必ず |
|
|
Authorization Model Studio API キーを使用してリクエストを認証します。例: Bearer sk-xxxx。 |
|
|
X-DashScope-Async 非同期処理を有効にします。HTTP リクエストでは非同期呼び出しのみがサポートされています。必ず 重要
このリクエストヘッダーが指定されていない場合、「current user api does not support synchronous calls」というエラーが返されます。 |
|
リクエスト本文 |
|
|
model 使用するモデルです。利用可能なモデルと料金については、「モデルの料金」をご参照ください。 例: wan2.6-r2v-flash。 |
|
|
input プロンプトなどの入力パラメーターです。 |
|
|
parameters 解像度、プロンプトリライト、ウォーターマークなどの動画生成パラメーターです。 |
レスポンスパラメーター |
成功時のレスポンス
エラー時のレスポンスタスクの作成に失敗しました。「エラーコード」をご参照ください。
|
|
output タスクの出力です。 |
|
|
request_id トレースおよびトラブルシューティング用の一意のリクエスト識別子です。 |
|
|
code エラーコードです。失敗したリクエストでのみ返されます。「エラーコード」をご参照ください。 |
|
|
message 詳細なエラーメッセージです。失敗したリクエストでのみ返されます。「エラーコード」をご参照ください。 |
ステップ 2: タスク結果の取得
シンガポール
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}
呼び出す際は、WorkspaceId を実際のワークスペース ID に置き換えてください。
米国 (バージニア)
GET https://dashscope-us.aliyuncs.com/api/v1/tasks/{task_id}
フランクフルト
GET https://{WorkspaceId}.eu-central-1.maas.aliyuncs.com/api/v1/tasks/{task_id}
WorkspaceId をご利用のワークスペース ID に置き換えてください。
中国 (北京)
GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}
-
ポーリングの推奨: 動画生成には数分かかります。15 秒などの適切な間隔でポーリングメカニズムを使用してください。
-
タスクの状態遷移: PENDING → RUNNING → SUCCEEDED または FAILED。
-
結果リンク: タスクが成功すると、24 時間 有効な動画 URL が返されます。動画をダウンロードして、OSS などの永続ストレージに保存してください。
-
task_idの有効期間: 24 時間。この期間を過ぎると、照会時にタスクステータスがUNKNOWNとして返されます。
リクエストパラメーター |
タスク結果の取得
|
ヘッダー |
|
|
Authorization Model Studio API キーを使用してリクエストを認証します。例: Bearer sk-xxxx。 |
|
パスパラメーター |
|
|
task_id タスクの ID です。 |
レスポンスパラメーター |
タスク成功動画 URL の有効期間は 24 時間のみで、その後自動的に消去されます。生成された動画は速やかに保存してください。
タスク失敗タスクが失敗すると、
タスク期限切れ
|
|
output タスクの出力です。 |
|
|
usage 使用量統計です。成功した結果のみをカウントします。 |
|
|
request_id トレースおよびトラブルシューティング用の一意のリクエスト識別子です。 |
DashScope SDK
SDK パラメーターは HTTP API と同じ命名規則に従い、言語固有のラッパーが提供されています。
リファレンス動画タスクには通常 1~5 分かかります。SDK は HTTP 非同期ワークフローをラップし、同期および非同期の両方の呼び出しをサポートしています。
実際の処理時間は、タスクキューおよびサーバー負荷によって異なります。
Python
以下のコードを実行する前に、DashScope Python SDK のバージョンが 1.25.16 以上であることを確認してください。
SDK のバージョンが古いと、「url error, please check url!」などのエラーが発生する可能性があります。「SDK のインストール」を参照して更新してください。
base_http_api_url は、モデルのリージョンに基づいて設定します:
シンガポール
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'
呼び出す際は、WorkspaceId を実際のワークスペース ID に置き換えてください。
中国 (北京)
dashscope.base_http_api_url = 'https://dashscope.aliyuncs.com/api/v1'
フランクフルト
dashscope.base_http_api_url = 'https://{WorkspaceId}.eu-central-1.maas.aliyuncs.com/api/v1'
WorkspaceId をご利用のワークスペース ID に置き換えてください。
同期
同期呼び出しは、動画生成が完了して結果が返されるまでブロッキングされます。
リクエスト例
from http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
import os
# シンガポールリージョンの URL です。ご利用のリージョンの URL を使用してください。
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'
# DASHSCOPE_API_KEY が設定されていない場合は、次の行を api_key="sk-xxx" に置き換えてください
# API キーはリージョン固有です。API キーの取得: https://www.alibabacloud.com/help/en/model-studio/get-api-key
api_key = os.getenv("DASHSCOPE_API_KEY")
def sample_sync_call_r2v():
# 同期呼び出し: 結果が準備できるまでブロッキングされます
print('please wait...')
rsp = VideoSynthesis.call(
api_key=api_key,
model='wan2.6-r2v-flash',
prompt='Character2 sits in a chair by the window, holding character3, playing a soothing American country folk song next to character4. Character1 says to Character2: “that sounds great”',
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"
],
shot_type='multi',
audio=True,
size='1280*720',
duration=10,
watermark=True)
print(rsp)
if rsp.status_code == HTTPStatus.OK:
print(rsp.output.video_url)
else:
print('Failed, status_code: %s, code: %s, message: %s' %
(rsp.status_code, rsp.code, rsp.message))
if __name__ == '__main__':
sample_sync_call_r2v()
非同期
非同期呼び出しはすぐにタスク ID を返します。タスクが完了するまでポーリングまたは待機する必要があります。
リクエスト例
import os
from http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
# シンガポールリージョンの URL です。ご利用のリージョンの URL を使用してください。
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'
# DASHSCOPE_API_KEY が設定されていない場合は、次の行を api_key="sk-xxx" に置き換えてください
# API キーはリージョン固有です。API キーの取得: https://www.alibabacloud.com/help/en/model-studio/get-api-key
api_key = os.getenv("DASHSCOPE_API_KEY")
def sample_async_call_r2v_26():
# 非同期呼び出し: task_id を返します
rsp = VideoSynthesis.async_call(
api_key=api_key,
model='wan2.6-r2v-flash',
prompt='Character2 sits in a chair by the window, holding character3, playing a soothing American country folk song next to character4. Character1 says to Character2: “that sounds great”',
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"
],
shot_type='multi',
audio=True,
size='1280*720',
duration=10,
watermark=True)
print(rsp)
if rsp.status_code == HTTPStatus.OK:
print("task_id: %s" % rsp.output.task_id)
else:
print('Failed, status_code: %s, code: %s, message: %s' %
(rsp.status_code, rsp.code, rsp.message))
# タスクステータスを取得
status = VideoSynthesis.fetch(task=rsp, api_key=api_key)
if status.status_code == HTTPStatus.OK:
print(status.output.task_status)
else:
print('Failed, status_code: %s, code: %s, message: %s' %
(status.status_code, status.code, status.message))
# タスクが完了するまで待機
rsp = VideoSynthesis.wait(task=rsp, api_key=api_key)
print(rsp)
if rsp.status_code == HTTPStatus.OK:
print(rsp.output.video_url)
else:
print('Failed, status_code: %s, code: %s, message: %s' %
(rsp.status_code, rsp.code, rsp.message))
if __name__ == '__main__':
sample_async_call_r2v_26()
Java
以下のコードを実行する前に、DashScope Java SDK のバージョンが 2.22.14 以上であることを確認してください。
SDK のバージョンが古いと、「url error, please check url!」などのエラーが発生する可能性があります。「SDK のインストール」を参照して更新してください。
baseHttpApiUrl は、モデルのリージョンに基づいて設定します:
シンガポール
Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
呼び出す際は、WorkspaceId を実際のワークスペース ID に置き換えてください。
中国 (北京)
Constants.baseHttpApiUrl = "https://dashscope.aliyuncs.com/api/v1";
Frankfurt
Constants.baseHttpApiUrl = "https://{WorkspaceId}.eu-central-1.maas.aliyuncs.com/api/v1";
WorkspaceId をご利用のワークスペース ID に置き換えてください。
同期
同期呼び出しは、動画生成が完了して結果が返されるまでブロッキングされます。
リクエスト例
// Copyright (c) Alibaba, Inc. and its affiliates.
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesis;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisParam;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisResult;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.JsonUtils;
import com.alibaba.dashscope.utils.Constants;
import java.util.ArrayList;
import java.util.List;
public class Ref2Video26 {
static {
// シンガポールリージョンの URL です。ご利用のリージョンの URL を使用してください。
Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
}
// DASHSCOPE_API_KEY が設定されていない場合は、次の行を apiKey="sk-xxx" に置き換えてください
// API キーはリージョン固有です。API キーの取得: https://www.alibabacloud.com/help/en/model-studio/get-api-key
public static String apiKey = System.getenv("DASHSCOPE_API_KEY");
public static void ref2video26() throws ApiException, NoApiKeyException, InputRequiredException {
VideoSynthesis vs = new VideoSynthesis();
List<String> referenceUrls = new ArrayList<>();
referenceUrls.add("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/en-US/20260205/aacgyk/wan-r2v-role1.mp4");
referenceUrls.add("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/en-US/20260205/mmizqq/wan-r2v-role2.mp4");
referenceUrls.add("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qpzxps/wan-r2v-object4.png");
referenceUrls.add("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/wfjikw/wan-r2v-backgroud5.png");
VideoSynthesisParam param =
VideoSynthesisParam.builder()
.apiKey(apiKey)
.model("wan2.6-r2v-flash")
.prompt("Character2 sits in a chair by the window, holding character3, playing a soothing American country folk song next to character4. Character1 says to Character2: “that sounds great”")
.referenceUrls(referenceUrls)
.shotType(VideoSynthesis.ShotType.MULTI)
.audio(Boolean.TRUE)
.size("1280*720")
.duration(10)
.watermark(Boolean.TRUE)
.build();
System.out.println("please wait...");
VideoSynthesisResult result = vs.call(param);
System.out.println(JsonUtils.toJson(result));
}
public static void main(String[] args) {
try {
ref2video26();
} catch (ApiException | NoApiKeyException | InputRequiredException e) {
System.out.println(e.getMessage());
}
System.exit(0);
}
}
非同期
非同期呼び出しはすぐにタスク ID を返します。タスクが完了するまでポーリングまたは待機する必要があります。
リクエスト例
// Copyright (c) Alibaba, Inc. and its affiliates.
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesis;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisListResult;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisParam;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisResult;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.task.AsyncTaskListParam;
import com.alibaba.dashscope.utils.JsonUtils;
import com.alibaba.dashscope.utils.Constants;
import java.util.ArrayList;
import java.util.List;
public class Ref2Video26Async {
static {
// シンガポールリージョンの URL です。ご利用のリージョンの URL を使用してください。
Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
}
// DASHSCOPE_API_KEY が設定されていない場合は、次の行を apiKey="sk-xxx" に置き換えてください
// API キーはリージョン固有です。API キーの取得: https://www.alibabacloud.com/help/en/model-studio/get-api-key
public static String apiKey = System.getenv("DASHSCOPE_API_KEY");
public static void asyncRef2video26() throws ApiException, NoApiKeyException, InputRequiredException, InterruptedException {
VideoSynthesis vs = new VideoSynthesis();
List<String> referenceUrls = new ArrayList<>();
referenceUrls.add("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/en-US/20260205/aacgyk/wan-r2v-role1.mp4");
referenceUrls.add("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/en-US/20260205/mmizqq/wan-r2v-role2.mp4");
referenceUrls.add("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qpzxps/wan-r2v-object4.png");
referenceUrls.add("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/wfjikw/wan-r2v-backgroud5.png");
VideoSynthesisParam param =
VideoSynthesisParam.builder()
.apiKey(apiKey)
.model("wan2.6-r2v-flash")
.prompt("Character2 sits in a chair by the window, holding character3, playing a soothing American country folk song next to character4. Character1 says to Character2: “that sounds great”")
.referenceUrls(referenceUrls)
.shotType(VideoSynthesis.ShotType.MULTI)
.audio(Boolean.TRUE)
.size("1280*720")
.duration(10)
.watermark(Boolean.TRUE)
.build();
// 非同期タスクを送信
VideoSynthesisResult result = vs.asyncCall(param);
System.out.println("task_id: " + result.getOutput().getTaskId());
System.out.println(JsonUtils.toJson(result));
// タスクが完了するまで待機
result = vs.wait(result, null);
System.out.println(JsonUtils.toJson(result));
}
public static void main(String[] args) {
try {
asyncRef2video26();
} catch (ApiException | NoApiKeyException | InputRequiredException | InterruptedException e) {
System.out.println(e.getMessage());
}
System.exit(0);
}
}
エラーコード
モデルの呼び出しに失敗してエラーメッセージが返された場合は、「エラーコード」を参照して解決してください。