wan-2.7-reference-to-video

POST

/openapi/v2/alibaba/wan-2.7/reference-to-video

Wan 2.7 Reference-to-Video is an advanced AI model that transforms character, prop, or scene references from existing media into entirely new video shots. By uploading reference materials (requiring at least 1 reference image or video, up to a combined maximum of 5), alongside text prompts, the model generates smooth videos that strictly preserve the original identity and visual style. Supporting 720P and 1080P resolutions and equipped with negative prompt capabilities, it seamlessly brings your visual assets into fresh contexts with remarkable consistency.

Request

Authorization

Header Params

Body Params application/jsonRequired

Example

{
    "prompt": "Video 1 is eating, Picture 1 is singing next to it",
    "videoUrls": [
        "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/hfugmr/wan-r2v-role1.mp4"
    ],
    "imageUrls": [
        "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qpzxps/wan-r2v-object4.png"
    ],
    "resolution": "1080P",
    "duration": "5",
    "aspectRatio": "16:9",
    "promptExtend": true
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://www.runninghub.ai/openapi/v2/alibaba/wan-2.7/reference-to-video' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "Video 1 is eating, Picture 1 is singing next to it",
    "videoUrls": [
        "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/hfugmr/wan-r2v-role1.mp4"
    ],
    "imageUrls": [
        "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260129/qpzxps/wan-r2v-object4.png"
    ],
    "resolution": "1080P",
    "duration": "5",
    "aspectRatio": "16:9",
    "promptExtend": true
}'

Responses

🟢200成功

application/json

Task result query endpoint: /openapi/v2/query

Body

Examples

Submit response exampleTask success response example

{
    "taskId": "2013508786110730241",
    "status": "RUNNING",
    "errorCode": "",
    "errorMessage": "",
    "results": null,
    "clientId": "f828b9af25161bc066ef152db7b29ccc",
    "promptTips": "{\"result\": true, \"error\": null, \"outputs_to_execute\": [\"4\"], \"node_errors\": {}}"
}

Modified at 2026-04-09 12:00:02

pixverse-v6/image-to-video

skyreels-v3/reference-to-video