Nano Banana: как пользоваться генерацией изображений по API
Nano Banana: как пользоваться моделью из приложения? Создайте ключ Relay, выберите модель изображений в каталоге и отправьте описание на POST /v1/images/generations. В ответе придут байты изображения в base64. Их нужно декодировать и сохранить в файл. Ниже полный пример первого запроса, порядок проверки картинки и разбор ошибок.
Это руководство про API. Оно не описывает кнопки сайта Google и не подключает к нему аккаунт.
Коротко
Передайте точный идентификатор модели, а не название Nano Banana.
Прочитайте
data[0].b64_json: Relay возвращает изображение без ссылки.Начните с
n=1, чтобы проверить запрос до серии генераций.
Как пользоваться Nano Banana и выбрать модель
Откройте каталог и найдите nano-banana-2. В публичном каталоге есть также nano-banana и nano-banana-pro. Это разные записи; не приписывайте суффикс к имени произвольно. Проверьте протокол openai_images, доступность и цену выбранной карточки.
Запрос «как пользоваться Nano Banana Pro» требует ещё одной проверки: маркетинговое имя в стороннем интерфейсе не определяет идентификатор Relay. Выбирайте вариант по карточке и параметрам задачи. Статья не утверждает, что любая модель с похожим названием равна версии Pro из другого сервиса.
Создайте отдельный ключ в кабинете. Секрет показывается один раз. Сохраните его в хранилище секретов серверного приложения, а для первого опыта используйте локальный скрипт. Не передавайте ключ посетителю сайта вместе с JavaScript.
Как описать сцену, чтобы проверить результат
Для первого изображения задайте один предмет и простой фон. Например: «Стеклянная бутылка лимонада без этикетки на светлом каменном столе, вид спереди, рассеянный дневной свет, без текста». Здесь можно отдельно проверить предмет, поверхность, ракурс и отсутствие надписей.
Уберите оценки «стильно», «премиально» и «идеально», если за ними нет конкретного признака. Вместо «красивая композиция» укажите, где стоит предмет и сколько места оставить вокруг. Если нужен баннер с заголовком, попросите пустую область под него, а сам текст добавьте в редакторе.
Слишком длинное описание может содержать противоречия: вид сверху и вид спереди, крупный предмет и много окружения. Выберите один ракурс. Сохраните исходный текст, чтобы в следующей попытке менять конкретное условие.
Как отправить запрос и сохранить изображение
Пример использует Python и пакет openai, который должен быть доступен в вашей среде. Ключ в коде вымышленный: замените его локально своим секретом, не коммитьте изменённый файл. Рабочее приложение должно читать ключ из секретов окружения.
import base64
from pathlib import Path
from openai import OpenAI
client = OpenAI(
api_key="sk-demo-not-a-real-key",
base_url="https://relay-llm.ru/v1",
)
result = client.images.generate(
model="nano-banana-2",
prompt="Стеклянная бутылка без этикетки на светлом столе, без текста",
n=1,
)
if not result.data or not result.data[0].b64_json:
raise RuntimeError("В ответе нет байтов изображения")
image_bytes = base64.b64decode(result.data[0].b64_json, validate=True)
Path("nano-banana.image").write_bytes(image_bytes)Расширение .image здесь намеренно не задаёт формат. Откройте файл просмотрщиком, который определяет формат по содержимому, или проверьте его командой file nano-banana.image. После проверки можно дать файлу подходящее расширение. Декодирование base64 само по себе не преобразует JPEG в PNG.
Не добавляйте response_format="url": Images API Relay описывает ответ в b64_json. Если вы получили JSON, но файл пуст, сначала проверьте наличие этого поля и успешное декодирование.
Что делать, если генерация не удалась
При 401 проверьте секрет и состояние ключа. При 404 model_not_found скопируйте идентификатор заново из каталога. При 400 проверьте тип модели и параметры тела; текстовая модель не подходит для Images API. При 402 прочитайте код: нехватка баланса и исчерпанный лимит ключа требуют разных действий.
Сохраните HTTP-статус, тело ошибки и заголовок x-request-id для обращения в поддержку. Секрет в сообщение не включайте. Если клиент потерял соединение, не запускайте копию сразу: генерация может завершиться со списанием. Сначала проверьте историю запросов.
Как оценить картинку и расходы
Откройте результат в размере, в котором его увидит читатель. Проверьте силуэт предмета, фон и случайный текст. Для товара сравните форму и детали с настоящей фотографией: модель может придумать крышку, этикетку или фактуру.
Цена генерации зависит от модели и числа полученных изображений. Возьмите цену в карточке или на странице цен, а фактическое списание посмотрите в кабинете. Для серии отдельно считайте принятые и отклонённые варианты: стоимость пригодного изображения включает расходы на брак.
Как пользоваться Nano Banana без программы?
Этот пример требует скрипта и API-ключа. Для ручного интерфейса проверьте возможности выбранного приложения; ключ Relay не открывает сторонний сайт.
Можно ли заменить model на Nano Banana Pro?
Нет. Параметр принимает точный идентификатор каталога. Название версии в поиске не заменяет запись модели.
Почему в ответе нет URL картинки?
Relay возвращает data[].b64_json. Декодируйте строку и сохраните байты, как в примере.
Оплачивается ли повтор после обрыва соединения?
Успешная генерация может завершиться и после отключения клиента. Проверьте историю, прежде чем отправлять повторный запрос.