Nano Banana 2 & Pro Image Editor & Generator

Nano Banana image editor and generator: edit photos with a sentence or create images from text with Google Nano Banana 2 Lite, Nano Banana 2 and Nano Banana Pro (Gemini 3 Pro Image), up to 4K.

• ✏️ Image editing: give a public image URL and describe the change ("replace the background with a beach", "make the jacket red").
• 🎨 Text-to-image: leave the image URL empty and describe the picture you want.
• 🖼️ 1K, 2K or 4K, 12 aspect ratios, up to 10 variants per run, permanent Apify-hosted image URLs.
• 🔑 No API key: no OpenAI, Google or ByteDance account needed.
• 🆓 Works with a free Apify account too: 1 generation per month (one image) with Nano Banana 2 Lite, billed at the normal price ($0.13). Every model and option on paid Apify plans.
• 🚫 Sexually explicit content is not allowed. Such prompts stop at once, at no cost.
• 🎯 Quality score for automation (optional, $0.01 per output): an AI checks every image for weird or broken details and for its match with your prompt, so you can publish without checking by hand.
• 💸 Pay only for successful outputs. Failures are never charged.

Works from the Apify Console, the API, the JavaScript / Python clients, n8n, Make, Zapier and AI agents / MCP.

🎯 Quality score: run stories, ads and UGC on autopilot

Turn on qualityScore and every delivered image is checked by a multimodal AI before it reaches you, in two steps:

1. Coherence: nothing weird or broken (hands and fingers, faces, objects merging or appearing from nowhere, garbled text, illogical actions).
2. Prompt match: the subject, product, setting, action and any quoted text of your original prompt are there (not the optimized prompt), and nothing was added that you did not ask for (text, logo, object, product color).

Each issue is graded like an art director looking at the image at normal size: critical (unusable: wrong product, something appearing from nowhere), major (visible at first glance) or minor (only seen when zooming in, such as watch hands or buckles).

Each row then has qualityScore (0-100), coherenceScore, promptMatchScore, issues (short list in English) and verdict:

Verdict	Rule	What to do
pass	no critical or major issue, quality >= 75	publish automatically
review	a major issue (first-glance defect, unrequested text...)	a quick human look
fail	a critical issue or quality < 50	discard or regenerate

No more checking every image by hand: in n8n, Make, Zapier or your own code, publish the pass rows of your daily stories, ads or product visuals and regenerate the fail ones. $0.01 per scored image; if the checker is unavailable the image is delivered without a score and nothing extra is charged.

💡 Who is it for?

• E-commerce: packshots to lifestyle scenes, color variants, background swaps
• Marketing: ads, Stories, banners
• Developers and AI agents: a synchronous Nano Banana API without keys or polling

⚙️ How it works

1. You send a prompt, plus an image URL if you want to edit a picture, and pick a model.
2. The Actor generates each output and waits for the result (no task id to poll).
3. Each file is copied to your Apify key-value store, so the link does not expire after an hour.
4. One dataset row per output: URL, model, options.

💰 Pricing

Pay per event, one event per successful output, no start fee. Paid Apify plans: every model below. Works with a free Apify account too: 1 generation per month (one image) with Nano Banana 2 Lite, billed at the normal price ($0.13).

Model	Option	Event	Price per output
Nano Banana 2 Lite (Gemini 3.1 Flash Lite Image)	—	image-standard	$0.13
Nano Banana 2 (Gemini 3.1 Flash Image)	1K	image-pro	$0.26
Nano Banana 2 (Gemini 3.1 Flash Image)	2K	image-premium	$0.39
Nano Banana 2 (Gemini 3.1 Flash Image)	4K	image-ultra	$0.57
Nano Banana Pro (Gemini 3 Pro Image)	1K	image-ultra	$0.57
Nano Banana Pro (Gemini 3 Pro Image)	2K	image-ultra	$0.57
Nano Banana Pro (Gemini 3 Pro Image)	4K	image-ultra-4k	$1.13

• A failed output is not charged. If nothing could be produced, nothing is charged.
• Prompt optimization (optional, optimizePrompt or a use case): $0.015 per optimized prompt (event prompt-optimization), charged once with the first delivered output that uses it. Not charged if the prompt writer is unavailable or nothing is delivered. Not available on the free Apify plan.
• Quality score (optional, qualityScore): $0.01 per scored output (event quality-score). Not charged if the checker is unavailable or the output failed. Not available on the free Apify plan.
• Set a maximum cost per run: the Actor stops before generating an output your budget would not cover.
• Store discounts: on Apify Silver, Gold, Platinum and Diamond plans, some options cost up to 10 % less. The Pricing tab of the Store page shows the exact price for each plan.

📥 Input

Field	Type	Description
prompt	string	Text description of the image to generate, or the edit to make to the source image.
model	string	Which AI model to use. Each option is billed at its own price, see the Pricing section of the README. Free Apify plan: 1 generation per month (one image) with Nano Banana 2 Lite, billed at the normal price ($0.13); other models and options are replaced by it.
imageUrl	string	Public URL of an image to edit (or to upscale). Leave empty for text-to-image.
optimizePrompt	boolean	An AI prompt writer rewrites your idea into a detailed image prompt for the selected model (subject, composition, light, style), keeping every detail you gave and any text in quotes. $0.015 per optimized prompt (event "prompt-optimization"), charged once with the first delivered output that uses it; nothing extra if the writer is unavailable. The prompt actually used is in the output ("prompt", with your text in "originalPrompt"). If the writer is unavailable, your own prompt is used.
preset	string	Style brief for the prompt optimization: product (e-commerce), ads, social post, UGC, story, cinematic, portrait. Picking a use case turns "Optimize my prompt" on.
qualityScore	boolean	A multimodal AI looks at each image: coherence (hands, faces, objects, text, illogical details) and match with your original prompt. Adds qualityScore, coherenceScore, promptMatchScore (0-100), issues and verdict (pass / review / fail) to each row, so you can publish only the "pass" ones automatically. $0.01 per scored output (event "quality-score"); nothing extra if the checker is unavailable.
quality	string	Shortcut for the resolution when "Resolution" is empty: draft = lowest, standard = model default, high = one step below the best, max = best the model offers. Higher quality costs more per image.
aspectRatio	string	Output aspect ratio. "auto" keeps the model default (for edits: the source image ratio). Not every model supports every ratio; an unsupported ratio stops the run before anything is charged.
resolution	string	Output resolution for models that offer it (Nano Banana 2 / Pro). Leave empty for 1K. 2K and 4K cost more.
numberOfVariants	integer	How many separate outputs to generate (1 to 10). Each successful one is billed; failures are free.
includeFailedVariants	boolean	Also write failed outputs (with the reason) to the dataset. Failed outputs are never billed.

Example: Edit a photo (Nano Banana 2 Lite)

{
  "prompt": "Replace the background with a sunny tropical beach, keep the product identical",
  "imageUrl": "https://example.com/my-product.jpg",
  "model": "google/nano-banana-2-lite"
}

Example: Text-to-image in 4K (Nano Banana Pro)

{
  "prompt": "A ripe yellow banana on a white marble table, studio product photo",
  "model": "google/nano-banana-pro",
  "resolution": "4K",
  "aspectRatio": "16:9"
}

📤 Output

One dataset row per output:

{
  "model": "google/nano-banana-2-lite",
  "mode": "text-to-image",
  "index": 1,
  "imageUrl": "https://api.apify.com/v2/key-value-stores/<STORE_ID>/records/image-1",
  "contentType": "image/png",
  "chargedEvent": "image-standard",
  "chargedUnits": 1,
  "success": true
}

Export the dataset as JSON, CSV, Excel or HTML, or read it from the API.

🧠 Models

• Nano Banana 2 Lite (Gemini 3.1 Flash Lite Image) (google/nano-banana-2-lite): optional edit image, 12 aspect ratios.
• Nano Banana 2 (Gemini 3.1 Flash Image) (google/nano-banana-2): optional edit image, resolutions 1K / 2K / 4K, 12 aspect ratios.
• Nano Banana Pro (Gemini 3 Pro Image) (google/nano-banana-pro): optional edit image, resolutions 1K / 2K / 4K, 10 aspect ratios.

🛟 Errors and reliability

• Invalid options (unsupported ratio, duration or resolution for the chosen model) stop the run before anything is generated or charged, with a message listing the supported values.
• If the AI provider is temporarily unavailable, the run stops right away (no time burned on the remaining outputs), nothing is charged, and the dataset contains one row with success: false, status: "service-unavailable" and a clear message. Retry a bit later.
• Runs whose maximum cost per run is too low for one output stop at once with an explanatory row (status: "budget-too-low"), at no cost.
• Free Apify plan: once the 1 generation of the month is used, or when the daily free-plan capacity is reached, runs stop at once with status: "free-plan-limit", at no cost. If free-plan runs are temporarily unavailable, the row says status: "paid-plan-required", also at no cost.
• If one output is refused (safety filter, unreadable source image), the others still run.

❓ FAQ

Which Gemini model is behind each option?

Nano Banana 2 Lite = Gemini 3.1 Flash Lite Image, Nano Banana 2 = Gemini 3.1 Flash Image, Nano Banana Pro = Gemini 3 Pro Image.

Do I need an API key (OpenAI, Google...)?

No. Your Apify account is enough: no key, no subscription, no quota to manage.

Can I use it on the free Apify plan?

Yes. Works with a free Apify account too: 1 generation per month (one image) with Nano Banana 2 Lite, billed at the normal price ($0.13), from your free monthly Apify credit. On a free plan only Nano Banana 2 Lite is used, one output per run: if you pick another model or option, the run uses it instead and says so in the output row (notice). Once the monthly generation is used (or when the daily free-plan capacity is reached), runs stop at once with status: "free-plan-limit", at no cost. Paid Apify plans get every model and option, without this limit.

Am I charged when a generation fails?

No. You pay only for outputs that are delivered. Invalid inputs are rejected before any generation starts.

How do I cap my spending?

Set Maximum cost per run in the run options. The Actor stops before generating an output your budget would not cover.

How long are files kept?

Outputs are copied to the run key-value store and follow your Apify data retention. Download them or copy them to your own storage for long-term use.

Can I call it from code, n8n, Make, Zapier or an AI agent?

Yes. Use the "Run Actor synchronously and get dataset items" API endpoint, the Apify clients, the integrations, or the Apify MCP server.

Who owns the generated content?

Use of generated content is subject to the terms of each model provider. Do not submit images you do not have the right to use.

Related actors

• AI Image Generator: Need other models or upscaling? Flux, GPT Image 2, Seedream, Imagen 4, Ideogram and an upscale mode for print or e-commerce.
• AI Video Generator: Animate your image: image to video with Veo 3, Kling, Seedance or Wan.
• AI Logo Generator: Need a logo or icon? SVG vector logos.

▶️ Start now

Pick a model, type a prompt, click Start.

Need Flux, GPT Image, logos or upscaling? See pnda/ai-image-generator