Wan 2.6 Reference-to-Video

Wan 2.6 Reference-to-Video model generates videos from reference URLs (images/videos) with multi-character interaction and role-playing capabilities. Generates silent videos by default.

POST /wan2.6-r2v/async

cURL

basic

curl --request POST \
  --url https://api.modellix.ai/api/v1/alibaba/wan2.6-r2v/async \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Character1 drinking bubble tea while dancing to music",
  "reference_urls": [
    "https://example.com/character1.jpg"
  ]
}
'

200

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

prompt · string · required

Video content description (supports Chinese and English, up to 1500 characters). Can reference characters using 'Character1/Character2' format

Required string length: 1 - 1500

Example:

"Character1 drinking bubble tea while dancing to music"

reference_urls · string<uri>[] · required

Reference URLs array (images + videos ≤ 5)

Required array length: 1 - 5 elements

Reference media URL (HTTP/HTTPS/OSS)

Example:

["https://example.com/character.jpg"]

negative_prompt · string

Negative prompt describing unwanted content

Maximum string length: 500

Example:

"blurry, distorted, low quality"

size · enum<string> · default: 1920*1080

Video resolution (format: width*height)

Available options: 1280*720, 720*1280, 960*960, 1088*832, 832*1088, 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632

Example:

"1920*1080"

duration · enum<integer> · default: 5

Video duration in seconds

Available options: 2, 3, 4, 5, 6, 7, 8, 9, 10

Example:

5

shot_type · enum<string> · default: single

Shot type (single-shot or multi-shot narrative)

Available options: single, multi

Example:

"single"

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

Detailed data about the submitted asynchronous task.

Show child attributes