К содержимому
Блог

Nano Banana в России: как подключить API Relay

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. Значение ключа демонстрационное. Замените его своим секретом только в локальном опыте; в приложении передавайте ключ через защищённое серверное окружение.

python
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. Декодируйте его и сохраните байты файла, как в примере выше.

Создать аккаунт

Модели из статьи

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.