← Все статьи

Nano Banana API: image generation without a VPN or a foreign card

Nano Banana API: image generation without a VPN or a foreign card

Коротко о главном (BLUF)

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

Last week I needed to generate a hundred product cards for a marketplace. Doing it by hand in a web UI — shoot me. And foreign image APIs either won't take a Russian card or demand a VPN and a dollar wallet. Then it turned out NeuralSpace now has its own API for the Nano Banana model. Set it up in one evening, and I pay in rubles from my balance. Here's how it works.

What Nano Banana is, and why this one

Nano Banana is an image model from Google (Gemini 2.5 Flash under the hood). Fast, cheap, holds text on the picture reasonably well and understands references. There are two versions: regular and Pro. The regular one draws in a couple of seconds and costs pennies — grab it for drafts, icons, thumbnails. Pro outputs up to 4K and is more careful with detail — for final layouts and print.

The main trick isn't the model itself, but the fact that you can reach it from code. No browser, no manual copy-paste. Your script sends the prompt and grabs the link to the finished image.

Set up in five minutes

POST /v1/images/generations endpoint with a curl example for the Nano Banana image API

First, create a key. Log in to your account at neuralspace.pro, open the API section under the "Account" menu and hit "Create". The key starts with nsk- and is shown exactly once — copy it right away.

Then a single POST request. Here's a minimal curl example:

curl https://neuralspace.pro/v1/images/generations \
  -H "x-api-key: nsk-YOUR_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "nano-banana",
    "prompt": "a ginger cat in a spacesuit, studio light, white background",
    "aspect_ratio": "1:1"
  }'

The response is JSON with a link to the image: data[0].url. The request is synchronous — the connection stays open while the model draws and returns the result immediately. No need to build a status-polling loop. Want Pro and 2K? Change model to nano-banana-pro and add "resolution": "2K". Need to edit your own photo from a description? Pass an image_urls array and the model will use it as the base.

What it costs

NeuralSpace API pricing for image generation: Nano Banana and Nano Banana Pro

You pay with tokens from your balance, one token is one ruble. No subscriptions, no exchange-rate recalculation at the moment of charge. Regular Nano Banana — 4 ₽ per image. Pro — 17 ₽ for 1K and 2K, 23 ₽ for 4K. The same prices as in the web app; there's no "but it's an API" markup.

And an important point: tokens are charged only for a successful generation. If the request times out or the model can't cope — your money stays put. You top up your balance on the payment page with any Russian card or via SBP.

Where the catch is

Honestly — there are a couple of limits. A cap of 60 requests per minute per key. For batch-generating hundreds of images that's fine, but if you want to hammer it across ten threads with no pauses, you'll hit the wall. Solved with a simple queue on your side.

There's no progress streaming; the response arrives whole at the end. And for now the API only covers Nano Banana for images — ChatGPT, Seedance for video and the rest of the site's models are being added one by one. The text chat with Claude over the API, by the way, already works, and the request format is Anthropic-compatible.

Who actually needs this

Off the top of my head, where I'd put it to work. An online store that needs to churn out product backgrounds in bulk. A Telegram bot that draws avatars on user request. An SMM script that turns post text into an image for that post. Or just a pet project where you can't be bothered to pay for three foreign subscriptions.

If you used to hit the "no card for a foreign API" wall — that barrier is gone now. Create a key on the sign-up page, drop a couple hundred rubles on your balance and give it a try. And all the available image-generation models are always within reach in the image generation section.

Часто задаваемые вопросы (FAQ)

Вопрос: Как получить лучший результат от нейросети?
Ответ: Используйте подробные промпты (описания) на английском языке, задавайте стиль и детали сцены.

Вопрос: Можно ли использовать эти материалы в коммерческих целях?
Ответ: Да, сгенерированный контент полностью принадлежит вам.