Skip to main content
POST
Text-to-Video: create a video generation task from a text prompt
Вы можете отлаживать напрямую в Playground справа: заполните Authorization значением Bearer sk-your-api-key, задайте model / input / parameters, затем отправьте запрос. Успешная отправка возвращает task_id; ниже см. опрос статуса и скачивание.
На этой странице описан create-эндпоинт для happyhorse-1.1-t2v (Text-to-Video) и нужен только текстовый prompt. Полный асинхронный поток, таблицу статусов и клиент Python см. в Обзоре HappyHorse.
  • Создаваемый запрос должен отправляться на /wan/api/v1/services/aigc/video-generation/video-synthesis с заголовком запроса X-DashScope-Async: enable. Не используйте /v1/videos.
  • duration должен быть целым числом (5, а не "5"); указывайте resolution в верхнем регистре 720P.

Примеры кода

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

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

Успешное создание возвращает task_id (не само видео):
После отправки необходимо опрашивать GET /v1/tasks/{task_id}, пока status: "completed", затем скачайте mp4 из result_url в ответе. При загрузке не включайте заголовок Authorization (это подписанная прямая ссылка OSS), и result_url по умолчанию истекает через 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-t2v
обязательно

Model ID, fixed to happyhorse-1.1-t2v for Text-to-Video

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

Ответ

Task submitted, returns task_id and PENDING status

output
object
request_id
string

Unique request identifier

Пример:

"..."