Nano Banana API: генерация изображений для приложения

Какую модель Nano Banana выбрать

Выберите модель под качество и бюджет: сравните ставки за изображение в таблице ниже, затем проверьте результат на своей задаче. Для массовой генерации есть гайд по очереди и бюджету и готовый ComfyUI workflow.

Nano Banana — название семейства моделей изображений Gemini. В API используется конкретный ID: базовая Nano Banana — gemini-2.5-flash-image, Nano Banana 2 — gemini-3.1-flash-image, Nano Banana Pro — gemini-3-pro-image. Доступность и параметры проверяйте в каталоге и документации перед интеграцией.

Сравнивайте результат на своих задачах: предметная фотография для карточки товара, обложка, иллюстрация или редактирование исходного изображения. Не считайте цену единственным критерием: важны допустимый размер, точность инструкции и число повторных генераций.

Актуальные цены Nano Banana в API429

Планируете серию генераций? В сравнении цен Nano Banana и GPT Image 2 API собраны одинаковые режимы Google, OpenRouter, Replicate, fal и Kie, а также расчёт на 10 000 изображений.

Nano Banana в ComfyUI: готовые workflow

Для карточек товаров и серий изображений можно использовать узлы API429 в ComfyUI: генерацию по тексту, редактирование одного референса, последовательную очередь и просмотр текущих ставок. Веса моделей скачивать не нужно; результат передаётся в стандартный IMAGE и Save Image.

Установка ComfyUI-интеграции и пример результата на Mac · Скачать workflow.

Живой запуск подтверждён для Nano Banana 2 по тексту. Новые сценарии редактирования и очереди проверены локально. Очередь ограничивает число изображений, а фактическую стоимость нужно оценивать по модели, размеру и дополнительным операциям.

Для запуска серии используйте гайд массовой генерации изображений: очередь на Python, бюджет и обработка таймаутов.

Как получить ключ и выполнить первый запрос

Создайте ключ в кабинете API429 и проверьте баланс. Через GET /v1/models убедитесь, что нужный ID доступен вашему ключу. В этом примере используется Nano Banana 2; замените ID, если вашему ключу доступна другая модель.

curl https://gateway.api429.com/v1/images/generations \
  -H "Authorization: Bearer $API429_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image",
    "prompt": "Предметная фотография керамической чашки на светлом столе, без текста",
    "n": 1,
    "size": "1024x1024",
    "response_format": "b64_json"
  }'

Ключ задайте в переменной окружения API429_API_KEY. Запрос создаёт платное изображение по тарифу модели. Формат b64_json предназначен для получения данных изображения в ответе; обработайте их на сервере и сохраните файл. Полный контракт доступен в документации.

Генерация и редактирование — разные операции

Для создания изображения по тексту применяется /v1/images/generations. Для изменения исходной картинки проверьте поддержку image_editing и формат /v1/images/edits. Поддержка генерации сама по себе не означает, что та же модель принимает любой формат редактирования.

Что учитывать в рабочем приложении

• Храните ключ на сервере. Пользовательский браузер должен обращаться к вашему приложению, а не получать секрет шлюза.
• Обрабатывайте отказ генерации и пустой ответ. Нельзя считать успешным результатом только HTTP-статус.
• После таймаута проверьте состояние операции и списание перед повтором: новая попытка может создать ещё одно платное изображение.
• Перед публикацией проверьте текст, лица, детали товара и соответствие исходному заданию. Генерация не гарантирует точность этих элементов.

Nano Banana 2 Batch API: как организовать серию изображений

Серия отдельных запросов генерации и пакетная задача Batch API — разные режимы. Для обычной очереди храните ID своей задачи, выбранную модель, состояние и результат каждого изображения. Ограничьте число одновременных запросов и повторяйте только задачи с известным неуспешным исходом.

Если нужен именно серверный Batch API, заранее согласуйте поддержку выбранной image-модели, входной формат, лимиты и тариф. Наличие /v1/batches не означает, что любой запрос /v1/images/generations можно отправить пакетом; скидку прямого Google Batch нельзя автоматически переносить на тариф API429. Форматы Google и варианты подключения описаны на странице Vertex AI / Gemini API.

Частые вопросы

Можно ли купить ключ один раз и генерировать без ограничений?

Ключ идентифицирует доступ к аккаунту. Генерация оплачивается по использованию и ограничена доступностью модели, балансом и лимитами.

Чем API429 отличается от прямого Gemini API?

Это независимый шлюз с собственным ключом, адресом и биллингом. Возможности и форматы Google описаны в документации Gemini; совместимость конкретного запроса с API429 проверяйте по документации шлюза.