Nano Banana 2 API

Introduction

Nano Banana 2 Text to image is Google's Gemini 3.1 Flash Image, released on 26 February 2026, generating images from a written prompt. Google describes it as Pro-level image quality at Flash speed.

Choose a mode by starting material

Key features

Four tiers, fourteen shapes

From 512-pixel drafts to 4096-pixel finals, and from 1:8 towers to 8:1 banners. At 2k our 4:1 banner came back 4128 pixels wide.

Search before drawing

Web search pulls current facts such as dates, weather and landmarks; image search pulls reference pictures of real places and products. Both are optional switches on the request.

Request parameters

Pricing

Prices are in credits, the same credits you use on the website (1 credit = $0.01). The hold is taken when the task is accepted and settled to the actual charge when it finishes; failed tasks are refunded.

Each task is rounded up to whole credits, so one run at the lowest tier costs 6 credits per image ($0.06).

For an exact number before you run, send the same body to POST /jobs/quote.

Use cases

Website headers and billboards

Ultra-wide 4:1 and 8:1 banners rendered as one continuous photograph, with no stitching or stretching afterwards.

Fast fashion and lifestyle drafts

Many directions per hour at 0.5k and 1k, with the strongest re-run at 2k for delivery.

Real places and products

With image search on, scenes set at a real landmark or featuring a real product can draw on reference pictures from the web.

Tall frames for mobile

Tall 1:4 and 1:8 frames for story formats and side banners, generated as one continuous image.

Prompt guide & pro tips

Give wide frames content at both ends

For 4:1 and 8:1, describe what fills the left and right edges: a long beach, a skyline, a row of shopfronts. Otherwise the ends turn into empty sky.

Use search for facts, not style

Web search helps when the picture depends on something current or real. It does not improve style or composition, so leave it off otherwise.

Draft small, deliver large

Keep the prompt unchanged between 0.5k and 4k; the composition stays close, so choices made on the draft carry over.

Pick 2k for delivery

At 2k a square image is 2048 pixels across, which is enough for most screens and pages; keep 4k for print and heavy crops.

API quick start

Call the Nano Banana 2 API in three steps

1. Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow- and use the same credits as the website.
2. Send the request. POST /jobs/createTask with model google/nano-banana-2/text-to-image and an input object that follows the parameter table. The response returns a task ID straight away.
3. Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "google/nano-banana-2/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "aspect_ratio": "16:9",
    "resolution": "1k"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.

Nano Banana 2 API questions

All Nano Banana models

Nano Banana 2.1 is Google's newer update with better text and character consistency, but no 0.5K draft size.

• Nano Banana 2.1 APIGoogle's newest Nano Banana, sharp text and 4K outputFrom 8 credits per image
• Nano Banana Pro APIPlans the layout first: dense text, diagrams and 4K editsFrom 17 credits per image
• Nano Banana 2 APIFast Gemini images up to 4K, with up to 14 referencesFrom 6 credits per image

Other image APIs

• GPT Image 2.5 Sunburst APIOpenAI's quality-first model, up to 4K with clean textFrom 1 credit per image
• Seedream 5.0 Pro APIHigh-detail images and edits from up to ten referencesFrom 6 credits per image
• FLUX.2 Max APITop-tier FLUX: photoreal light and exact brand colorsFrom 11 credits per image
• Qwen Image 2.1 Pro APIUp to six detailed 2K images from one promptFrom 6 credits per image
• Qwen Image 2.1 Turbo APIFast 8-step renders, up to six per promptFrom 3 credits per image
• Qwen Image 2.1 APIOpen model with 2K output and transparent backgroundsFrom 4 credits per image

More about Nano Banana 2

Try it

Nano Banana 2 AI Image Generator onlineCreate images with Nano Banana 2 in PopNow

Docs

Nano Banana 2 model ID and input schema in the API docsPopNow API quickstart: your first request in five minutesImage generation guide for the PopNow APIWebhooks: get Nano Banana 2 results without polling