Wan 2.6 - Reference to Video

wan26_r2v

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

Эндпоинты

POST /v1/queue/wan26_r2v # Создать задачу

GET /v1/queue/wan26_r2v/requests/{request_id}/status # Проверить статус

GET /v1/queue/wan26_r2v/requests/{request_id}/response # Получить результат

PUT /v1/queue/wan26_r2v/requests/{request_id}/cancel # Отменить задачу

Параметры запроса

curl --location "https://odirouter.ai/model/v1/queue/wan26_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 обязательно

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[] обязательно

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

Параметры ответа

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

Поле	Тип	Описание
`request_id`	string	Идентификатор задачи для последующей проверки статуса, получения результата и отмены
`response_url`	string	URL для получения итогового результата
`status_url`	string	URL для проверки статуса задачи
`cancel_url`	string	URL для отмены задачи
`queue_position`	int	Текущая позиция в очереди

Следующие операции