Модели в текущем каталоге
Каталог, проверенный 4 октября 2026 года, вернул такие ID изображений:
| ID модели | Первый тест | Что записать в результат |
|---|---|---|
gpt-image-2 | Общий набор на генерацию и правку | Промпт, размеры, формат и время ответа |
gpt-image-2-5 | Сравнение качества или ревизии | Отличия при том же seed или референсе |
nano-banana | Базовая точка для семейства Nano Banana | Композиция, текст на картинке, случаи сбоя |
nano-banana-2 | Более новый маршрут семейства | Следование брифу и согласованность правок |
nano-banana-pro | Кандидат, где важнее качество | Детализация, задержка, доля отказов |
В таблице нарочно нет выдуманных лимитов разрешения, цен и баллов бенчмарков. Актуальный контракт берите из документации моделей и из ответа API.
Сценарии для первого теста
| Сценарий | Кандидат для теста | Критерий приёмки |
|---|---|---|
| Быстрые концепты для команды | nano-banana-2 | Композиция попадает в brief |
| Рекламный баннер с ограничениями | nano-banana-pro | Соблюдены размеры, отступы и стиль |
| Генерация изображения в продукте | gpt-image-2 | Результат проходит автоматическую и ручную модерацию |
| Сравнение новой ревизии | gpt-image-2-5 | Она решает известную проблему лучше базовой |
Название модели не гарантирует ни типографику, ни фирменные детали. Возьмите 15 настоящих заданий и включите в них сложные: мелкий текст, человека в кадре, товар на светлом фоне, изображение с логотипом. Зафиксируйте долю результатов, которые годятся без ручной переделки.
Сначала опишите контракт изображения
«Сделай красиво» тестом не считается. Запишите тему, соотношение сторон, тип файла, текст, который обязан появиться, запрещённые элементы и признаки провала. Для бота в Telegram добавьте максимальный размер файла и время, которое пользователь готов ждать.
Если изображение правится, держите исходник рядом с тест-кейсом. Модель может хорошо генерировать и плохо сохранять логотип товара или позу человека. Это разные задачи.
Матрица сравнения
| Сценарий | Что держать неизменным | Условие успеха |
|---|---|---|
| Карточка товара | Промпт, исходный пакшот, размер холста | Форма товара и нужный текст остались верными |
| Пост для соцсети | Промпт, соотношение сторон, цвета бренда | Макет ложится в канал без ручной обрезки |
| Правка фона | Исходное изображение и инструкция правки | Края объекта пригодны для работы |
| Текст на картинке | Точный текст и направление шрифта | Нет пропавших слов и нечитаемых символов |
| Миниатюра для бота | Входной промпт и лимит размера файла | Результат приходит в пределах таймаута бота |
Каждый кейс генерируйте не один раз. Сырой ответ сохраняйте рядом с готовой картинкой: тогда упавший запрос можно воспроизвести и разобрать.
Держите границу с API узкой
ID модели лежит в конфигурации, а контракт приложения от него не зависит. Сервис изображений должен возвращать URL или бинарный результат, ID модели, размеры, MIME-тип и ошибку, которую поймёт вызывающий код.
const imageModel = process.env.IMAGE_MODEL ?? "gpt-image-2";
const result = await client.images.generate({
model: imageModel,
prompt: request.prompt,
size: request.size,
});
return {
model: imageModel,
image: result.data?.[0],
};
Точный метод и поля зависят от SDK и маршрута, которым вы пользуетесь. Проверяйте ответ, прежде чем отправлять его пользователю или класть в CMS.
Генерация изображений в боте Telegram
Отправьте короткое сообщение о ходе работы, задайте таймаут запроса и сделайте повторы идемпотентными. Если генерация упала, скажите пользователю, что произошло, и оставьте промпт для новой попытки. Баланс нельзя списывать дважды из-за того, что вебхук или сетевой повтор прислал тот же запрос.
Модерации нужны собственные тест-кейсы. Картинка может не подойти даже при безобидном промпте, а отклонённый запрос это штатное состояние продукта, которое бот обязан обработать.
Как встроить image API в процесс
Заведите отдельный ключ или хотя бы отдельный лимит на генерацию изображений. В интерфейсе продукта храните исходный prompt, ID модели и версию шаблона. Если после смены модели макеты стали хуже, вы повторите запрос и увидите, что именно изменилось.
Для пользовательского контента добавьте политику модерации, а рекламные материалы отдавайте на проверку человеку. API ускоряет производство, но за опубликованный результат отвечает команда.
Практический запуск
Начните с одной модели и небольшой доли трафика. Логируйте ID модели, длительность запроса, размер ответа и то, принял ли результат человек. Те же поля соберите у второй модели. Модель по умолчанию меняйте только после этого.
Заранее держите резерв на случай сбоя. Ему нужен формат промпта, который принимает вторая модель, либо адаптер, который этот формат переводит. Не рассчитывайте, что параметр, принятый одним семейством, примет и другое.
FAQ
Какую модель для изображений взять первой?
Начните с gpt-image-2 как с базовой точки и сравните её с gpt-image-2-5 или одним из ID Nano Banana на своих настоящих промптах. Окончательный маршрут определят живой каталог и ваши проверки приёмки.
Nano Banana Pro всегда лучше по качеству?
Название оценку не заменяет. Проверьте детализацию, текст на картинке, точность правок, время ответа и поведение при отказах на тех изображениях, которые вам нужны.
Можно ли сменить модель, не переписывая всё приложение?
Можно, если сервис изображений прячет специфичные поля модели за адаптером и проверяет результат. Держите ID модели в конфигурации, а не разбрасывайте по коду интерфейса.
Нужен ли отдельный провайдер для изображений?
Нет, если подходящая image-модель уже доступна в codexkey. Единый ключ упрощает учёт и лимиты, но качество всё равно нужно проверять на своих задачах.
Хранить ли сгенерированные картинки вечно?
Срок хранения задаёт требование продукта. В изображениях могут быть пользовательские данные, референсы или персональная информация. Сохраняйте только необходимое и закрывайте доступ к оригиналам.
Как узнать актуальный ID модели изображений?
Сверьтесь со страницей моделей или с GET /v1/models перед запуском, а ID из старого туториала без проверки не копируйте.