Nano Banana Pro API

About Nano Banana Pro

Nano Banana Pro image editing takes one to fourteen source images and an instruction such as new light, added text or a combined scene, at 1k, 2k or 4k. Keep the source shape or choose from ten aspect ratios.

Call it with the model name google/nano-banana-pro/edit on POST /jobs/createTask, from 17 credits per image ($0.17). New accounts get 30 free credits to try it in the Playground first.

Introduction

Nano Banana Pro Edit runs Google's Gemini 3 Pro Image on images you already have. It accepts one to fourteen sources, plans the edit before rendering, and returns 1k, 2k or 4k in the source shape or one of ten shapes.

Choose a mode by starting material

Key features

Careful single-change edits

Relighting, a new background or added text while the people and the rest of the frame stay as they were, as in our candlelight and cover examples. The model plans the edit before rendering, which keeps unrelated parts of the frame stable.

Text over photographs

Mastheads, issue lines and captions are set onto the picture with the spelling you quote, in the position you give them.

Up to fourteen references

Combine people, products and settings from many sources, each described by its role in the prompt, in a single edit 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 17 credits per image ($0.17).

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

Use cases

Turn photos into covers and posters

Add a masthead, a date and a line of copy to an approved photograph without retouching it.

Mood and light variations

Show the same scene by candlelight, at dawn or under neon for a client choosing a direction.

Localised campaign images

Replace the text on a finished poster with a translated line for each market while the photograph and its light stay untouched.

Prompt guide & pro tips

Change one thing at a time

Single-change instructions keep everything else stable; chain several edits rather than packing them into one prompt.

Protect the people

After the change, name the person, the outfit and the pose that must stay exactly the same.

Quote text with its position

For added type, quote each line and say where it sits: across the top, bottom left, beside the logo.

API quick start

Call the Nano Banana Pro 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-pro/edit 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-pro/edit",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "image_urls": [
      "https://media.popnow.ai/influencer/examples/marco.webp"
    ],
    "aspect_ratio": "auto",
    "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 Pro API questions

All Nano Banana models

Nano Banana 2.1 is faster and less than half the price, with 8:1 banners and web search. Choose Pro when the layout is complicated or the text is dense.

• 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 Pro

Try it

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

Compare

Nano Banana 2.1 vs Nano Banana ProFLUX.2 Max vs Nano Banana Pro

Docs

Nano Banana Pro 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 Pro results without polling