All Products
Search

This Product

    Alibaba Cloud Model Studio:Wan - reference-to-video (2.6)

    Document Center

    Alibaba Cloud Model Studio:Wan - reference-to-video (2.6)

    Last Updated:Oct 27, 2026

    The Wan reference-to-video model accepts multimodal input and generates single-character or multi-character interaction videos using people or objects as protagonists.

    See also: User guide

    Availability

    The model, endpoint URL, and API key must belong to the same region. Cross-region calls will fail.

    NoteThe sample code in this topic applies to the Singapore region.

    ImportantAlibaba Cloud Model Studio has released workspace-specific domains for the China (Beijing) and Singapore regions. The new dedicated domains deliver superior performance and higher stability for inference requests. We recommend migrating to the new domains:

    • China (Beijing): from https://dashscope.aliyuncs.com to https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com
    • Singapore: from https://dashscope-intl.aliyuncs.com to https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com

    {WorkspaceId} is your workspace ID, which can be found on the Workspace Details page in the Alibaba Cloud Model Studio console. The existing domain remains fully functional.

    HTTP

    ImportantThis is a legacy API that only supports wan2.6 models.

    Video generation tasks typically take 1–5 minutes. The API uses asynchronous calls with two steps: "create a task -> poll for the result". Details are as follows:

    Step 1: Create a task

    Singapore

    POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis

    Replace {WorkspaceId} with your actual workspace ID.

    US (Virginia)

    POST https://{WorkspaceId}.us-east-1.maas.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

    Replace {WorkspaceId} with your actual workspace ID.

    China (Beijing)

    POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis

    Replace {WorkspaceId} with your actual workspace ID.

    Note

    • After the task is created, use the returned task_id to query the result. The task_id is valid for 24 hours. Do not create duplicate tasks. Instead, use polling to retrieve the result.
    • For guidance for beginners, see Call APIs with Postman or cURL.

    Request parameters

    Headers

    Content-Type string (Required)

    The content type of the request. Must be application/json.

    Authorization string (Required)

    Authenticates the request with a Model Studio API key. Example: Bearer sk-xxxx.

    X-DashScope-Async string (Required)

    Enables asynchronous processing. HTTP requests support only asynchronous calls. Must be enable.

    ImportantIf this request header is missing, the error "current user api does not support synchronous calls" is returned.

    Request body

    model string (Required)

    The model to use. See Model pricing for available models and pricing.

    Example: wan2.6-r2v-flash.

    input object (Required)

    Input parameters such as the prompt.

    Properties

    prompt string (Required)

    Text prompt describing the desired elements and visual characteristics of the generated video.

    Supports Chinese and English. Each character counts as one. Content exceeding the limit is automatically truncated.

    • wan2.6-r2v-flash: Maximum length: 1,500 characters.
    • wan2.6-r2v: Maximum length: 1,500 characters.

    Character reference: Use identifiers such as "character1, character2" to refer to reference characters. Each reference (video or image) should contain only one character. The model identifies characters in the references only through these identifiers.

    Example: character1 happily watches a movie on the sofa.

    For tips on writing prompts, see Text-to-video/image-to-video prompt guide.

    negative_prompt string (Optional)

    Negative prompt describing unwanted elements in the video.

    Supports Chinese and English. Maximum length: 500 characters. Content exceeding the limit is automatically truncated.

    Example: low resolution, errors, worst quality, low quality, incomplete, extra fingers, poor proportions, etc.

    reference_urls array[string] (Required)

    Importantreference_urls directly affects billing. For pricing details, see Billing and rate limiting.

    Array of reference file URLs. Supports both video and image inputs. Used to extract character appearance and voice (if available) to generate videos that match the reference characteristics.

    • Each URL can point to one image or one video:

      • Images: 0–5.
      • Videos: 0–3.
      • Total: images + videos ≤ 5.

    • When passing multiple reference files, the array order defines the character order. The first URL maps to character1, the second to character2, and so on.

    • Each reference file should contain only one subject character. For example, character1 is a girl, and character2 is an alarm clock.

    Supported formats:

    1. Public URL:

    Video requirements:

    • Format: MP4, MOV.
    • Duration: 1s–30s.
    • File size: up to 100 MB.

    Image requirements:

    • Format: JPEG, JPG, PNG (no transparency), BMP, WEBP.
    • Resolution: both width and height must be between 240 and 8,000 pixels.
    • File size: up to 20 MB.

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

    Deprecated

    reference_video_urls array[string]

    ImportantUse reference_urls instead of reference_video_urls.

    Array of reference video URLs. Used to extract character appearance and voice (if available) to generate videos that match the reference characteristics.

    • Up to 3 videos.
    • When passing multiple videos, the array order defines the character order. The first URL maps to character1, the second to character2, and so on.
    • Each reference video should contain only one character (for example, character1 is a girl, and character2 is an alarm clock).
    • URLs support HTTP or HTTPS.

    Requirements for each video:

    • Format: MP4, MOV.
    • Duration: 2–30s.
    • File size: up to 100 MB.

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

    parameters object (Optional)

    Video generation parameters such as resolution, prompt rewriting, and watermark.

    Properties

    size string (Optional)

    Important

    • size directly affects billing. Cost = unit price (based on resolution) x duration (seconds). For the same model, 1080P > 720P. Check Model pricing before calling.
    • size must be an exact value (such as 1280*720), not a ratio or shorthand like 1:1 or 720P.

    Resolution of the generated video, in width*height format. The default value and available options depend on the model parameter:

    • wan2.6-r2v-flash: Defaults to 1920*1080 (1080P). Supports all 720P and 1080P resolutions.
    • wan2.6-r2v: Defaults to 1920*1080 (1080P). Supports all 720P and 1080P resolutions.

    720P resolutions and their aspect ratios:

    • 1280*720: 16:9.
    • 720*1280: 9:16.
    • 960*960: 1:1.
    • 1088*832: 4:3.
    • 832*1088: 3:4.

    1080P resolutions and their aspect ratios:

    • 1920*1080: 16:9.
    • 1080*1920: 9:16.
    • 1440*1440: 1:1.
    • 1632*1248: 4:3.
    • 1248*1632: 3:4.

    duration integer (Optional)

    Importantduration directly affects billing. Cost = unit price (based on resolution) x duration (seconds). Check Model pricing before calling.

    Duration of the generated video, in seconds.

    • wan2.6-r2v-flash: Must be between 2 and 10. Defaults to 5.
    • wan2.6-r2v: Must be between 2 and 10. Defaults to 5.

    Example: 5.

    shot_type string (Optional)

    Shot composition of the generated video, determining whether the video consists of a single continuous shot or multiple shots.

    Parameter priority: shot_type > prompt. For example, if shot_type is set to "single", the model outputs a single-shot video even if the prompt says "generate a multi-shot video".

    Valid values:

    • single: Single-shot video. This is the default.
    • multi: Multi-shot video.

    Example: single.

    NoteUse this parameter to control the narrative structure of the video, such as single-shot for product showcases or multi-shot for story clips.

    audio boolean (Optional)

    Importantaudio directly affects billing. Videos with and without audio are priced differently. Check Model pricing before calling.

    Supported model: wan2.6-r2v-flash.

    Whether to generate audio in the video.

    Valid values:

    • true (default)
    • false

    Example: true.

    watermark boolean (Optional)

    Whether to add a watermark. The watermark appears in the bottom-right corner with the text "AI-generated".

    • false (default)
    • true

    Example: false.

    seed integer (Optional)

    The random number seed must be an integer in the range [0, 2147483647].

    If not specified, a random seed is generated. A fixed seed improves reproducibility.

    Because model generation is probabilistic, the same seed does not guarantee identical results.

    Multi-character interaction (reference images and videos)

    Pass image and video URLs through reference_urls. Set shot_type to multi for multi-shot video.

    # The following URL is for the Singapore region. When calling, replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.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 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"
        ]
    },
    "parameters": {
        "size": "1280*720",
        "duration": 10,
        "audio": true,
        "shot_type": "multi",
        "watermark": true
    }
}'

    Multi-character interaction (reference videos)

    Pass multiple video URLs through reference_urls. Set shot_type to multi for multi-shot video.

    # The following URL is for the Singapore region. When calling, replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.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"
    }
}'

    Single character

    Pass a single video URL through reference_urls. Set shot_type to multi for multi-shot video.

    # The following URL is for the Singapore region. When calling, replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.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 sips milk tea while dancing freestyle to the music.",
        "reference_urls":["https://cdn.wanxai.com/static/demo-wan26/vace.mp4"]
    },
    "parameters": {
        "size": "1280*720",
        "duration": 5,
        "shot_type":"multi"
    }
}'

    Generate silent video

    Only wan2.6-r2v-flash supports silent video generation.

    To generate silent video, you must explicitly set parameters.audio = false.

    # The following URL is for the Singapore region. When calling, replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.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 sips milk tea while dancing freestyle 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"
    }
}'

    Response parameters

    output object

    Task output.

    Properties

    task_id string

    The task ID. Valid for queries for 24 hours.

    task_status string

    The status of the task.

    Enumeration values

    • PENDING
    • RUNNING
    • SUCCEEDED
    • FAILED
    • CANCELED
    • UNKNOWN: The task does not exist or its status is unknown.

    request_id string

    Unique request identifier for tracing and troubleshooting.

    code string

    Error code. Returned only for failed requests. See Error codes.

    message string

    Detailed error message. Returned only for failed requests. See Error codes.

    Successful response

    Save the task_id to query the task status and result.

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

    Error response

    Task creation failed. See Error codes.

    {
    "code": "InvalidApiKey",
    "message": "Invalid API-key provided.",
    "request_id": "7438d53d-6eb8-4596-8835-xxxxxx"
}

    Step 2: Retrieve task result

    Singapore

    GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}

    Replace {WorkspaceId} with your actual workspace ID.

    US (Virginia)

    GET https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/api/v1/tasks/{task_id}

    Frankfurt

    GET https://{WorkspaceId}.eu-central-1.maas.aliyuncs.com/api/v1/tasks/{task_id}

    Replace {WorkspaceId} with your actual workspace ID.

    China (Beijing)

    GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id}

    Replace {WorkspaceId} with your actual workspace ID.

    Note

    • Polling recommendation: Video generation takes several minutes. Use a polling mechanism with a reasonable interval, such as 15 seconds.
    • Task state transition: PENDING → RUNNING → SUCCEEDED or FAILED.
    • Result link: After a task succeeds, a video URL valid for 24 hours is returned. Download and save the video to permanent storage, such as OSS.
    • task_idvalidity: 24 hours. After this period, queries return the task status as UNKNOWN.

    Request parameters

    Headers

    Authorization string (Required)

    Authenticates the request with a Model Studio API key. Example: Bearer sk-xxxx.

    Path parameters

    task_id string (Required)

    The ID of the task.

    Retrieve task result

    Replace {task_id} with the task_id value returned by the previous API call. The task_id is valid for queries for 24 hours, Replace {WorkspaceId} with your actual workspace ID.

    curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

    Response parameters

    outputobject

    Task output.

    Properties

    task_id string (Required)

    The ID of the task.

    task_status string

    Task status.

    Enumeration values

    • PENDING
    • RUNNING
    • SUCCEEDED
    • FAILED
    • CANCELED
    • UNKNOWN: The task does not exist or its status is unknown.

    submit_time string

    The time when the task was submitted. The time is in UTC+8 and the format is YYYY-MM-DD HH:mm:ss.SSS.

    scheduled_time string

    The time when the task was executed. The time is in UTC+8 and the format is YYYY-MM-DD HH:mm:ss.SSS.

    end_time string

    The time when the task was completed. The time is in UTC+8 and the format is YYYY-MM-DD HH:mm:ss.SSS.

    video_url string

    URL of the generated video. Returned only when task_status is SUCCEEDED.

    Valid for 24 hours. The video is in MP4 format with H.264 encoding.

    orig_prompt string

    The original input prompt, corresponding to the request parameter prompt.

    code string

    Error code. Returned only for failed requests. See Error codes.

    message string

    Detailed error message. Returned only for failed requests. See Error codes.

    usage object

    Usage statistics. Only counts successful results.

    Properties

    input_video_duration integer

    Duration of the input reference video, in seconds.

    output_video_duration integer

    Duration of the output video, in seconds.

    duration float

    Total video duration. Billing is based on this value.

    Formula: duration = input_video_duration + output_video_duration.

    SR integer

    Resolution tier of the generated video. Example: 720.

    size string

    Resolution of the generated video in width*height format. Example: 1280*720.

    video_count integer

    Number of generated videos. Always 1.

    request_id string

    Unique request identifier for tracing and troubleshooting.

    Task succeeded

    Video URLs are valid for only 24 hours and then automatically purged. Save generated videos promptly.

    {
    "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 happily watches 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 failed

    When a task fails, task_status is FAILED with an error code and message. See Error codes.

    {
    "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 expired

    The task_id is valid for 24 hours. After this period, queries return the following error.

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

    DashScope SDK

    SDK parameters follow the same naming conventions as the HTTP API, with language-specific wrappers.

    Reference-to-video tasks typically take 1–5 minutes. The SDK wraps the HTTP asynchronous workflow and supports both synchronous and asynchronous calls.

    Actual processing time depends on the task queue and server load.

    Python

    ImportantMake sure your DashScope Python SDK version is 2.0.1 or later before running the following code.

    An outdated SDK version may cause errors such as "url error, please check url!". See Install the SDK to update.

    Set region based on the model's region (passed in when constructing the Client; the region value varies by region):

    Singapore

    region="ap-southeast-1"

    Replace {WorkspaceId} with your actual workspace ID.

    China (Beijing)

    region="cn-beijing"

    Replace {WorkspaceId} with your actual workspace ID.

    Frankfurt

    region="eu-central-1"

    Replace {WorkspaceId} with your actual workspace ID.

    Synchronous

    Synchronous calls block until video generation completes and the result is returned.

    Request example 
    import dashscope
import os
from dashscope.v2 import DashScopeError

# The following is the configuration for the Singapore (ap-southeast-1) region. Replace {WorkspaceId} with your Model Studio workspace ID. The region value varies by region.
client = dashscope.Client(
    # If DASHSCOPE_API_KEY is not set, replace the following line with: api_key="sk-xxx"
    # API keys are region-specific. Get your API key: https://www.alibabacloud.com/help/model-studio/get-api-key
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    workspace="{WorkspaceId}",
    region="ap-southeast-1",
)

def sample_sync_call_r2v():
    # Synchronous call: blocks until the result is ready; generate is a one-step call (submits the task and waits for completion) that returns a completed Job.
    print('please wait...')
    try:
        job = client.videos.generate(
            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 is an input-section field, not in the named signature; pass it through extra_input.
            # shot_type and audio are parameters-section fields and are passed through parameters.
            extra_input={'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"
            ]},
            size='1280*720',
            duration=10,
            watermark=True,
            parameters={'shot_type': 'multi', 'audio': True})
        print(job)
        print(job.video_url)
    except DashScopeError as e:
        print(f"HTTP status code: {e.status_code}")
        print(f"Error code: {e.code}")
        print(f"Error message: {e.message}")
        print("See the documentation: https://www.alibabacloud.com/help/model-studio/developer-reference/error-code")

if __name__ == '__main__':
    sample_sync_call_r2v()

    Asynchronous

    Asynchronous calls return the task ID immediately; use fetch to check the task status, or call wait to block until the task completes (with automatic polling).

    Request example 
    import os
import dashscope
from dashscope.v2 import DashScopeError

# The following is the configuration for the Singapore (ap-southeast-1) region. Replace {WorkspaceId} with your Model Studio workspace ID. The region value varies by region.
client = dashscope.Client(
    # If DASHSCOPE_API_KEY is not set, replace the following line with: api_key="sk-xxx"
    # API keys are region-specific. Get your API key: https://www.alibabacloud.com/help/model-studio/get-api-key
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    workspace="{WorkspaceId}",
    region="ap-southeast-1",
)

def sample_async_call_r2v_26():
    # Asynchronous call: returns a task_id
    try:
        job = client.videos.jobs.create(
            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 is an input-section field, not in the named signature; pass it through extra_input.
            # shot_type and audio are parameters-section fields and are passed through parameters.
            extra_input={'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"
            ]},
            size='1280*720',
            duration=10,
            watermark=True,
            parameters={'shot_type': 'multi', 'audio': True})
        print(job)
        print("task_id: %s" % job.task_id)
    except DashScopeError as e:
        print(f"HTTP status code: {e.status_code}")
        print(f"Error code: {e.code}")
        print(f"Error message: {e.message}")
        print("See the documentation: https://www.alibabacloud.com/help/model-studio/developer-reference/error-code")
        return

    # Fetch the task status
    try:
        snapshot = client.videos.jobs.fetch(job.task_id)
        print(snapshot.status)
    except DashScopeError as e:
        print(f"HTTP status code: {e.status_code}")
        print(f"Error code: {e.code}")
        print(f"Error message: {e.message}")
        print("See the documentation: https://www.alibabacloud.com/help/model-studio/developer-reference/error-code")

    # Wait for the task to complete (exponential backoff polling, default total budget of 24 hours)
    try:
        done = client.videos.jobs.wait(job)
        print(done)
        print(done.video_url)
    except DashScopeError as e:
        print(f"HTTP status code: {e.status_code}")
        print(f"Error code: {e.code}")
        print(f"Error message: {e.message}")
        print("See the documentation: https://www.alibabacloud.com/help/model-studio/developer-reference/error-code")

if __name__ == '__main__':
    sample_async_call_r2v_26()

    Java

    ImportantMake sure your DashScope Java SDK version is 2.22.14 or later before running the following code.

    An outdated SDK version may cause errors such as "url error, please check url!". See Install the SDK to update.

    Set baseHttpApiUrl based on the model's region:

    Singapore

    Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";

    Replace {WorkspaceId} with your actual workspace ID.

    China (Beijing)

    Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1";

    Replace {WorkspaceId} with your actual workspace ID.

    Frankfurt

    Constants.baseHttpApiUrl = "https://{WorkspaceId}.eu-central-1.maas.aliyuncs.com/api/v1";

    Replace {WorkspaceId} with your actual workspace ID.

    Synchronous

    Synchronous calls block until video generation completes and the result is returned.

    Request example 
    // 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 {
        // Singapore region URL. Use the URL for your region.
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
    }

    // If DASHSCOPE_API_KEY is not set, replace the following line with: apiKey="sk-xxx"
    // API keys are region-specific. Get your API key: https://www.alibabacloud.com/help/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);
    }
}

    Asynchronous

    Asynchronous calls return a task ID immediately. You must poll or wait for the task to complete.

    Request example 
    // 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 {
        // Singapore region URL. Use the URL for your region.
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
    }

    // If DASHSCOPE_API_KEY is not set, replace the following line with: apiKey="sk-xxx"
    // API keys are region-specific. Get your API key: https://www.alibabacloud.com/help/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();
        // Submit an asynchronous task
        VideoSynthesisResult result = vs.asyncCall(param);
        System.out.println("task_id: " + result.getOutput().getTaskId());
        System.out.println(JsonUtils.toJson(result));

        // Wait for the task to complete
        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);
    }
}

    Error codes

    If the model call fails and returns an error message, see Error codes for resolution.