Wan 2.6 Reference to Video

wan2.6-r2v

Wan 2.6 Reference to Video generates videos from reference images or videos while improving character appearance and style consistency.

Endpoints

POST /v1/queue/wan2.6-r2v # Create task

GET /v1/queue/wan2.6-r2v/requests/{request_id}/status # Check status

GET /v1/queue/wan2.6-r2v/requests/{request_id}/response # Get result

PUT /v1/queue/wan2.6-r2v/requests/{request_id}/cancel # Cancel task

Request Parameters

curl --location "https://odirouter.ai/model/v1/queue/wan2.6-r2v" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "character1 walks slowly across a clean studio scene, consistent appearance.",
    "negative_prompt": "distorted face, extra limbs",
    "reference_urls": [
      "https://example.com/reference.webp"
    ],
    "duration": 2,
    "size": "1280*720",
    "shot_type": "single",
    "watermark": false,
    "seed": 12345
  }'

prompt string Required

Text prompt describing video content. You can use placeholders such as character1 and character2 to reference the order of reference assets.

Maximum length: 1500 characters

Example: character1 walking in the park with a happy expression

negative_prompt string

Negative prompt describing content that should not appear in the video. Chinese and English are supported, and content beyond the model limit is truncated automatically.

reference_urls string[] Required

Array of reference asset URLs used to preserve character appearance and style consistency. Images and videos are supported.

Use this field for new requests. Do not send it together with reference_video_urls.

Array order maps to placeholders such as character1 and character2 in the prompt.

Images support JPEG, JPG, PNG, BMP, WEBP; videos support MP4, MOV.

Number of reference assets: 1 - 5

reference_video_urls string[]

Array of reference video URLs. The official documentation marks this field as soon to be deprecated. Prefer reference_urls for both image and video references.

Do not send this field together with reference_urls.

Video formats: MP4, MOV

Duration: 3 - 30 seconds

Maximum file size: 100MB

duration int

Generated video duration in seconds. This parameter affects cost.

Options: 5, 10

Range: 2 - 10

Default: 5

size string

Output video resolution in explicit width-height format, for example 1280*720.

Use size instead of resolution for this endpoint.

Supports common 720P and 1080P aspect ratios, including 16:9, 9:16, 1:1, 4:3, and 3:4.

Default: 1920*1080

shot_type string

Shot type for the generated video. It is used to control video narrative structure only when prompt rewriting is effective.

Options: single, multi

Default: single

audio bool

Whether to include audio when the model workflow supports it.

Options: true, false

seed int

Random seed. When omitted, the system generates a random seed automatically. A fixed seed can improve reproducibility, but identical results are not guaranteed.

Range: 0 - 2147483647

watermark bool

Whether to add a watermark in the lower-right corner of the video.

Options: false, true

Default: false

Response Parameters

{
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://odirouter.ai/model/v1/queue/wan2.6-r2v/requests/mmsu_01hxyz.../response",
  "status_url": "https://odirouter.ai/model/v1/queue/wan2.6-r2v/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://odirouter.ai/model/v1/queue/wan2.6-r2v/requests/mmsu_01hxyz.../cancel",
  "queue_position": 0
}

Field	Type	Description
`request_id`	string	Task ID used for later status checks, result retrieval, and cancellation
`response_url`	string	URL for retrieving the final result
`status_url`	string	URL for checking task status
`cancel_url`	string	URL for canceling the task
`queue_position`	int	Queue position

Next Steps

Check status

Get result

Cancel task

Errors