ДокументацияПоддержка
API

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

Асинхронные видеозадачи, референсы и воспроизведение в LibreChat.

Все руководства (.md)

От описания к медиафайлу

Прозрачная стеклянная киноплёнка переходит в объёмную звуковую волну.
Иллюстрация работы с видео и аудио. Один запуск, проверка статуса задачи, затем сохранение готового файла.

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

POST /v1/videos (также /v1/video/generations) возвращает публичный id задачи и status. Проверяйте GET /v1/videos/{id} раз в 3–5 секунд до completed или failed. Готовая ссылка находится в metadata.url. Это относится к медиакаталогу, включая Gemini Omni и Seedance: старый синхронный ответ videos[] здесь больше не используется. LibreChat ждёт результат автоматически до 10 минут.

1curl https://elysiumai.garden/v1/videos   -H "Authorization: Bearer $ELYSIUM_API_KEY"   -H "Content-Type: application/json"   -d '{"model":"x-ai/grok-imagine-video","operation":"text-to-video","prompt":"A quiet ocean at sunrise","input":{"duration":6,"resolution":"480p","aspect_ratio":"16:9"}}'
Режимы референсов и обработки могут требовать URL изображений, видео, аудио либо публичный ID предыдущей завершённой задачи вашего аккаунта. Имена полей input берите из схемы. Не все режимы доступны у каждой модели.

Цена до генерации

POST /v1/media/quote принимает те же model, operation, prompt и input, что и генерация. Платная задача не запускается. В billing возвращаются ставки, известные объёмы, pending для ещё неизвестного результата. Файлы должны быть доступны по публичным HTTPS URL. Полная таблица — в раскрытой карточке модели: цена может зависеть от разрешения, длительности, звука, качества и входных файлов.

1curl https://elysiumai.garden/v1/media/quote -H "Authorization: Bearer $ELYSIUM_API_KEY" -H "Content-Type: application/json" -d '{"model":"openai/gpt-image-2","prompt":"A garden","input":{"resolution":"2K"}}'
Предварительный расчёт принимает JSON с публичными ссылками на файлы. Он не загружает локальные файлы и не раскрывает ID предыдущих задач. Операции с такими исходниками проверяются и тарифицируются при отправке; предварительный расчёт доступен не для всех этих вариантов.

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

GET /v1/media/models возвращает публичные ID моделей, режимы operations и схемы input: допустимые значения, обязательные поля, ограничения и значения по умолчанию. Выберите operation из ответа и передайте параметры этого режима внутри input. Разрешение, длительность, референсы и звук зависят от модели; у некоторых сочетаний есть дополнительные ограничения. Пропущенные поля используют настройки модели, а явно переданные false и 0 сохраняются.

1curl https://elysiumai.garden/v1/media/models
Не переносите разрешение или качество из другой модели. Неизвестные поля input отклоняются до генерации. Проверка параметров не может заранее предсказать модерацию содержимого или временный сбой генерации.

Оплата и хранение результата

У каждой модели фиксированные ставки в USD по режимам и параметрам. Ставка сохраняется при запуске и не меняется из-за последующей смены цены поставщика. Итог = ставка × объём плюс отдельно указанные доплаты за входные файлы. Единицы: изображения, секунды видео/аудио, 1000 символов текста или готовые операции. Точная сумма списывается один раз после готовности результата, по фактическому объёму и сохранённым ставкам. До завершения средства блокируются внутренне, без изменения баланса и операции списания в истории. При ошибке блокировка снимается без списания и операции возврата. Настроенные скидки аккаунта учитываются. Расшифровка находится в billing, у видео — metadata.billing, а также в истории запросов. Gemini TTS: $0,0011 за фактическую секунду результата ($0,066/мин), обработка текста включена; это цена до скидок аккаунта.

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

Каждая новая отправка — отдельная платная задача. Сетевой таймаут не означает, что генерация не запустилась. Не повторяйте отправку автоматически.

LibreChat Studio

Выберите ElysiumAI Images или ElysiumAI Video, затем модель и «Настройки генерации» рядом с полем сообщения. Форма строится по схеме выбранной модели. Смена режима очищает старые параметры, настройки привязаны к модели. Описание пишите в сообщении; картинки прикрепляйте к нему либо указывайте доступные ссылки. Для сложных структур сцен и референсов есть поле JSON.

Во время запроса показана лёгкая анимация ожидания — это не оценка процента готовности. Она приостанавливается за пределами экрана и в скрытой вкладке, учитывает уменьшение движения. Готовые изображения и видео появляются прямо в чате. Для видео- и аудиореференсов используйте публичные URL: загрузка этих файлов напрямую через мост не поддерживается.

Термины на этой странице
ТерминЧто означает
Base URLБазовый адрес API, к которому клиент добавляет нужный маршрут.
API-ключСекрет для авторизации и списания запросов с вашего баланса.
Model IDТочное системное имя модели из каталога Elysium AI.
EndpointМаршрут конкретной операции после базового адреса API.
RequestОдин запрос клиента к API вместе с его заголовками и телом.
ResponseРезультат обработки запроса: статус, заголовки и данные.