Перейти к основному содержимому

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

Функция генерации видео в Elftia позволяет создавать короткие видеоролики на основе текстовых описаний или референсных изображений с помощью AI. Она интегрирует несколько крупных провайдеров генерации видео и использует асинхронную модель опроса для обработки ресурсоёмкого процесса рендеринга.

Сценарии использования​

  • Генерация коротких видеоклипов по текстовым описаниям
  • Преобразование статичных изображений в динамическое видео (image-to-video)
  • Быстрое создание креативного видео для социальных сетей или презентаций
  • Сравнение результатов генерации у разных провайдеров

Поддерживаемые провайдеры​

ПровайдерОсобенностиТип API
Kling AIВысококачественная генерация видео; поддержка нескольких разрешенийAsync API
OpenAI (Sora)Модель генерации видео от OpenAIAsync API
ReplicateПлатформа хостинга моделей с открытым исходным кодом с широким выбором моделейAsync API
VolcEngineСервис генерации видео VolcengineAsync API
WanГенерация видео WanAsync API
Custom (Unified)Сторонние сервисы, совместимые с унифицированным интерфейсомAsync API

Настройка провайдера​

Шаги​

  1. Откройте Настройки > Медиапровайдеры > Видео
  2. Выберите провайдера
  3. Введите API Key (некоторые провайдеры также требуют Access Key или иную аутентификацию)
  4. (Опционально) Укажите пользовательский эндпоинт API
  5. Выберите модель по умолчанию
  6. Сохраните и включите

Таблица конфигурации провайдера​

НастройкаОписаниеОбязательно
API KeyAPI-ключ провайдераДа
Эндпоинт APIПользовательский адрес APIНет (по умолчанию используется официальный адрес)
Модель по умолчаниюВидеомодель, используемая по умолчаниюНет
ВключеноВключён ли данный провайдерДа

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

Шаги​

  1. Выберите функцию генерации видео
  2. Выберите провайдера и модель
  3. Введите текстовый промпт с описанием видео
  4. (Опционально) Загрузите референсное изображение (режим image-to-video)
  5. Настройте параметры генерации
  6. Нажмите Создать
  7. Дождитесь завершения асинхронной задачи

Параметры генерации​

Параметры зависят от провайдера; общие параметры включают:

ПараметрОписаниеПримечания
ПромптТекстовое описание содержимого видеоОбязательно
Референсное изображениеИзображение, используемое как начальный кадр видеоОпционально; режим image-to-video
ДлительностьПродолжительность видео в секундахЗависит от провайдера
РазрешениеРазрешение видеоНапример, 720p, 1080p
FPSКадров в секундуЗависит от провайдера

Модель асинхронного опроса​

Поскольку генерация видео обычно занимает значительное время (от десятков секунд до нескольких минут), Elftia использует механизм асинхронного опроса:

Отправить запрос на генерацию → Получить ID задачи → Периодически опрашивать статус → Задача завершена → Скачать видео

Поведение​

  1. Отправка запроса — отправляет запрос на генерацию в API провайдера и получает ID задачи
  2. Опрос статуса — система автоматически запрашивает статус задачи через регулярные интервалы (обычно каждые 5–10 секунд)
  3. Задача завершена — когда статус изменяется на «завершено», сгенерированный видеофайл скачивается автоматически
  4. Отображение результата — видео показывается в UI и доступно для воспроизведения

В процессе ожидания UI отображает текущий статус задачи и расчётное оставшееся время (если провайдер предоставляет эту информацию).

Автоматические повторные попытки​

При возникновении временной ошибки в ходе генерации система автоматически повторяет попытку:

НастройкаОписаниеПо умолчанию
Число попытокМаксимальное число повторов при сбое2
Интервал повторовИспользует экспоненциальный откатНачинается с 1 секунды

Глобальные настройки видео​

НастройкаОписаниеПо умолчанию
ПараллелизмЧисло одновременных задач генерации видео1
Число попытокАвтоматические повторы при сбое генерации2

Эти параметры можно настроить в Настройки > Медиапровайдеры > Видео > Глобальные настройки.

Руководство по выбору провайдера​

ПотребностьРекомендуемый провайдер
Высококачественное коммерческое видеоKling AI
Интеграция в экосистему OpenAIOpenAI (Sora)
Гибкий выбор моделей с открытым исходным кодомReplicate
Стабильный доступ внутри КитаяVolcEngine

Часто задаваемые вопросы​

ВопросРешение
Задача бесконечно остаётся в состоянии «ожидание»Генерация видео занимает время — пожалуйста, подождите. Высококачественные модели могут работать несколько минут
Генерация завершается с ошибкой таймаутаПровайдер может быть перегружен — повторите попытку позже
Видео не воспроизводитсяУбедитесь, что формат видео поддерживается вашей системой; попробуйте внешний плеер
Не удалось подтвердить API-ключУбедитесь, что API-ключ верный и на аккаунте достаточно квоты
Пользовательский провайдер несовместимУбедитесь, что API-интерфейс соответствует спецификации унифицированного интерфейса (формат Unified)

Связанные ссылки​