nano-banana-2 API — доступ через AI API-шлюз

nano-banana-2 — модель изображений Gemini от Google, сильная и в генерации, и в редактировании картинок, а особенно хороша в композиции из нескольких референсов (до 6 изображений). Вызывайте её через byesu — AI API-шлюз с OpenAI-совместимым API изображений: запросы маршрутизируются к официальной модели без потери качества, тарификация — за изображение, $0.025 / изображение, разрешения охватывают 1K / 2K / 4K. Та же платформа обслуживает и текстовые модели Claude, GPT-5.6, Grok и Gemini — оплата по факту использования, без подписки.

На этой странице — пример интеграции, который можно скопировать и сразу запустить. Регистрация в консоли — на byesu.com; полная документация по медиа-API — на docs.byesu.com/ru/media.

Коротко: что это и сколько стоит

• Модель: nano-banana-2 (изображения Gemini от Google) — генерация по тексту и по изображению в одной модели, с выдающейся композицией из нескольких референсов
• Цена: $0.025 / изображение, тарификация за изображение; разрешения 1K / 2K / 4K задаются через параметр size
• Как подключиться: OpenAI-совместимый API, Base URL https://byesu.com/v1, токен из группы media / media-gen

Токен должен быть в правильной группе

Токен для моделей изображений обязательно должен принадлежать группе media / media-gen, иначе вы получите ошибку «нет доступного канала». При создании токена в консоли просто выберите её в выпадающем списке «Группа». Подробнее — Выбор группы.

Как вызывать

Подготовка: получите токен

1. Откройте консоль и войдите → слева Токены → Добавить токен
2. Установите группу media / media-gen, задайте имя и квоту → отправьте
3. Скопируйте полученный токен вида sk-xxxxxxxx

Генерация по тексту (curl)

Генерация по тексту идёт через POST /v1/images/generations и синхронно возвращает PNG в виде base64:

curl https://byesu.com/v1/images/generations \
  -H "Authorization: Bearer sk-ваш-токен" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "золотистый ретривер бежит по золотому пшеничному полю на закате, кинематографично, малая глубина резкости",
    "size": "2048x1152"
  }'

Ответ:

{ "data": [ { "b64_json": "<base64 строка>" } ] }

Генерация по тексту (Python)

import base64, requests

resp = requests.post(
    "https://byesu.com/v1/images/generations",
    headers={"Authorization": "Bearer sk-ваш-токен"},
    json={
        "model": "nano-banana-2",
        "prompt": "улица дождливой ночью в стиле киберпанк, неоновые отражения, фотореалистичный 4K",
        "size": "3840x2160",   # длинная сторона ≈3840 → 4K
    },
).json()

b64 = resp["data"][0]["b64_json"]
open("out.png", "wb").write(base64.b64decode(b64))

Генерация по изображению / композиция из нескольких референсов (сильная сторона nano-banana-2)

Генерация по изображению идёт через POST /v1/images/edits в формате multipart/form-data. Референсы загружаются как файлы, а поле image можно повторять, чтобы передать несколько изображений (лимит nano-banana-2 — 6 изображений, каждое ≤8MB):

curl https://byesu.com/v1/images/edits \
  -H "Authorization: Bearer sk-ваш-токен" \
  -F model="nano-banana-2" \
  -F prompt="совместить людей с этих трёх фото в одной сцене на берегу моря, с единым освещением" \
  -F size="2048x2048" \
  -F image=@person1.png \
  -F image=@person2.png \
  -F image=@scene.png

Формат ответа такой же, как у генерации по тексту (data[0].b64_json). В Python несколько изображений передаются так: files=[("image", open(p,"rb")) for p in paths].

Ключевые параметры

Параметр	Эндпоинт	Обязателен	Описание
model	оба	✅	Всегда nano-banana-2; регистр и дефис должны совпадать точно
prompt	оба	✅	Текстовый промпт; развёрнутое описание «объект + сцена + стиль + освещение» работает лучше
size	оба		Ширина x высота в пикселях, одновременно задаёт и пропорции, и уровень разрешения: длинная сторона ≈1024 → 1K, ≈2048 → 2K, ≈3840 → 4K. Например "1024x1024" (1:1 · 1K), "2048x1152" (16:9 · 2K), "3840x2160" (16:9 · 4K). Если не указан — базовый уровень 1:1 по умолчанию
image	только edits		Поле файла референса, повторяемое для нескольких изображений; лимит nano-banana-2 — 6 изображений, каждое ≤8MB

Тарификация считает только «изображения» и не зависит от уровня разрешения: $0.025 / изображение. В консоли видна реальная списанная цена каждого вызова.

Почему стоит подключать nano-banana-2 через byesu

• Официальная модель без потери качества: запросы маршрутизируются к официальному сервису — без реверс-инжиниринга, зеркал и взломов, — поэтому качество вывода соответствует официальному
• Прозрачная цена за изображение: nano-banana-2 — $0.025 / изображение; в консоли рядом с реальной списанной ценой показана официальная прейскурантная, и вы платите только за то, что использовали
• Автовозврат при сбое: если медиа-задача не сгенерировалась, стоимость возвращается автоматически — вы не платите за брак
• Удобство мульти-референсов: нативная поддержка загрузки нескольких изображений через /v1/images/edits напрямую раскрывает сильную сторону nano-banana-2 — композицию из до 6 референсов
• Один API — все модели: тот же OpenAI-совместимый API вызывает и другие модели изображений / видео / текста — для смены модели достаточно изменить поле model
• Оплата по факту, без подписки: пополняйте баланс через USDT, Alipay или WeChat Pay и платите только за сгенерированные изображения

Полезные ссылки

• Обзор медиа-API (API изображений / видео)
• Модели и параметры генерации изображений
• Быстрый старт: подключение за 3 шага
• Выбор группы (обязательно к прочтению при создании токена)
• Регистрация в консоли / создание токена

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

Как получить доступ к API nano-banana-2?

Зарегистрируйтесь в консоли byesu, создайте токен в группе media / media-gen и вызывайте nano-banana-2 через OpenAI-совместимые эндпоинты /v1/images/generations и /v1/images/edits с Base URL https://byesu.com/v1. byesu — это AI API-шлюз: та же платформа обслуживает Claude, GPT-5.6, Grok и Gemini с оплатой по факту использования, без подписки.

Сколько стоит одно изображение через API nano-banana-2?

byesu тарифицирует nano-banana-2 по $0.025 за изображение — плата взимается за изображение независимо от уровня разрешения (1K/2K/4K). При сбое генерации средства возвращаются автоматически, а в консоли видна реальная списанная цена каждого вызова.

Как сделать композицию из нескольких референсов с помощью nano-banana-2?

Вызовите POST /v1/images/edits (формат multipart) и передайте каждый референс как файл в поле image — это поле можно повторять, чтобы загрузить несколько изображений. nano-banana-2 поддерживает до 6 референсов, каждый ≤8MB — идеально для сведения нескольких людей или элементов в одну сцену.

Можно ли использовать nano-banana-2 в Claude Code или клиентском приложении?

nano-banana-2 — модель генерации изображений: она вызывается через эндпоинты /v1/images/generations и /v1/images/edits, а не через чат-API, поэтому как чат-модель внутри Claude Code она не используется. Вызывайте её напрямую через curl/Python или выберите её в студии генерации byesu. Клиенты вроде Claude Code, Codex и Cherry Studio подключают текстовые/кодинговые модели.

Какие разрешения и пропорции поддерживает nano-banana-2?

Поддерживаются три уровня — 1K / 2K / 4K, задаваемые параметром size (ширина x высота в пикселях): длинная сторона около 1024 — это 1K, около 2048 — 2K, около 3840 — 4K. Распространённые пропорции: 1:1, 16:9, 9:16, 4:3 и 3:4 — например, 2048x1152 — это 16:9 на уровне 2K.

Что делать, если вызов nano-banana-2 возвращает «нет доступного канала»?

Почти всегда причина — неправильная группа токена. Токены для моделей изображений должны принадлежать группе media / media-gen. Создайте в консоли новый токен в этой группе и убедитесь, что model задан как nano-banana-2 (с точным регистром и дефисом) — ошибка исчезнет.