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

Примеры кода

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

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

Успешное создание возвращает task_id (не само видео):

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

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

Авторизации

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, otherwise it returns current user api does not support synchronous calls

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

Тело

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

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

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

Ответ

Task submitted; returns task_id and PENDING status

output
object
request_id
string

Unique request identifier; provide it to support when troubleshooting

Пример:

"a23b81b0-0c05-9972-a6c9-ee757400afdb"