WAN 2.7 - Reference to Video

POST

/api/v1/jobs/createTask

WAN 2.7 reference-to-video generation through LiangXin unified asynchronous video tasks, using up to five image or video references to preserve characters, products, voice, or visual identity.

Query Task Status

After submitting a task, use the unified query endpoint to check progress and retrieve results:

Get Task Details

Learn how to query task status and retrieve generation results

For production use, we recommend using the callBackUrl parameter to receive automatic notifications when generation completes, while still keeping GET /api/v1/jobs/recordInfo polling as a fallback.

Market Overview

Explore all available LiangXin video models

Task Status API

Query task state, failures, and final result URLs

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200200 - Request successful

application/json

Task submitted successfully. Use data.taskId to query task progress or correlate callback events.

Body

🔴500500 - Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/v1/jobs/createTask' \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "wan-2-7-reference-to-video",
  "callBackUrl": "https://your-domain.com/api/callback",
  "input": {
    "prompt": "Create a short brand video where the referenced character presents the product in a modern studio",
    "image_urls": [
      {
        "url": "https://example.com/character-reference.png"
      }
    ],
    "negative_prompt": "blur, distorted face, low quality",
    "aspect_ratio": "16:9",
    "resolution": "720P",
    "duration": 5,
    "seed": 12345,
    "additional_settings": {
      "prompt_extend": true
    }
  }
}'

Response Example

200 - 200 - Request successful

The task was accepted and can be queried by taskId.

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_wan_27_r2v_1765166238716"
  }
}

Modified at 2026-05-02 05:24:41

WAN 2.7 - Image to Video

WAN 2.6 - Image to Video

WAN 2.7 - Reference to Video

Query Task Status#

Related Resources#

Request

Responses

Query Task Status

Related Resources