Skip to main content
POST
/
wan2.7-r2v
/
async
curl --request POST \
  --url https://api.modellix.ai/api/v1/alibaba/wan2.7-r2v/async \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "The character walks through a blooming garden in spring"
}
'
{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-abc123",
    "model_id": "model-123",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-abc123"
    }
  }
}

Authorizations

​
Authorization
string
header
required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json

At least one of reference_images, reference_videos, or first_frame_image must be provided.

​
prompt
string
required

Video content description (supports Chinese and English, up to 5000 characters). Can reference media using 'Image1/Image2' or 'Video1/Video2' format

Required string length: 1 - 5000
Example:

"The character walks through a blooming garden"

​
reference_images
string<uri>[]

Reference image URLs. At least one media parameter (reference_images, reference_videos, or first_frame_image) must be provided. Combined with reference_videos, max 5 total

Example:
[
  "https://example.com/char1.jpg",
  "https://example.com/char2.jpg"
]
​
reference_videos
string<uri>[]

Reference video URLs. At least one media parameter (reference_images, reference_videos, or first_frame_image) must be provided. Combined with reference_images, max 5 total

Example:
["https://example.com/action.mp4"]
​
first_frame_image
string<uri>

First frame image URL. At least one media parameter (reference_images, reference_videos, or first_frame_image) must be provided. Max 1, not counted in the 5-item limit

Example:

"https://example.com/first_frame.jpg"

​
negative_prompt
string

Negative prompt describing unwanted content

Maximum string length: 500
Example:

"blurry, distorted, low quality"

​
resolution
enum<string>
default:1080P

Video resolution tier

Available options:
720P,
1080P
Example:

"1080P"

​
ratio
enum<string>
default:16:9

Video aspect ratio (auto-ignored when first_frame_image is present)

Available options:
16:9,
9:16,
1:1,
4:3,
3:4
Example:

"16:9"

​
duration
enum<integer>
default:5

Video duration in seconds. Dynamic range: [2,10] when reference_videos is present, [2,15] when only reference_images

Available options:
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
Example:

5

​
prompt_extend
boolean
default:true

Enable intelligent prompt rewriting

Example:

true

​
seed
integer

Random seed for reproducibility

Required range: 0 <= x <= 2147483647
Example:

42

Response

200 - application/json

Task submitted successfully

​
code
integer
required

Response code, 0 indicates success

Example:

0

​
message
string
required

Response message

Example:

"success"

​
data
object
required