Skip to main content
POST
Reference-to-video: create a video task that preserves subject features from reference images/videos
Песочница справа позволяет отлаживать напрямую: укажите Bearer sk-your-api-key в Authorization, заполните model / input.media / parameters и отправьте запрос. Успешная отправка возвращает task_id; ниже см. опрос и скачивание.
Эта страница — эндпоинт создания для wan2.7-r2v (reference-to-video): передайте референсные изображения/видео, и model сохранит их subjects (people/animals/objects) и scene features, создавая сцены с одним персонажем или взаимодействия нескольких персонажей. Если вам нужно больше референсных изображений (до 9), рассмотрите HappyHorse r2v. Для полного async flow см. Wan Обзор.
  • Соглашение о цитировании референсных ресурсов: в prompt используйте «image 1 / image 2» для обозначения reference_image и «video 1 / video 2» для обозначения reference_video в том же порядке, что и массив media (изображения и видео считаются отдельно). При одном изображении/видео можно просто написать «референсное изображение» / «референсное видео».
  • Ограничения по количеству: reference_image + reference_video всего ≤5; не более 1 first_frame.
  • Запросы на создание отправляйте в /wan/api/v1/... с X-DashScope-Async: enable; не используйте /v1/videos.

Примеры кода

Краткая справка по параметрам и медиа

Значения media[]

Формат ответа

Проверка статуса и скачивание

После того как у вас есть task_id, выполните три шага ниже, чтобы опросить статус и скачать mp4:
  • Опрос GET /v1/tasks/{task_id}Authorization; запросу не нужен заголовок X-DashScope-Async), каждые 10 секунд (не < 3 секунд), пока status не станет completed. Преобразование reference-to-video обычно занимает 1-5 минут, поэтому на всякий случай задайте клиентский тайм-аут 20 минут.
  • Значения статуса: submitted (в очереди) / in_progress (генерируется; если progress часто зависает на 30%, это нормально) / completed (успех) / failed (проверьте error).
  • Скачивание: выполните GET для result_url напрямую из ответа, без заголовка Authorization (это подписанная прямая ссылка OSS — при отправке Auth вернется 403); result_url по умолчанию истекает через 24 часа, поэтому сохраните его сразу.
Приведенное выше — это быстрый путь проверки/скачивания для случая «у вас уже есть task_id». Для полного цикла опроса (с запасным тайм-аутом) и Python client см. Обзор Wan · Поток асинхронных вызовов.

Авторизации

Authorization
string
header
обязательно

The API Key obtained from the APIYI console

Заголовки

X-DashScope-Async
enum<string>
по умолчанию:enable
обязательно

Async processing switch; must be set to enable

Доступные опции:
enable

Тело

application/json
model
enum<string>
по умолчанию:wan2.7-r2v
обязательно

Model ID; for reference-to-video use wan2.7-r2v (legacy versions wan2.6-r2v / wan2.6-r2v-flash)

Доступные опции:
wan2.7-r2v,
wan2.6-r2v,
wan2.6-r2v-flash
input
object
обязательно
parameters
object

Ответ

Task submitted; returns task_id and PENDING status

output
object
request_id
string

Unique request identifier

Пример:

"..."