# Nano Banana

> Gemini 2.5 Flash Image is optimized for image understanding and generation, offering a balance of price and performance with fast and efficient image generation and editing capabilities.

## Quick Reference

- Model ID: gemini-2.5-flash-image
- Creator: Google
- Status: active
- Family: gemini-2.5-flash-image
- Base URL: https://api.lumenfall.ai/openai/v1

## Specifications

- Context Window: 32768 tokens
- Max Output Images: 10
- Max Input Images: 3
- Max Output Tokens: 32768
- Input Modalities: text, image
- Output Modalities: text, image
- Capabilities: batch, system_prompt
- Supported Modes: Text to Image, Image Edit

## API Parameters

The compiled parameter schema for this model is available via the API: `GET /v1/models/gemini-2.5-flash-image?schema=true`.

### Core Parameters

- `prompt` (string) — REQUIRED: Edit instruction for the image. Modes: Image Edit, Text to Image
- `seed` (integer): Random seed for reproducibility. Modes: Image Edit, Text to Image

### Size & Layout

- `size` (string): Image dimensions as WxH pixels (e.g. "1024x1024") or aspect ratio (e.g. "16:9"). Values: auto, 1563x670, 1365x768, 768x1365, 1254x836, 836x1254, 887x1182, 1024x1024, 1145x916, 916x1145, 1183x887. Modes: Image Edit, Text to Image
- `aspect_ratio` (string): Aspect ratio of the output image (e.g. "16:9", "1:1"). Values: auto, 9:16, 2:3, 3:4, 4:5, 1:1, 5:4, 4:3, 3:2, 16:9, 21:9. Modes: Image Edit, Text to Image
- `resolution` (string): Output resolution tier (e.g. "1K", "4K"). Values: auto, 1K. Modes: Image Edit, Text to Image

### Media Inputs

- `image` (file) — REQUIRED: Input image(s) to edit. Modes: Image Edit

### Output & Format

- `response_format` (string): How to return the image. Default: url. Values: url, b64_json. Modes: Image Edit, Text to Image
- `output_format` (string): Output image format. Values: png, jpeg, gif, webp, avif. Modes: Image Edit, Text to Image
- `output_compression` (integer): Compression level for lossy formats (JPEG, WebP, AVIF). Modes: Image Edit, Text to Image
- `n` (integer): Number of images to generate. Default: 1. Modes: Image Edit, Text to Image

### Additional Parameters

- `limit_generations` (boolean): Experimental parameter to limit the number of generations from each round of prompting to 1. Set to `True` to to disregard any instructions in the prompt regarding the number of images to generate.. Modes: Image Edit, Text to Image. Only available via fal
- `safety_tolerance` (string): The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict.. Values: 1, 2, 3, 4, 5, 6. Modes: Image Edit, Text to Image. Only available via fal
- `sync_mode` (boolean): If `True`, the media will be returned as a data URI and the output data won't be available in the request history.. Modes: Image Edit, Text to Image. Only available via fal


## Model Identifiers

- Primary Slug: gemini-2.5-flash-image
- Aliases: gemini-2.5-flash-image-preview
- Alternative Names: Nano Banana

## Dates

- Released: October 2025

## Tags

image-generation, multimodal, fast

## Available Providers

### fal.ai

- Config Key: fal/gemini-2.5-flash-image-edit
- Provider Model ID: fal-ai/gemini-25-flash-image/edit
- Pricing: $0.039/image
  - Source: https://fal.ai/models/fal-ai/gemini-25-flash-image/api

### Vertex AI

- Config Key: vertex/gemini-2.5-flash-image
- Provider Model ID: gemini-2.5-flash-image
- Regions: global
- Pricing: $0.300/M input tokens, $30.00/M output tokens (image), $0.150/M input tokens
  - Source: https://cloud.google.com/vertex-ai/generative-ai/pricing

### fal.ai

- Config Key: fal/gemini-2.5-flash-image
- Provider Model ID: fal-ai/gemini-25-flash-image
- Pricing: $0.039/image
  - Source: https://fal.ai/models/fal-ai/gemini-25-flash-image/api

### Replicate

- Config Key: replicate/gemini-2.5-flash-image
- Provider Model ID: google/gemini-2.5-flash-image
- Pricing: $0.039/image
  - Source: https://replicate.com/google/gemini-2.5-flash-image

### Gemini API

- Config Key: gemini/gemini-2.5-flash-image
- Provider Model ID: gemini-2.5-flash-image
- Regions: global
- Pricing: $0.300/M input tokens, $30.00/M output tokens (image), $0.150/M input tokens
  - Source: https://ai.google.dev/gemini-api/docs/pricing#gemini-2.5-flash-image


## Performance Metrics

Provider performance over the last 30 days.

### gemini

- Median Generation Time (p50): 7886ms
- 95th Percentile Generation Time (p95): 10941ms
- Average Generation Time: 8137ms
- Success Rate: 57.9%
- Total Requests: 19
- Time to First Byte (p50): 7043ms
- Time to First Byte (p95): 10111ms

### fal

- Median Generation Time (p50): 31825ms
- 95th Percentile Generation Time (p95): 96361ms
- Average Generation Time: 42771ms
- Success Rate: 100.0%
- Total Requests: 18
- Time to First Byte (p50): 35705ms
- Time to First Byte (p95): 96163ms


## Arena Benchmarks

### Neutral Expression to Genuine Smile

- Elo: 1287
- Record: 36W / 10L / 6T (52 battles)
- Rank: #1 of 14

### Man and Car in California

- Elo: 1266
- Record: 44W / 46L / 4T (94 battles)
- Rank: #5 of 13

### Heroic Super Hero Portrait

- Elo: 1257
- Record: 14W / 14L / 5T (33 battles)
- Rank: #1 of 21

### Bald man challenge

- Elo: 1234
- Record: 23W / 5L / 6T (34 battles)
- Rank: #4 of 15

### Vintage Cafe Logo

- Elo: 1230
- Record: 15W / 10L / 1T (26 battles)
- Rank: #4 of 21

### Geometric Composition

- Elo: 1207
- Record: 9W / 12L / 10T (31 battles)
- Rank: #6 of 22

### Golden Hour Stroll

- Elo: 1205
- Record: 18W / 8L / 2T (28 battles)
- Rank: #4 of 13

### Candid Street Photography

- Elo: 1189
- Record: 11W / 7L / 0T (18 battles)
- Rank: #6 of 24

### Victorian Greenhouse Oasis

- Elo: 1181
- Record: 8W / 5L / 0T (13 battles)
- Rank: #11 of 17

### Over-the-top cartoon caricature

- Elo: 1177
- Record: 11W / 11L / 0T (22 battles)
- Rank: #9 of 13

### Night Sky Transformation

- Elo: 1176
- Record: 14W / 9L / 5T (28 battles)
- Rank: #12 of 16

### Modern Clean Menu

- Elo: 1168
- Record: 15W / 15L / 1T (31 battles)
- Rank: #13 of 19

### Apollo 11: Journey to Tranquility

- Elo: 1168
- Record: 12W / 9L / 0T (21 battles)
- Rank: #10 of 19

### Adorable Baby Animals in Sunny Meadow

- Elo: 1157
- Record: 3W / 2L / 0T (5 battles)
- Rank: #14 of 25

### Intricate Floral Mandala

- Elo: 1148
- Record: 6W / 8L / 3T (17 battles)
- Rank: #12 of 15

### Isometric Miniature Diorama Scenes

- Elo: 1139
- Record: 8W / 13L / 3T (24 battles)
- Rank: #18 of 21

### Studio Ghibli Anime Style

- Elo: 1106
- Record: 2W / 26L / 1T (29 battles)
- Rank: #14 of 14

### Fantasy Warrior

- Elo: 1077
- Record: 4W / 11L / 4T (19 battles)
- Rank: #21 of 21

### Fantasy Warrior

- Elo: 1061
- Record: 1W / 2L / 1T (4 battles)
- Rank: #11 of 14


## Use Cases & Category Performance

### Portrait (Image Editing)

- Rank: #2 of 15
- Elo: 1280
- Record: 59W / 15L / 10T (84 battles)
- Win Rate: 70.2%

### Photorealism (Image Editing)

- Rank: #3 of 16
- Elo: 1252
- Record: 135W / 78L / 21T (234 battles)
- Win Rate: 57.7%

### Product, Branding & Commercial (Text-to-Image)

- Rank: #4 of 21
- Elo: 1217
- Record: 15W / 10L / 1T (26 battles)
- Win Rate: 57.7%

### Photorealism (Text-to-Image)

- Rank: #8 of 23
- Elo: 1204
- Record: 11W / 7L / 0T (18 battles)
- Win Rate: 61.1%

### Text Rendering (Text-to-Image)

- Rank: #9 of 23
- Elo: 1235
- Record: 42W / 34L / 2T (78 battles)
- Win Rate: 53.8%

### Portrait (Text-to-Image)

- Rank: #20 of 21
- Elo: 1101
- Record: 4W / 11L / 4T (19 battles)
- Win Rate: 21.1%

### Anime (Image Editing)

- Rank: #14 of 14
- Elo: 1156
- Record: 2W / 26L / 1T (29 battles)
- Win Rate: 6.9%


## Image Gallery

23 images available for this model. Browse all at https://lumenfall.ai/models/google/gemini-2.5-flash-image/gallery

### Curated Examples

- [Cinematic wide shot of a high-end, artisan glassblowing workshop. In the center, a master craftsm...](https://assets.lumenfall.ai/sRpvvrxTp_YnrYhs44KLnvFFvAhMT5TgCSDQmidJX3o/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/8bkbdt41on1tdtthmpgy55tq7u98@jpeg)
- [Cinematic wide shot of an elderly artisan in a sun-drenched Mediterranean workshop, meticulously ...](https://assets.lumenfall.ai/aLuehZOOQO6vzDyiuaHrncJ5E-BK94t0qcO-ydFz9mc/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/3tmss3egvemh3k35pidljz6lth7o@jpeg)
- [A macro photography shot of an antique mechanical watch movement, intricate brass gears and silve...](https://assets.lumenfall.ai/uJQbJDT6qmisY-2eY_uQgUvO-FtS9vKd3CDydNZ89jw/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/127vm2yil9h8z4q3mlajucq9cjed@jpeg)
- [A cozy ceramic studio bathed in morning sunlight, focusing on a half-finished clay vase on a pott...](https://assets.lumenfall.ai/U_t0dudarVINWyQd0xCvA84mCqA5dNSimWao6hd49Vg/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/txts9q23eley6phknjouva1eicls@jpeg)

### Arena Competition Results

- [Neutral Expression to Genuine Smile](https://assets.lumenfall.ai/DJsnjwWduHaUhvjNB6iBcy9KZ6cNC-03L4DPyVAbTG4/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/2t0utaunpuvvb41bn2hkjjy896b4@jpeg): #1 of 14 (Elo 1287)
- [Man and Car in California](https://assets.lumenfall.ai/cObqpoqEoZMXND0Ckt9ii75swpthnDOJ27ah1biNvMc/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/aay1x07aq04i9735q6a1l01hnai6@jpeg): #5 of 13 (Elo 1266)
- [Heroic Super Hero Portrait](https://assets.lumenfall.ai/rAFOC2EHMJlkau0eJWpLuCTfHVJv3SbBjmJGYRDuRBk/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/frazri5jnxs8buis2959cady925l@jpeg): #1 of 21 (Elo 1257)
- [Bald man challenge](https://assets.lumenfall.ai/mxFtkaWBlJTjHZ9XwyXAGClt0q7hEAOF2TdpPb37qJk/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/2hstgx0b7p5v7kx52n1ta387a6gf@jpeg): #4 of 15 (Elo 1234)
- [Vintage Cafe Logo](https://assets.lumenfall.ai/pVX1XpOYCqy3N0NuGtHPm6WZLAXRKeaUNU3st5r7tu4/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/6qlyb9u99um3gwbailpckrwhrqgk@jpeg): #4 of 21 (Elo 1230)
- [Geometric Composition](https://assets.lumenfall.ai/0HPBRl8BD4EMVkSbC2m70ViHosdkdxxLENL7gTTyUKM/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/q0lka95yl044a0lctddhdhheq2hi@jpeg): #6 of 22 (Elo 1207)
- [Golden Hour Stroll](https://assets.lumenfall.ai/vwNO-b9YrJ2Y8Hu6um8O832MkJO0DFTUfX2wuprE44M/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/ig0wcchm3tyx8kcklvfklbvmdtak@jpeg): #4 of 13 (Elo 1205)
- [Candid Street Photography](https://assets.lumenfall.ai/9E3dPyQc4-ChRiBdmkKefPy2qY-VnuLKyv9QRYHVPlE/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/b3wf72gy08j1ob88fpwmi07cijdh@jpeg): #6 of 24 (Elo 1189)
- [Victorian Greenhouse Oasis](https://assets.lumenfall.ai/Wfaad_wChNlO0WQ7MCa-wqdeZTiQHCD5I1tevcQuNZM/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/b98e5iwdtkotooipusz2uts5ffi3@jpeg): #11 of 17 (Elo 1181)
- [Over-the-top cartoon caricature](https://assets.lumenfall.ai/Z2yJAhLp7RMCpUZUq_29nbKMmNzbh4rhGl8Urv8k7G8/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/w4z1nujddleemeewm0azl4xa6yk3@jpeg): #9 of 13 (Elo 1177)
- [Night Sky Transformation](https://assets.lumenfall.ai/M4t2PCRfijtw96q-wnJQ-db4lnfVF7u2oah-5fRkCH0/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/hjucu50ezrhuqcix06zwslhb5gyw@jpeg): #12 of 16 (Elo 1176)
- [Modern Clean Menu](https://assets.lumenfall.ai/EQSDCTmzPo0H49hNk8FAjrrVJwwrIp2mQhk7gZ3MNnc/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/r8qm1oqnwtn0ms843k4kx4fpi5md@jpeg): #13 of 19 (Elo 1168)
- [Apollo 11: Journey to Tranquility](https://assets.lumenfall.ai/C6ErH2mUxI9ZJBzFkvbEOexAC8uqqfH7uUoO0kaM96k/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/bolwwjlmskqxnizpbpcw9n7yy0t1@jpeg): #10 of 19 (Elo 1168)
- [Adorable Baby Animals in Sunny Meadow](https://assets.lumenfall.ai/psflinNC8DFKmpksN6pDP7hDhBhBKErJHmmzDDLq-Nk/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/u99oqz2cfa1p9fksltqntb74k0l6@jpeg): #14 of 25 (Elo 1157)
- [Intricate Floral Mandala](https://assets.lumenfall.ai/msURAm5YrZCQa8SWrz2II0ukUPxRkg43xFsbGz9bc9I/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/kosbf63lg9hnr6q14h060wied5kv@jpeg): #12 of 15 (Elo 1148)
- [Isometric Miniature Diorama Scenes](https://assets.lumenfall.ai/OhOOk2Ouowqd8EGsrXmYZ7nVU-HgWtNw20Ob0QfDvvI/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/92vnjwlpn04xemc6b6hn0wq269pg@jpeg): #18 of 21 (Elo 1139)
- [Studio Ghibli Anime Style](https://assets.lumenfall.ai/182973STdESXvoH0a9Fl1alMRMzfHMeZuTTpO0lczqU/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/pfkl8hgc8uuurmaffwfodejynowh@jpeg): #14 of 14 (Elo 1106)
- [Fantasy Warrior](https://assets.lumenfall.ai/aU1clCm9oT4jYhTVyhgDm2-cu8ZUa0XmQcSssIhgYs0/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/ub0ehl33ecj7kiznm2axphux1s19@jpeg): #21 of 21 (Elo 1077)
- [Fantasy Warrior](https://assets.lumenfall.ai/Z1b0np7I5bnG9m6dxy3lxEGrg8V0eOUlYoiX21Cq2Pw/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/l29ori6wmjlammls9epa7wvfylao@jpeg): #11 of 14 (Elo 1061)

## Example Prompt

The following prompt was used to generate an example image in our playground:

A cozy ceramic studio bathed in morning sunlight, focusing on a half-finished clay vase on a pottery wheel. In the soft-focus background, a small capybara sits patiently on a wooden stool, wearing a tiny blue bandana. Cinematic soft lighting.

## Code Examples

### Text to Image (/v1/images/generations)

#### cURL

curl -X POST \
  https://api.lumenfall.ai/openai/v1/images/generations \
  -H "Authorization: Bearer $LUMENFALL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.5-flash-image",
    "prompt": "",
    "size": "1024x1024"
  }'

# Response:
# { "created": 1234567890, "data": [{ "url": "https://...", "revised_prompt": "..." }] }

#### JavaScript

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.lumenfall.ai/openai/v1'
});

const response = await client.images.generate({
  model: 'gemini-2.5-flash-image',
  prompt: '',
  size: '1024x1024'
});

// { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
console.log(response.data[0].url);

#### Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.lumenfall.ai/openai/v1"
)

response = client.images.generate(
    model="gemini-2.5-flash-image",
    prompt="",
    size="1024x1024"
)

# { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
print(response.data[0].url)

### Image Edit (/v1/images/edits)

#### cURL

curl -X POST \
  https://api.lumenfall.ai/openai/v1/images/edits \
  -H "Authorization: Bearer $LUMENFALL_API_KEY" \
  -F "model=gemini-2.5-flash-image" \
  -F "image=@source.png" \
  -F "prompt=Add a starry night sky to this image" \
  -F "size=1024x1024"

# Response:
# { "created": 1234567890, "data": [{ "url": "https://...", "revised_prompt": "..." }] }

#### JavaScript

import OpenAI from 'openai';
import fs from 'fs';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.lumenfall.ai/openai/v1'
});

const response = await client.images.edit({
  model: 'gemini-2.5-flash-image',
  image: fs.createReadStream('source.png'),
  prompt: 'Add a starry night sky to this image',
  size: '1024x1024'
});

// { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
console.log(response.data[0].url);

#### Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.lumenfall.ai/openai/v1"
)

response = client.images.edit(
    model="gemini-2.5-flash-image",
    image=open("source.png", "rb"),
    prompt="Add a starry night sky to this image",
    size="1024x1024"
)

# { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
print(response.data[0].url)


## About

## Overview
Gemini 2.5 Flash Image is a multimodal model developed by Google designed for high-velocity image generation and visual reasoning. It functions as an efficient mid-tier option in the Gemini lineup, prioritizing low latency and cost-effectiveness while maintaining the ability to process both text and image inputs. This model is distinctive for its dual-purpose nature, acting as both an image generator and a visual analysis tool within a single architecture.

## Strengths
*   **Rapid Iterative Generation:** Optimized for speed, the model excels at "flash" generation cycles where low latency is required for real-time applications or high-volume batch processing.
*   **Instruction Following:** Strong adherence to system prompts allows for precise control over stylistic constraints and compositional requirements during the image creation process.
*   **Multimodal Reasoning:** Unlike pure-play diffusion models, it can ingest existing images as context to perform editing, variations, or descriptive analysis.
*   **Resource Efficiency:** Offers a significantly lower price point ($0.039 starting price) compared to larger-parameter models, making it viable for large-scale production deployments.

## Limitations
*   **Visual Complexity:** While fast, it may lack the intricate fine-detail rendering (such as complex micro-textures or hyper-realistic human anatomy) found in larger, "Pro" tier models.
*   **Compositional Nuance:** In very dense scenes with numerous specific spatial requirements, the model may occasionally prioritize speed over exact adherence to complex spatial arrangements.
*   **Niche Stylization:** Without specialized LoRA support or fine-tuning, it may struggle with highly specific or avant-garde artistic styles compared to dedicated community-driven generation models.

## Technical Background
Released in October 2025, Gemini 2.5 Flash Image is built on the Gemini 2.x transformer-based architecture family. It utilizes a unified multimodal training approach that treats visual tokens and text tokens within the same latent space, enabling seamless transitions between understanding an input image and generating a visual response. The model is specifically tuned for distilled inference, reducing the computational overhead typically associated with large-scale vision-language models.

## Best For
This model shines in scenarios requiring high-throughput asset generation, such as e-commerce product background variations, social media content scaling, and rapid prototyping for UI/UX concepts. It is also well-suited for applications that combine image analysis with immediate visual feedback, such as describing a scene and then modifying it based on user feedback.

Nano Banana (Gemini 2.5 Flash Image) is available for testing and deployment through Lumenfall's unified API and interactive playground, allowing you to integrate its fast generational capabilities into your existing workflows alongside other models in the Gemini family.

## Frequently Asked Questions

### How much does Nano Banana cost?

Nano Banana starts at $0.039 per image through Lumenfall. Pricing varies by provider. Lumenfall does not add any markup to provider pricing.

### What can Nano Banana do?

Nano Banana supports Batch and System prompt. It accepts text and image input and produces text and image output.

### How do I use Nano Banana via API?

You can use Nano Banana through Lumenfall's OpenAI-compatible API. Send requests to the unified endpoint with model ID "gemini-2.5-flash-image". Code examples are available in Python, JavaScript, and cURL.

### Which providers offer Nano Banana?

Nano Banana is available through fal.ai, Vertex AI, Replicate, and Gemini API on Lumenfall. Lumenfall automatically routes requests to the best available provider.

## Links

- Model Page: https://lumenfall.ai/models/google/gemini-2.5-flash-image
- About: https://lumenfall.ai/models/google/gemini-2.5-flash-image/about
- Providers, Pricing & Performance: https://lumenfall.ai/models/google/gemini-2.5-flash-image/providers
- API Reference: https://lumenfall.ai/models/google/gemini-2.5-flash-image/api
- Benchmarks: https://lumenfall.ai/models/google/gemini-2.5-flash-image/benchmarks
- Use Cases: https://lumenfall.ai/models/google/gemini-2.5-flash-image/use-cases
- Gallery: https://lumenfall.ai/models/google/gemini-2.5-flash-image/gallery
- Playground: https://lumenfall.ai/playground?model=gemini-2.5-flash-image
- API Documentation: https://docs.lumenfall.ai