Генерация изображений
Функция генерации изображений в Elftia позволяет использовать AI для создания изображений по текстовым описаниям (промптам). Поддерживаются несколько провайдеров, пакетная генерация, настраиваемые параметры и автоматические повторные попытки при превышении лимитов запросов.
Сценарии использования
- Генерация концептуальных дизайнов, иллюстраций или художественных работ по текстовым описаниям
- Быстрая генерация справочных изображений или иллюстраций в ходе чата
- Пакетная генерация нескольких изображений и выбор лучшего результата
- Многократное использование одного промпта с разными стилями и параметрами
Поддерживаемые провайдеры
| Провайдер | Примеры моделей | Описание |
|---|---|---|
| Gemini | Gemini Vision | Мультимодальная генерация изображений от Google |
| OpenAI | DALL-E 3, DALL-E 2, gpt-image-1 | API генерации изображений OpenAI |
| Vertex AI | Imagen | Сервис генерации изображений Google Cloud |
| Пользовательский провайдер | Custom | Сторонние сервисы, совместимые с форматом OpenAI |
Настройка провайдера
Шаги
- Откройте Настройки > Медиапровайдеры > Изображения
- Выберите провайдера из списка (например, OpenAI)
- Введите API Key провайдера
- (Необязательно) Измените адрес конечной точки API (требуется для пользовательских провайдеров или прокси)
- Выберите модель по умолчанию
- Нажмите Сохранить
Таблица настроек провайдера
| Настройка | Описание | Обязательно |
|---|---|---|
| API Key | API-ключ провайдера | Да |
| Конечная точка API | Пользовательский адрес API (по умолчанию используется официальный адрес) | Нет |
| Модель по умолчанию | Модель, используемая по умолчанию при генерации | Нет |
| Включён | Включён ли данный провайдер | Да |
Генерация изображений
Шаги
- В интерфейсе чата или интерфейсе генерации медиа выберите функцию генерации изображений
- Выберите провайдера и модель
- Введите описание изображения в поле ввода промпта
- Настройте параметры генерации (см. таблицу параметров ниже)
- Нажмите кнопку Генерировать
- Дождитесь завершения генерации и просмотрите результат
Параметры генерации
| Параметр | Описание | Значения / диапазон |
|---|---|---|
| Промпт | Описывает содержание изображения, которое нужно сгенерировать | Любой текст |
| Размер | Разрешение сгенерированного изображения | Зависит от модели, напр. 1024x1024, 1792x1024 |
| Количество | Количество изображений для генерации за раз | 1–10 (зависит от ограничений провайдера) |
| Стиль | Стиль изображения | vivid, natural и др. |
| Качество | Качество изображения | standard, hd и др. |
:::tip Советы по промптам Хороший промпт должен включать следующие элементы:
- Субъект: Опишите основное содержание изображения
- Стиль: Желаемый художественный стиль (реализм, акварель, аниме и т.д.)
- Детали: Освещение, композиция, цветовая гамма и другие детали
- Негативный промпт: Элементы, которые не должны присутствовать (поддерживается некоторыми провайдерами) :::
Пакетная генерация
Elftia поддерживает пакетную генерацию изображений с контролем параллелизма, поэтому генерация нескольких изображений не перегружает API слишком большим количеством одновременных запросов.
Поведение
- Когда количество больше 1, система автоматически разбивает запросы на пакеты в соответствии с ограничением параллелизма
- Параллелизм по умолчанию равен 3; можно изменить в глобальных настройках
- Каждое изображение генерируется независимо — частичный сбой не влияет на другие изображения
Автоматические повторные попытки
При достижении лимита запросов API (ошибка HTTP 429) или других временных ошибок система автоматически повторяет попытку:
| Поведение | Описание |
|---|---|
| Количество попыток | По умолчанию 2; можно изменить в глобальных настройках |
| Интервал повторных попыток | Экспоненциальная задержка: 1 секунда при первой попытке, 2 секунды при второй, с удвоением каждый раз |
| Обработка лимитов | При обнаружении ошибки 429 применяется более длительная задержка со случайным джиттером |
Управление результатами
Сгенерированные изображения:
- Отображаются непосредственно в сообщении чата
- Автоматически сохраняются в локальной файловой системе
- Записываются в историю генерации для удобного последующего поиска
Варианты действий
- Сохранить — сохранить изображение в указанный каталог
- Копировать — скопировать изображение в буфер обмена
- Избранное — добавить изображение в коллекцию
- Регенерировать — сгенерировать снова с теми же параметрами
Добавление пользовательского провайдера
Если используемый вами API генерации изображений совместим с форматом OpenAI, вы можете добавить его как пользовательский провайдер:
- Откройте Настройки > Медиапровайдеры > Изображения
- Нажмите Добавить пользовательский провайдер
- Заполните следующие поля:
| Поле | Описание |
|---|---|
| Имя | Отображаемое имя провайдера |
| Конечная точка API | Базовый адрес API |
| API Key | Ключ аутентификации |
| Список моделей | Список доступных идентификаторов моделей |
- После сохранения провайдер можно выбирать при генерации изображений
Часто задаваемые вопросы
| Вопрос | Решение |
|---|---|
| Запрос на генерацию возвращает 401 | API-ключ недействителен или истёк — проверьте и обновите его |
| Запрос на генерацию возвращает 429 | Достигнут лимит запросов API — система повторяет попытку автоматически; можно также повторить позже |
| Не все варианты размера доступны | Разные модели поддерживают разные размеры — проверьте список поддерживаемых размеров для выбранной модели |
| Пользовательский провайдер не работает | Убедитесь, что формат конечной точки API правильный и API совместим с форматом генерации изображений OpenAI |
| Часть изображений не сгенерирована при пакетной генерации | Проверьте, достаточно ли квоты API; единичный сбой не влияет на другие изображения |
Связанные ссылки
- Обзор генерации медиа — Обзор всех типов медиа
- Генерация видео — Создание видео с помощью AI
- Настройка LLM-провайдеров — Конфигурация текстовых моделей (отдельно от медиапровайдеров)