Nano Banana в России: как подключить API Relay
Nano Banana в России можно использовать в своём приложении через API Relay, выбрав модель изображений из каталога. Для этого нужны аккаунт Relay, API-ключ и запрос на Images API. Relay не выдаёт аккаунт Google, не открывает сторонний сайт и не подключает подписку Nano Banana Pro. Результат API-вызова вы сохраняете у себя.
Начните с одного изображения, чтобы проверить доступ и формат ответа. Способы и условия пополнения смотрите на странице цен и в кабинете: наличие способа оплаты в статье не гарантировало бы его доступность в момент платежа.
Коротко
Ключ Relay работает на API Relay и не заменяет ключ другого сервиса.
Проверяйте точное имя модели, протокол и цену в каталоге.
Сохраняйте байты из
b64_json, а не ожидайте ссылку на картинку.
Как использовать Nano Banana в России через Relay
Сначала откройте каталог и найдите подходящую модель. В публичном каталоге есть nano-banana, nano-banana-2 и nano-banana-pro. У них указан протокол openai_images. Копируйте полный идентификатор карточки, не добавляя суффикс от себя.
Создайте аккаунт, подтвердите почту и откройте API-ключи. Создайте отдельный ключ для генерации. Секрет показывается один раз; сохраните его до закрытия окна. Если потеряли секрет, используйте перевыпуск, а не пытайтесь восстановить его из маски в списке.
При необходимости пополните баланс через кабинет. Проверьте итоговую сумму, комиссию и условия выбранного метода до подтверждения. Баланс аккаунта и лимит ключа различаются: все ключи расходуют общие средства, но для конкретного ключа можно задать собственный предел расходов.
Почему название Pro не определяет API-модель
Запросы «как использовать Nano Banana Pro в России» и «как пользоваться Nano Banana Pro в России» часто относятся к интерфейсу стороннего продукта. В API параметр model принимает запись каталога Relay. Нельзя заменить её словами Nano Banana Pro и ожидать тот же набор функций.
Сначала определите задачу: генерация по тексту, работа с исходной картинкой или ручное редактирование в приложении. Пример ниже выполняет только генерацию по тексту. Если вам нужно загрузить фото и изменить конкретный участок, проверьте поддержку такого сценария отдельно; наличие модели в каталоге не обещает все функции стороннего редактора.
Relay предоставляет адрес API. Из этого не следует обещание работы любого сайта «без VPN» или доступности стороннего аккаунта: сетевой маршрут клиента и правила другого сервиса проверяются отдельно.
Как сохранить первое изображение
Пример использует Python SDK openai с базовым адресом https://relay-llm.ru/v1. Значение ключа демонстрационное. Замените его своим секретом только в локальном опыте; в приложении передавайте ключ через защищённое серверное окружение.
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("Изображение отсутствует в ответе")
Path("first-image.bin").write_bytes(
base64.b64decode(result.data[0].b64_json, validate=True)
)Расширение .bin не означает, что изображение испорчено. Определите реальный формат по содержимому, например командой file first-image.bin, затем задайте нужное расширение. Relay возвращает data[].b64_json, поля с URL в этом ответе нет. Подробности маршрута есть в документации Images API.
Что проверить при отказе или потере ответа
401 указывает на проблему ключа: проверьте копирование секрета, состояние и срок действия. 404 model_not_found требует сверки идентификатора с каталогом. При 400 проверьте тело запроса и тип модели. Не меняйте адрес на API Google: ключ Relay предназначен для другого сервиса.
При 402 прочитайте код ошибки. insufficient_balance относится к доступным средствам, key_limit_exceeded к лимиту ключа, new_account_limit к ограничениям нового аккаунта. Пополнение не исправляет каждый из этих случаев одинаково. Порядок проверки описан в документации ошибок.
Если соединение оборвалось после отправки, сначала проверьте историю запросов. Генерация не отменяется простым закрытием клиента; успешный результат может быть списан. Для поддержки сохраните x-request-id, время и статус, а секрет удалите из снимков экрана.
Как подготовиться к серии генераций
Откройте первое изображение и проверьте предметы, подписи и фон. Если тетрадь выглядит как книга или карандашей несколько, уточните это в следующем описании. Не запускайте большую очередь, пока не получили подходящий одиночный результат.
Проверьте цену конкретной модели и выставьте лимит расходов ключа. Стоимость серии оценивайте по числу полученных изображений, а полезность по числу принятых. Сохраняйте prompt рядом с результатом: так можно повторить удачную сцену и найти причину брака.
Даёт ли Nano Banana в России через Relay доступ к сайту Google?
Нет. Вы получаете программный доступ через API Relay. Аккаунт и функции сайта Google настраиваются отдельно.
Как пользоваться Nano Banana Pro в России с ключом Relay?
Выберите запись модели в каталоге. Если нужен именно сторонний интерфейс Pro, этот API-ключ сам по себе его не подключает.
Можно ли заранее узнать способы оплаты?
Проверьте страницу цен и доступные методы в кабинете. Итоговую сумму и комиссию смотрите до подтверждения платежа.
Почему вместо ссылки пришёл длинный текст?
Это base64 в поле b64_json. Декодируйте его и сохраните байты файла, как в примере выше.