Skip to main content
POST
Image-to-video: create a video generation task from a first frame (+ optional driving audio)
Песочница справа позволяет отлаживать напрямую: укажите Bearer sk-your-api-key в Authorization, заполните model / input.media / parameters и отправьте запрос. Успешная отправка возвращает task_id; ниже см. сведения об опросе и загрузке.
Эта страница — эндпоинт создания для wan2.7-i2v (image-to-video): передайте первый кадр + prompt, чтобы оживить изображение, и при желании укажите driving_audio, чтобы портрет следовал движениям губ и ритму аудио. Для полного асинхронного потока см. Обзор Wan.
  • Управление аудио доступно только в wan2.7-i2v: HappyHorse i2v не поддерживает driving_audio, поэтому для синхронизации губ / rap нужно использовать wan2.7-i2v.
  • input.media обязателен, иначе вышестоящий сервис вернет image-to-video model ... must provide an image. Каждый url для медиа должен быть общедоступной ссылкой https, которую можно получить напрямую через GET.
  • Запросы на создание отправляйте в /wan/api/v1/... с X-DashScope-Async: enable; не используйте /v1/videos.

Примеры кода

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

Значения media[]

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

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

После того как у вас есть task_id, выполните следующие три шага, чтобы опрашивать статус и скачать mp4:
  • Опросите GET /v1/tasks/{task_id}Authorization; запросу не нужен заголовок X-DashScope-Async), каждые 5-10 секунд (не чаще чем раз в 3 секунды), пока status не станет completed.
  • Значения статуса: submitted (в очереди) / in_progress (генерация; progress, когда он часто висит на 30%, — это нормально) / completed (успех) / failed (проверьте error).
  • Скачивание: выполните GET для result_url прямо из ответа, без заголовка Authorization (это прямая подписанная ссылка OSS — при отправке Auth возвращается 403); result_url по умолчанию истекает через 24 часа, поэтому сохраните его как можно скорее.
Выше показан быстрый путь проверки/скачивания для случая, когда у вас уже есть task_id. Полный цикл опроса (с запасным вариантом при тайм-ауте) и клиент Python см. в Обзор 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-i2v
обязательно

Model ID; for image-to-video, fixed wan2.7-i2v (legacy version wan2.6-i2v)

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

Ответ

Task submitted; returns task_id and PENDING status

output
object
request_id
string

Unique request identifier

Пример:

"..."