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

Обновление, октябрь 2026. Генерация изображений через Zukko временно недоступна. Актуальный список моделей — страница «Модели»↗ или GET https://api.zukko.pro/v1/models. Ближайшая замена: пока нет — сейчас в Zukko доступны только текстовые модели.

Изображения живут на отдельном эндпоинте — текстовые модели идут через /v1/chat/completions или /v1/messages, картинки через /v1/images/generations. Тарификация тоже другая: не за токены, а за готовое изображение.

Минимальный запрос

curl https://api.zukko.pro/v1/images/generations \
  -H "Authorization: Bearer fetch_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2-text-to-image",
    "prompt": "Схема архитектуры микросервиса, плоская графика, светлый фон"
  }'

Эндпоинт совместим с форматом OpenAI, поэтому клиентская библиотека, умеющая работать с генерацией изображений, подключается сменой базового адреса.

Три режима, три модели

Режим задаётся не параметром, а выбором модели — это важно, потому что перепутать легко.

Поле images принимает массив ссылок или data URL. Для режима редактирования это исходная картинка, для reference — образец стиля или композиции.

Сколько стоит картинка

Цена фиксированная за изображение, длина промпта на неё не влияет.

Версии с суффиксом developer дешевле вдвое. Линейка lite — ещё дешевле и заметно быстрее; на простой графике разница в результате небольшая, на сложных сценах видна.

Практический вывод: подбирать промпт стоит на lite-версии, а финальный прогон делать на обычной. Десять итераций подбора на lite обходятся в 28 центов против 80.

Чего ожидать не стоит

Модель генерации изображений плохо работает с текстом внутри картинки: надписи получаются с ошибками, и это свойство класса моделей, а не конкретной. Если в макете нужен читаемый текст, надёжнее оставить под него место и положить надпись отдельным слоем.

Точное воспроизведение по нескольким образцам одновременно тоже даётся тяжело. Reference-режим хорошо переносит общий стиль и хуже — конкретные детали.

Подключение

Ключ и адрес те же, что для текстовых моделей: https://api.zukko.pro/v1 для OpenAI-совместимых клиентов, ключ вида fetch_... в заголовке Authorization: Bearer. Список доступных моделей отдаёт /v1/models, а цены и лимиты — /v1/models/info (или страница «Модели» в кабинете).