Skip to main content
POST
Reference-to-Video: create a video task with up to 9 reference images to preserve the subject
Вы можете отлаживать напрямую в Playground справа: заполните Authorization значением Bearer sk-your-api-key, задайте model / input.media / parameters, затем отправьте запрос. При успешной отправке возвращается task_id; ниже см. инструкции по опросу и скачиванию.
На этой странице описан create endpoint для happyhorse-1.1-r2v (Reference-to-Video): укажите референсные изображения, и модель сохранит в них объекты и особенности сцены. HappyHorse-r2v поддерживает до 9 референсных изображений, обеспечивая более сильную согласованность объектов в сценариях с несколькими референсами. Полный асинхронный процесс см. в Обзор HappyHorse.
  • happyhorse-1.1-r2v поддерживает до 9 записей reference_image (это больше, чем суммарные ≤5 у Wan2.7-r2v).
  • input.media обязателен, а media url должен быть публичной https-ссылкой, которую можно напрямую получить через GET.
  • Запрос на создание отправляется в /wan/api/v1/... с X-DashScope-Async: enable; не используйте /v1/videos.

Примеры кода

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

media[] Значения

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

После отправки опрашивайте GET /v1/tasks/{task_id} до completed, затем скачайте mp4 из result_url (без заголовка Authorization, срок действия — 24 часа). Полный цикл опроса см. в Обзор HappyHorse · Асинхронный поток вызовов.

Авторизации

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>
по умолчанию:happyhorse-1.1-r2v
обязательно

Model ID, fixed to happyhorse-1.1-r2v for Reference-to-Video

Доступные опции:
happyhorse-1.1-r2v
input
object
обязательно
parameters
object

Ответ

Task submitted, returns task_id and PENDING status

output
object
request_id
string

Unique request identifier

Пример:

"..."