Google · Картинки · API

Nano Banana API — цены в рублях и подключение за 5 минут

Nano Banana API (Gemini Image) в рублях: генерация и правки картинок через один ключ Zerocoder. Цена за изображение, формат OpenAI Images, примеры кода, лимиты.

Получить API-ключ Nano Banana в студии без кода →Документация

Что такое Nano Banana

Nano Banana — семейство моделей Google (Gemini) для генерации и редактирования изображений. В линейке пять моделей: nano-banana, nano-banana-2-lite, nano-banana-2, nano-banana-pro, nano-banana-pro-vip (короткие алиасы gemini-3-flash и gemini-3-pro). Модели различаются качеством и ценой за запрос — от самой дешёвой до самой дорогой в семействе, подробности смотрите в GET /v1/models.

Что даёт подключение через Zerocoder

Один API-ключ и один рублёвый кошелёк работают сразу со всеми моделями каталога. Пополнение — картой РФ или по счёту для юрлица, без VPN и зарубежных карт. Документация и выпуск ключей — в личном кабинете API. Запросы совместимы с привычными SDK для HTTP-клиентов на любом языке.

Как устроен запрос

Для генерации с нуля используется POST /v1/images/generations: передаёте model, текстовый prompt и желаемый size или aspect. Для правки существующей картинки — POST /v1/images/edits: prompt, model и исходное изображение (или до четырёх изображений). В ответ приходит временная ссылка на результат, её нужно скачать сразу после получения. Текущий баланс кошелька можно проверить через GET /v1/balance.

Доступные модели и цены

Таблица строится из живого прайса GET /v1/models: цены уже с наценкой, в рублях и в долларах по внутреннему курсу. Что пропало из таблицы — временно не отдаёт шлюз.

Модель	Единица	₽	$	Примеры стоимости	Endpoint
`gemini-image-2`рекомендуемтакже: nano-banana-2, gemini-3-flash	за картинку	2,4 ₽	$0.027	1 генерация: 2,4 ₽ · $0.027 10 генераций: 24 ₽ · $0.267	`/v1/images/generations`
`gemini-image-pro`рекомендуемтакже: nano-banana-pro, gemini-3-pro	за картинку	2,64 ₽	$0.029	1 генерация: 2,64 ₽ · $0.029 10 генераций: 26,4 ₽ · $0.293	`/v1/images/generations`
`gemini-image`рекомендуемтакже: nano-banana, unspecified	за картинку	0,96 ₽	$0.011	1 генерация: 0,96 ₽ · $0.011 10 генераций: 9,6 ₽ · $0.107	`/v1/images/generations`
`nano-banana-2-lite`рекомендуем	за картинку	1,2 ₽	$0.013	1 генерация: 1,2 ₽ · $0.013 10 генераций: 12 ₽ · $0.133	`/v1/images/generations`
`nano-banana-pro-vip`рекомендуем	за картинку	9,6 ₽	$0.107	1 генерация: 9,6 ₽ · $0.107 10 генераций: 96 ₽ · $1.07	`/v1/images/generations`

Калькулятор стоимости

Выберите модель и объём — калькулятор считает по тем же формулам, что биллинг API.

МодельКоличество картинок 10

за картинку2,4 ₽ $0.027

в месяц · 1024 ₽ $0.267

Цены из GET /v1/models, курс — внутренний. Неудачная генерация не списывается.

Первый запрос

Один ключ zc-sk-…, заголовок x-api-key (или Authorization: Bearer), база https://zerocoder.com/api/v1. Примеры собраны из реальных контрактов маршрутов.

Создайте ключ

В кабинете → API: пополните баланс в рублях и создайте ключ zc-sk-…

Отправьте запрос

Скопируйте пример ниже — id модели уже подставлен из прайса.

Проверьте списание

GET /v1/balance покажет баланс; цена вызова приходит в ответе.

cURLPythonNode.jsmodel: gemini-3-flash

curl https://zerocoder.com/api/v1/images/generations \
  -H "x-api-key: zc-sk-…" -H "content-type: application/json" \
  -d '{"model": "gemini-3-flash", "prompt": "Studio photo of a ceramic coffee mug on a walnut table, soft window light", "aspect": "1:1"}'
# → {"created":…,"data":[{"url":"https://…"}]}   (the URL is temporary — download it)

import requests

r = requests.post("https://zerocoder.com/api/v1/images/generations",
    headers={"x-api-key": "zc-sk-…"},
    json={"model": "gemini-3-flash", "prompt": "Studio photo of a ceramic coffee mug on a walnut table, soft window light", "aspect": "1:1"})
r.raise_for_status()
print(r.json()["data"][0]["url"])

const r = await fetch("https://zerocoder.com/api/v1/images/generations", {
  method: "POST",
  headers: { "x-api-key": "zc-sk-…", "content-type": "application/json" },
  body: JSON.stringify({ model: "gemini-3-flash", prompt: "Studio photo of a ceramic coffee mug on a walnut table, soft window light", aspect: "1:1" }),
});
const { data } = await r.json();
console.log(data[0].url);

Редактирование картинок (/images/edits)

# JSON — image(s) by https URL or data URI, up to 4
curl https://zerocoder.com/api/v1/images/edits \
  -H "x-api-key: zc-sk-…" -H "content-type: application/json" \
  -d '{"model": "gemini-3-flash", "prompt": "Make it a night scene", "image": "https://example.com/photo.jpg", "aspect": "16:9"}'

# multipart — files from disk (≤ 8 MB each)
curl https://zerocoder.com/api/v1/images/edits \
  -H "x-api-key: zc-sk-…" \
  -F model=gemini-3-flash -F prompt="Make it a night scene" -F aspect=16:9 \
  -F "image[]=@photo1.jpg" -F "image[]=@photo2.jpg"

Nano Banana в студии без кода →Документация

Входные материалы, лимиты и возврат денег

Генерация: prompt + aspect 1:1 / 16:9 / 9:16 / 4:3 / 3:4 или size 1024x1024 / 1792x1024 / 1024x1792
Редактирование: до 4 картинок — https-ссылки, data URI или multipart
До 8 МБ на файл, до 48 МБ на запрос (иначе 413)
Ссылка на результат временная — сохраняйте файл сразу
Сбой провайдера — ничего не списывается
30 запросов в минуту на ключ (все ручки вместе)

Ответы с ошибками и возвраты

# 401 {"type":"error","error":{"type":"authentication_error","message":"Invalid or revoked API key."}}
# 402 {"type":"error","error":{"type":"billing_error","message":"Not enough API balance: …"}}
# 429 {"type":"error","error":{"type":"rate_limit_error","message":"…"}}   ← 30 requests/min per key
# 400 {"type":"error","error":{"type":"invalid_request_error","message":"Unknown model \"…\". See GET /v1/models."}}
# 413 {"type":"error","error":{"type":"invalid_request_error","message":"…"}}   ← > 8 MB per file / > 48 MB body
# 502 {"type":"error","error":{"type":"api_error","message":"…"}}                ← provider failed → nothing charged

Сценарии использования

Генератор обложек и превью для блога или маркетплейса, который вызывает /v1/images/generations по шаблону из CMS

Мобильное приложение для стилизации пользовательских фото через /v1/images/edits с загрузкой исходника

Telegram-бот, который рисует иллюстрации по текстовому описанию пользователя

Внутренний инструмент дизайн-команды для быстрой генерации вариантов макетов перед финальной отрисовкой

Пайплайн e-commerce, который автоматически меняет фон и ретуширует карточки товаров

SaaS-конструктор презентаций, подставляющий сгенерированные изображения в слайды по запросу пользователя

Как готовить промт

Опишите композицию и план кадра: что на переднем плане, что на фоне, ракурс — модель лучше держит сцену, когда план задан явно
Укажите стиль и материалы прямо в prompt: техника, фактура поверхностей, референс по визуальному языку
Добавьте описание света: направление, мягкость теней, цветовую температуру — это сильно влияет на итоговое настроение кадра
Выбирайте aspect под задачу: 16:9 для баннеров и обложек, 9:16 для историй и мобильных экранов, 1:1 для карточек товара
В /v1/images/edits формулируйте правку точечно: что заменить и что оставить без изменений, чтобы остальная часть изображения не пересобиралась

Реальные результаты

Работы пользователей Zerocoder, сделанные этой моделью: превью, разрешение, длительность и дата. Ничего не сгенерировано специально для страницы.

Ultra-realistic black and white studio portrait of the uploaded man, wearing a p

Используя прикреплённое референс-фото только как основу для лица, сохрани 100% с

Любительское вечернее фото в помещении, ощущение спонтанного кадра. Девушка сиди

Ультраблизкий гиперреалистичный портрет, фотореализм, документальная подача, све

Реалистичное ночное фото с телефона, 9:16. Камера находится сзади чёрного Merced

Не меняя внешности мужчины с фото ни на 1% Кинематографичный снимок привлекатель

Фотореалистичная черно-белая спортивная фотография в профессиональном боксерском

Модель	Дата	Лайки	Промт
Nano Banana 2	4 сентября 2026 г.	87	Ultra-realistic black and white studio portrait of the uploaded man, wearing a perfectly tailored black suit, white dress shirt and black ti
Nano Banana	23 июля 2026 г.	32	Используя прикреплённое референс-фото только как основу для лица, сохрани 100% сходство внешности. В кадре ровно четыре человека: один задер
Nano Banana	30 июля 2026 г.	29	Используя прикреплённое референс-фото только как основу для лица, сохрани 100% сходство внешности без изменений. Парень идёт в сторону полно
Nano Banana 2	12 августа 2026 г.	25	Реалистичное ночное фото с телефона, 9:16. Камера находится сзади чёрного Mercedes-Benz G63 AMG и направлена сверху вниз через открытое води
Nano Banana 2	2 сентября 2026 г.	22	Любительское вечернее фото в помещении, ощущение спонтанного кадра. Девушка сидит на полу или низком пуфе среди больших роскошных букетов ро
Nano Banana	9 августа 2026 г.	15	Не меняя внешности мужчины с фото ни на 1% Кинематографичный снимок привлекательного мужчины одет в брюки и рубашку мультикам без татуировок
Nano Banana 2	9 августа 2026 г.	13	Ультраблизкий гиперреалистичный портрет, фотореализм, документальная подача, сверхдетализация кожи, глаз, ресниц и текстуры ткани Черно- бел
Nano Banana 2	28 августа 2026 г.	9	Фотореалистичная черно-белая спортивная фотография в профессиональном боксерском зале. Современный ринг, канаты на заднем плане, индустриаль

Гайды и разборы

Midjourney против Nano Banana: что выбрать дизайнеру в 2026

GPT-5, Claude Opus 4.8 и Gemini: какую нейросеть брать под конкретную задачу

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

Чем Nano Banana Pro отличается от обычной?

Pro — более крупная модель: точнее следует сложным промтам, лучше рисует текст и мелкие детали, стоит дороже за картинку. Обычная и Lite версии — для массовой генерации и черновиков.

Можно ли редактировать свои фотографии через Nano Banana API?

Да — через /api/v1/images/edits: передайте одну или несколько картинок (https-ссылки, data URI или multipart) и инструкцию. Модель сохраняет композицию и персонажа, меняя только то, что попросили.

Как получить ключ к Nano Banana API?

Зарегистрируйтесь на Zerocoder, откройте раздел API в кабинете и создайте ключ формата zc-sk-…. Этот же ключ открывает Nano Banana и все остальные модели каталога — отдельный ключ под Nano Banana не нужен.

Как оплачивается Nano Banana API?

Пополняете API-баланс в рублях с карты российского банка или по счёту для юрлиц. Списание за каждую картинку Nano Banana по цене из GET /v1/models; цены Nano Banana уже включают наценку, скрытых комиссий нет.

Что будет, если Nano Banana не сгенерировал картинку?

Если генерация Nano Banana упала у провайдера — списание возвращается на баланс автоматически, в ответе будет refunded: true. Вы платите только за готовый картинку.

Какие лимиты у Nano Banana API?

Лимит общий для ключа — 30 запросов в минуту на все генерирующие ручки, включая Nano Banana. При превышении приходит 429 rate_limit_error; для больших нагрузок на Nano Banana напишите нам — лимит поднимается индивидуально.

Нужен ли VPN или зарубежная карта для Nano Banana API?

Нет. Запросы к Nano Banana идут на zerocoder.com, оплата в рублях, закрывающие документы для бухгалтерии — по запросу.

Можно ли попробовать Nano Banana без кода?

Да: Nano Banana доступен в студии Zerocoder и в бесплатных инструментах каталога — проверьте качество руками, а потом подключайте Nano Banana API.

API нейросетей для ваших продуктов

Оплата в рублях, без VPN, дешевле официальных API на 70 %

Получить API-ключ Открыть API