Генерация видео

LLMSTORE поддерживает создание видео из текстовых подсказок (и дополнительных эталонных изображений) через специальный асинхронный API. Вы можете найти поддерживаемые модели, их возможности и цены, отфильтровав наш список моделей по видеовыходу.

Generated with minimax/hailuo-3 — 2K, 5s, 16:9, with audio

Prompt and parameters

медленное кинематографическое нажатие на светящуюся неоновую вывеску с надписью «LLMSTORE» в витрине уютной кофейни дождливой ночью, дождь стекает по стеклу, отражения рябятся по мокрому тротуару

Модель: minimax/hailuo-3
Выход: один 5-секундный 2K 16:9 клип со звуком

См. Параметры запроса. для получения полного набора опций.

Открытие модели

Найти модели генерации видео можно несколькими способами:

Через API видеомоделей

Используйте выделенную эндпоинт моделей видео, чтобы вывести список всех доступных моделей создания видео вместе с их поддерживаемыми параметрами:

curl "https://api.llmstore.ru/v1/videos/models"

Ответ возвращает Массив data , где каждая модель включает в себя:

{
  "data": [
    {
      "id": "google/veo-3.1",
      "canonical_slug": "google/veo-3.1",
      "name": "Google: Veo 3.1",
      "description": "...",
      "created": 1719792000,
      "supported_resolutions": ["720p", "1080p"],
      "supported_aspect_ratios": ["16:9", "9:16", "1:1"],
      "supported_sizes": ["1280x720", "1920x1080"],
      "pricing_skus": {
        "per-video-second": "0.50",
        "per-video-second-1080p": "0.75"
      },
      "allowed_passthrough_parameters": ["output_config"]
    }
  ]
}

Поле	Описание
`id`	Слаг модели для использования в запросах генерации
`canonical_slug`	Постоянный идентификатор модели
`supported_resolutions`	Список поддерживаемых выходных разрешений (например, `720p`, `1080p`)
`supported_aspect_ratios`	Список поддерживаемых соотношений сторон (например, `16:9`, `9:16`)
`supported_sizes`	Список поддерживаемых размеров пикселей (например, `1280x720`)
`pricing_skus`	Информация о ценах за SKU
`allowed_passthrough_parameters`	Параметры, специфичные для поставщика, которые можно передать через `provider` опция

Используйте эту эндпоинт, чтобы проверить, какие разрешения, соотношения сторон и параметры сквозной передачи поддерживаются каждой моделью, прежде чем отправлять запрос на создание.

Через API моделей

Вы также можете использовать output_modalities в Models API , чтобы узнать о моделях генерации видео:

# List only video generation models
curl "https://api.llmstore.ru/v1/models?output_modalities=video"

На странице моделей

Посетите страницу Модели и фильтруйте по модальности вывода, чтобы найти модели, способные генерировать видео. Ищите модели, которые перечислены "video" в своих модальностях вывода.

Как это работает

В отличие от генерации текста или изображений, генерация видео является асинхронной, поскольку создание видео занимает значительно больше времени. Рабочий процесс:

Отправьте запрос на генерацию на POST /v1/videos
Немедленно получите идентификатор задания и URL-адрес опроса.
Опрос URL-адрес опроса (GET /v1/videos/{jobId}) до тех пор, пока статус не изменится completed
Загрузите видео по URL-адресу контента (GET /v1/videos/{jobId}/content)

Использование API

Отправка запроса на создание видео

Параметры запроса

Параметр	Тип	Требуется	Описание
`model`	строка	Да	Модель, которую следует использовать для создания видео (например, `google/veo-3.1`)
`prompt`	строка	Да	Текстовое описание создаваемого видео
`duration`	целое число	Нет	Продолжительность создаваемого видео в секундах
`resolution`	строка	Нет	Разрешение выходного видео (например, `720p`, `1080p`)
`aspect_ratio`	строка	Нет	Соотношение сторон выходного видео (например, `16:9`, `9:16`, `3:2`)
`size`	строка	Нет	Точные размеры пикселей в `WIDTHxHEIGHT` формат (например, `1280x720`). Взаимозаменяем с `resolution` + `aspect_ratio`
`frame_images`	массив	Нет	Изображения для первого/последнего кадров (преобразование изображения в видео)
`input_references`	массив	Нет	Справочные изображения для руководства по стилю (ссылка на видео)
`generate_audio`	логическое	Нет	Генерировать ли звук вместе с видео. По умолчанию `true` для моделей, поддерживающих аудиовыход
`seed`	целое число	Нет	Начальное значение для детерминированной генерации (не гарантируется всеми поставщиками)
`callback_url`	строка	Нет	URL-адрес для получения уведомления веб-перехватчика после завершения задания. Переопределяет URL-адрес обратного вызова по умолчанию на уровне рабочей области, если он установлен. Должно быть HTTPS
`provider`	объект	Нет	Конфигурация транзитной передачи для конкретного поставщика

Поддерживаемые разрешения

480p
720p
768p
1080p
1K
2K
4K

Поддерживаемые соотношения сторон

16:9 — Широкоэкранный пейзаж
9:16 — Вертикальное/портретное положение
1:1 — Квадрат
4:3 — Стандартный ландшафт
3:4 — Стандартный портрет
3:2 — Фотография пейзажа
2:3 — Фотография портрета
21:9 — Сверхширокий
9:21 — Ультра-высокий

Использование изображений

Существует два способа предоставления изображений, каждый из которых запускает другой режим генерации:

frame_images — указывает первый или последний кадр. изображений для преобразования изображения в видео. Каждая запись должен содержать frame_type из first_frame или last_frame.
input_references — обеспечивает стиль или содержание. эталонные изображения для ссылки на видео поколение. Модель использует их в качестве визуального руководства. , а не точные кадры.

Если указаны оба поля, frame_images занимает приоритет и запрос рассматривается как изображение-видео.

Преобразование изображения в видео (frame_images)

{
  "model": "alibaba/wan-2.7",
  "prompt": "A character walking through a forest",
  "frame_images": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/first-frame.png"
      },
      "frame_type": "first_frame"
    }
  ],
  "resolution": "1080p"
}

Ссылка на видео (input_references)

{
  "model": "alibaba/wan-2.7",
  "prompt": "A colossal solar flare beside a planet",
  "input_references": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/style-ref.png"
      }
    }
  ],
  "resolution": "1080p"
}

Опции, зависящие от поставщика

Вы можете передать параметры, специфичные для провайдера, с помощью provider параметр. Параметры кодируются слагом поставщика, и пересылаются только параметры соответствующего поставщика:

{
  "model": "google/veo-3.1",
  "prompt": "A time-lapse of a flower blooming",
  "provider": {
    "options": {
      "google-vertex": {
        "parameters": {
          "personGeneration": "allow",
          "negativePrompt": "blurry, low quality"
        }
      }
    }
  }
}

Используйте API видеомоделей , чтобы проверить, какие параметры передачи поддерживает каждая модель через allowed_passthrough_parameters поле.

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

Отправить ответ (202 принято)

Когда вы отправляете запрос на создание видео, вы немедленно получаете ответ с подробностями вакансии:

{
  "id": "abc123",
  "polling_url": "https://api.llmstore.ru/v1/videos/abc123",
  "status": "pending"
}

Ответ на опрос

При опросе статуса задания ответ включает дополнительные поля по мере выполнения задания:

{
  "id": "abc123",
  "generation_id": "gen-1234567890-abcdef",
  "polling_url": "https://api.llmstore.ru/v1/videos/abc123",
  "status": "completed",
  "unsigned_urls": [
    "https://api.llmstore.ru/v1/videos/abc123/content?index=0"
  ],
  "usage": {
    "cost": 0.25,
    "is_byok": false
  }
}

Статусы вакансий

Статус	Описание
`pending`	Задание отправлено и находится в очереди
`in_progress`	Видео создается
`completed`	Видео готово для скачивания
`failed`	Генерация не удалась (проверьте поле `error` )

Загрузка видео

Как только статус задания станет Массив completed, unsigned_urls содержит URL-адреса для загрузки сгенерированного видеоконтента. Вы также можете использовать эндпоинт контента напрямую:

curl "https://api.llmstore.ru/v1/videos/{jobId}/content?index=0" \
  -H "Authorization: Bearer $LLMSTORE_API_KEY" \
  --output video.mp4

Объект index параметр запроса по умолчанию имеет значение 0 и может использоваться, если модель генерирует несколько видеовыходов.

Вебхуки

Вместо опроса статуса задания вы можете получить уведомление веб-перехватчика после завершения задания создания видео. Существует два способа настройки URL-адреса обратного вызова:

По запросу: пройти callback_url в теле запроса. Это имеет приоритет над значением по умолчанию для рабочей области.
Рабочая область по умолчанию: установите URL-адрес обратного вызова по умолчанию в настройках воркспейса в личном кабинете. Это относится ко всем запросам на создание видео, в которых не указаны собственные callback_url.

Полезная нагрузка вебхука

Когда задание достигает конечного состояния, на URL обратного вызова отправляется POST-запрос с конвертом события. Каждая доставка также включает ключ идемпотентности вида <job_id>-<status> для безопасной дедупликации повторных доставок. video.generation.completed:

{
  "type": "video.generation.completed",
  "created_at": "2026-04-24T12:00:00.000Z",
  "data": {
    "id": "abc123",
    "status": "completed",
    "generation_id": "gen-xyz789",
    "model": "google/veo-3.1",
    "unsigned_urls": [
      "https://api.llmstore.ru/v1/videos/abc123/content?index=0"
    ],
    "usage": {
      "cost": 0.5,
      "is_byok": false
    }
  }
}

video.generation.failed:

{
  "type": "video.generation.failed",
  "created_at": "2026-04-24T12:00:00.000Z",
  "data": {
    "id": "abc123",
    "status": "failed",
    "generation_id": "gen-xyz789",
    "model": "google/veo-3.1",
    "error": "Content policy violation"
  }
}

video.generation.cancelled:

{
  "type": "video.generation.cancelled",
  "created_at": "2026-04-24T12:00:00.000Z",
  "data": {
    "id": "abc123",
    "status": "cancelled",
    "generation_id": "gen-xyz789",
    "model": "google/veo-3.1",
    "error": "Job was cancelled"
  }
}

video.generation.expired:

{
  "type": "video.generation.expired",
  "created_at": "2026-04-24T12:00:00.000Z",
  "data": {
    "id": "abc123",
    "status": "expired",
    "generation_id": "gen-xyz789",
    "model": "google/veo-3.1",
    "error": "Job exceeded maximum time to live"
  }
}

generation_id и Параметры model в data может быть null , когда задание не удалось выполнить раньше эти значения присвоены (например, сбой ранней проверки).

Лучшие практики

Подробные подсказки: предоставляйте конкретные, описательные подсказки для улучшения качества видео. Включите подробную информацию о движении, ракурсах камеры, освещении и композиции сцены.
Подходящее разрешение: создание изображений с более высоким разрешением занимает больше времени и стоит дороже. Выберите разрешение, которое соответствует вашему варианту использования
Интервал опроса: используйте разумный интервал опроса (например, 30 секунд), чтобы избежать чрезмерных вызовов API. Генерация видео обычно занимает от 30 секунд до нескольких минут в зависимости от модели и параметров.
Обработка ошибок: всегда проверяйте статус задания на failed состояние и обработка error поле соответствующим образом
Справочные изображения: при использовании эталонных изображений убедитесь, что они высокого качества и соответствуют желаемому видеовыходу.

Нулевое сохранение данных

Создание видео не соответствует требованиям нулевого сохранения данных (ZDR). Поскольку создание видео является асинхронным, сгенерированный видеовыход должен храниться у поставщика в течение короткого периода времени, чтобы его можно было получить после завершения создания. Это временное сохранение присуще рабочему процессу асинхронного опроса, и его нельзя обойти. Если у вас включено принудительное применение ZDR (либо через настройки учетной записи или по запросу параметр zdr ), запросы на создание видео маршрутизироваться не будут.

Устранение неполадок

Работа остается pending давно?

Генерация видео может занять несколько минут в зависимости от модели, разрешения и нагрузки на сервер.
Продолжайте опрос через регулярные промежутки времени.

Ошибка генерации?

Проверьте Поле error в ответе на опрос для получения подробной информации.
Убедитесь, что модель поддерживает создание видео (output_modalities включает в себя "video") – Убедитесь, что ваше приглашение соответствует требованиям и соответствует рекомендациям модели.
Убедитесь, что все эталонные изображения доступны и имеют поддерживаемые форматы.

Модель не найдена?

Используйте API видеомоделей или страница Модели , чтобы найти доступные модели генерации видео. — убедитесь, что обозначение модели правильное (например, google/veo-3.1)

Начало работы

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

Мультимодальность

Модели и роутинг

Варианты моделей

Возможности

Плагины

Администрирование

Приватность

Лучшие практики

SDK и интеграции

Открытие модели

Через API видеомоделей

Через API моделей

На странице моделей

Как это работает

Использование API

Отправка запроса на создание видео

Параметры запроса

Поддерживаемые разрешения

Поддерживаемые соотношения сторон

Использование изображений

Преобразование изображения в видео (frame_images)

Ссылка на видео (input_references)

Опции, зависящие от поставщика

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

Отправить ответ (202 принято)

Ответ на опрос

Статусы вакансий

Загрузка видео

Вебхуки

Полезная нагрузка вебхука

Лучшие практики

Нулевое сохранение данных

Устранение неполадок

​Открытие модели

​Через API видеомоделей

​Через API моделей

​На странице моделей

​Как это работает

​Использование API

​Отправка запроса на создание видео

​Параметры запроса

​Поддерживаемые разрешения

​Поддерживаемые соотношения сторон

​Использование изображений

​Преобразование изображения в видео (frame_images)

​Ссылка на видео (input_references)

​Опции, зависящие от поставщика

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

​Отправить ответ (202 принято)

​Ответ на опрос

​Статусы вакансий

​Загрузка видео

​Вебхуки

​Полезная нагрузка вебхука

​Лучшие практики

​Нулевое сохранение данных

​Устранение неполадок

Открытие модели

Через API видеомоделей

Через API моделей

На странице моделей

Как это работает

Использование API

Отправка запроса на создание видео

Параметры запроса

Поддерживаемые разрешения

Поддерживаемые соотношения сторон

Использование изображений

Преобразование изображения в видео (frame_images)

Ссылка на видео (input_references)

Опции, зависящие от поставщика

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

Отправить ответ (202 принято)

Ответ на опрос

Статусы вакансий

Загрузка видео

Вебхуки

Полезная нагрузка вебхука

Лучшие практики

Нулевое сохранение данных

Устранение неполадок