Открытый API

API генерации видео

Обзор API генерации видео LMU AI: выбор между Seedance и Wan, а также общие правила аутентификации, асинхронных задач, тарификации, лимитов параллельности и кодов ошибок.

LMU AI предоставляет два типа асинхронных API генерации видео, оба используют нативные протоколы провайдеров: замените адрес в официальном SDK или команде curl на адрес LMU AI, а ключ — на ваш API-ключ LMU AI; тело запроса остаётся без изменений. Эта страница — обзор: выберите API в таблице ниже, затем перейдите на страницу соответствующего провайдера. Общие для обоих провайдеров правила (аутентификация, тарификация, лимиты параллельности и коды ошибок) приведены на этой странице.

Базовый URL

https://api.lmuai.com
ПровайдерСоздание задачиЗапрос задачиДокументация
Seedance (Volcengine Ark)POST /api/v3/contents/generations/tasksGET /api/v3/contents/generations/tasks/{id}API генерации видео Seedance
Wan (Alibaba DashScope)POST /api/v1/services/aigc/video-generation/video-synthesisGET /api/v1/tasks/{task_id}API генерации видео Wan

Для вашей группы должна быть включена генерация видео

Для группы API-ключа должна быть включена функция «Генерация видео»; в противном случае вызовы возвращают 403. Доступные для вызова модели зависят от вашего API-ключа; проверить их можно через GET /v1/models.

1. Выбор между двумя API

Seedance (Volcengine Ark)Wan (Alibaba DashScope)
Пример моделиseedance-2.5wan3.0-video
ТарификацияПо выходным токенамПо формуле «фактические секунды × цена за единицу для уровня разрешения»
Значения разрешения480p / 720p / 1080p (строчными)480P / 720P / 1080P (заглавными), по умолчанию 1080P
Статус задачиqueued → running → succeeded / failed / cancelledPENDING → RUNNING → SUCCEEDED / FAILED / CANCELED
Поле URL видеоcontent.video_urloutput.video_url
Отмена задачиМожно отменить задачи в очереди (queued)Эндпоинта отмены нет; отправленная задача всегда выполняется до конца

Название модели должно точно совпадать с названием, включённым для вашей группы (с учётом регистра). Оба API используют похожие названия полей, но с разным регистром и путями, поэтому не путайте их при копировании примеров.

2. Аутентификация

Передавайте API-ключ в заголовке каждого запроса:

Authorization: Bearer YOUR_API_KEY

Не размещайте API-ключ во фронтенд-коде браузера, публичных репозиториях, строках запроса URL или логах. Вызывайте API со своего сервера.

3. Асинхронный процесс выполнения задачи

  1. Создание: POST возвращает только id задачи и не ожидает готовности видео.
  2. Опрос: выполняйте GET задачи примерно каждые 10 секунд, пока она не достигнет конечного состояния (успех / ошибка / отмена).
  3. Референсные изображения: при вызовах API необходимо передавать общедоступный URL изображения (JPG / PNG / WebP); на странице «Генерация видео» в консоли можно загружать локальные изображения.
  4. Скачивание: при успешном завершении возьмите ссылку на видео из ответа. Ссылки провайдера действительны 24 часа, поэтому скачивайте без промедления; платформа сохраняет копию каждого готового видео, которое можно просмотреть и скачать на странице «Задачи видео» в консоли.

Расчёт выполняется, даже если вы прекратили опрос

После отправки платформа отслеживает задачу в фоновом режиме и производит расчёт в обычном порядке, даже если вы перестали запрашивать её статус; за неудачные и отменённые задачи плата не взимается.

Полные примеры создания и опроса см. на страницах Seedance и Wan.

4. Тарификация и водяные знаки

  • При создании задачи замораживается расчётная сумма. Если баланса недостаточно, запрос сразу отклоняется (402), и видео не генерируется.
  • При успешном завершении задача рассчитывается один раз по фактическому использованию, а излишек замороженной суммы возвращается автоматически; за неудачные и отменённые задачи средства возвращаются полностью, плата не взимается.
  • Seedance тарифицируется по выходным токенам; Wan — по формуле «фактические секунды × цена за единицу для уровня разрешения».
  • Готовые видео содержат метку платформы «Сгенерировано ИИ», которую клиенты не могут отключить.

5. Лимиты параллельности

Для каждого пользователя и каждого API-ключа одновременно может генерироваться не более 5 задач. При превышении лимита запросы возвращают 429 с заголовком Retry-After (около 60 секунд); подождите и повторите попытку.

6. Коды ошибок

HTTPЗначениеЧто делать
401API-ключ недействителен или отключёнПроверьте API-ключ
402Недостаточно баланса или квоты для заморозки расчётной суммыПополните баланс и повторите попытку
403Для группы не включена генерация видео, или модель недоступна в группеИспользуйте API-ключ, поддерживающий генерацию видео
404 model_not_foundМодель пока недоступна (ошибка в названии также вызывает эту ошибку)Используйте точное название, возвращаемое GET /v1/models
409Генерация задачи уже началась, и её нельзя отменить (эндпоинт отмены Seedance)Дождитесь завершения задачи
429Достигнут лимит количества выполняемых задачПодождите согласно Retry-After и повторите попытку

Общие ошибки см. в разделе Коды ошибок.

7. Страницы провайдеров

  • API генерации видео Seedance: создание, запрос, получение списка и отмена задач, с описанием параметров, примечаниями о референсных изображениях первого кадра и полным примером опроса.
  • API генерации видео Wan: создание и запрос задач, с описанием параметров и полным примером опроса.

Последнее обновление:

На этой странице