Генерация видео
Функция генерации видео в Elftia позволяет создавать короткие видеоролики на основе текстовых описаний или референсных изображений с помощью AI. Она интегрирует несколько крупных провайдеров генерации видео и использует асинхронную модель опроса для обработки ресурсоёмкого процесса рендеринга.
Сценарии использования
- Генерация коротких видеоклипов по текстовым описаниям
- Преобразование статичных изображений в динамическое видео (image-to-video)
- Быстрое создание креативного видео для социальных сетей или презентаций
- Сравнение результатов генерации у разных провайдеров
Поддерживаемые провайдеры
| Провайдер | Особенности | Тип API |
|---|---|---|
| Kling AI | Высококачественная генерация видео; поддержка нескольких разрешений | Async API |
| OpenAI (Sora) | Модель генерации видео от OpenAI | Async API |
| Replicate | Платформа хостинга моделей с открытым исходным кодом с широким выбором моделей | Async API |
| VolcEngine | Сервис генерации видео Volcengine | Async API |
| Wan | Генерация видео Wan | Async API |
| Custom (Unified) | Сторонние сервисы, совместимые с унифицированным интерфейсом | Async API |
Настройка провайдера
Шаги
- Откройте Настройки > Медиапровайдеры > Видео
- Выберите провайдера
- Введите API Key (некоторые провайдеры также требуют Access Key или иную аутентификацию)
- (Опционально) Укажите пользовательский эндпоинт API
- Выберите модель по умолчанию
- Сохраните и включите
Таблица конфигурации провайдера
| Настройка | Описание | Обязательно |
|---|---|---|
| API Key | API-ключ провайдера | Да |
| Эндпоинт API | Пользовательский адрес API | Нет (по умолчанию используется официальный адрес) |
| Модель по умолчанию | Видеомодель, используемая по умолчанию | Нет |
| Включено | Включён ли данный провайдер | Да |
Генерация видео
Шаги
- Выберите функцию генерации видео
- Выберите провайдера и модель
- Введите текстовый промпт с описанием видео
- (Опционально) Загрузите референсное изображение (режим image-to-video)
- Настройте параметры генерации
- Нажмите Создать
- Дождитесь завершения асинхронной задачи
Параметры генерации
Параметры зависят от провайдера; общие параметры включают:
| Параметр | Описание | Примечания |
|---|---|---|
| Промпт | Текстовое описание содержимого видео | Обязательно |
| Референсное изображение | Изображение, используемое как начальный кадр видео | Опционально; режим image-to-video |
| Длительность | Продолжительность видео в секундах | Зависит от провайдера |
| Разрешение | Разрешение видео | Например, 720p, 1080p |
| FPS | Кадров в секунду | Зависит от провайдера |
Модель асинхронного опроса
Поскольку генерация видео обычно занимает значительное время (от десятков секунд до нескольких минут), Elftia использует механизм асинхронного опроса:
Отправить запрос на генерацию → Получить ID задачи → Периодически опрашивать статус → Задача завершена → Скачать видео
Поведение
- Отправка запроса — отправляет запрос на генерацию в API провайдера и получает ID задачи
- Опрос статуса — система автоматически запрашивает статус задачи через регулярные интервалы (обычно каждые 5–10 секунд)
- Задача завершена — когда статус изменяется на «завершено», сгенерированный видеофайл скачивается автоматически
- Отображение результата — видео показывается в UI и доступно для воспроизведения
В процессе ожидания UI отображает текущий статус задачи и расчётное оставшееся время (если провайдер предоставляет эту информацию).
Автоматические повторные попытки
При возникновении временной ошибки в ходе генерации система автоматически повторяет попытку:
| Настройка | Описание | По умолчанию |
|---|---|---|
| Число попыток | Максимальное число повторов при сбое | 2 |
| Интервал повторов | Использует экспоненциальный откат | Начинается с 1 секунды |
Глобальные настройки видео
| Настройка | Описание | По умолчанию |
|---|---|---|
| Параллелизм | Число одновременных задач генерации видео | 1 |
| Число попыток | Автоматические повторы при сбое генерации | 2 |
Эти параметры можно настроить в Настройки > Медиапровайдеры > Видео > Глобальные настройки.
Руководство по выбору провайдера
| Потребность | Рекомендуемый провайдер |
|---|---|
| Высококачественное коммерческое видео | Kling AI |
| Интеграция в экосистему OpenAI | OpenAI (Sora) |
| Гибкий выбор моделей с открытым исходным кодом | Replicate |
| Стабильный доступ внутри Китая | VolcEngine |
Часто задаваемые вопросы
| Вопрос | Решение |
|---|---|
| Задача бесконечно остаётся в состоянии «ожидание» | Генерация видео занимает время — пожалуйста, подождите. Высококачественные модели могут работать несколько минут |
| Генерация завершается с ошибкой таймаута | Провайдер может быть перегружен — повторите попытку позже |
| Видео не воспроизводится | Убедитесь, что формат видео поддерживается вашей системой; попробуйте внешний плеер |
| Не удалось подтвердить API-ключ | Убедитесь, что API-ключ верный и на аккаунте достаточно квоты |
| Пользовательский провайдер несовместим | Убедитесь, что API-интерфейс соответствует спецификации унифицированного интерфейса (формат Unified) |
Связанные ссылки
- Обзор медиагенерации — обзор всех типов медиа
- Генерация изображений — создание изображений с помощью AI
- Генерация музыки — создание музыки с помощью AI