# Nano Banana 2 (Edit)

> Google's fast image editing model built on Gemini 3.1 Flash Image. Transform and edit existing images with conversational editing, multi-image fusion, character consistency, and Google Search grounding.

- **Provider**: fal
- **Model ID**: fal-ai/nano-banana-2/edit
- **Category**: image_generation
- **Credits**: 480 per request
- **Pricing Type**: input_based

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `aspect_ratio` (string, optional): Aspect ratio of the generated image. Use auto to let the model decide. (Default: `auto`; Options: `auto`, `1:1`, `1:4`, `1:8`, `2:3`, `3:2`, `3:4`, `4:1`, `4:3`, `4:5`, `5:4`, `8:1`, `9:16`, `16:9`, `21:9`)
- `output_format` (string, optional): Format of the output image (Default: `png`; Options: `jpeg`, `png`, `webp`)
- `seed` (integer, optional): Seed for the random number generator
- `safety_tolerance` (string, optional): Safety tolerance level (1 is strictest, 6 is most permissive) (Default: `2`; Options: `1`, `2`, `3`, `4`, `5`, `6`)
- `thinking_level` (string, optional): Enable model thinking with the given level. Omit to disable. (Options: `minimal`, `high`)
- `enable_web_search` (boolean, optional): Enable web search for real-time information (Default: `False`)
- `image_urls` (array, **required**): Input images to transform or edit (required for edit mode)
- `prompt` (string, **required**): A text description of how you want to edit the image
- `resolution` (string, optional): Resolution of the generated image (Default: `1K`; Options: `1K`, `2K`, `4K`)
- `num_images` (integer, optional): Number of images to generate (Default: `1`)
- `limit_generations` (boolean, optional): Limit generations to 1 per round of prompting, ignoring prompt instructions for multiple images. May affect generation quality. (Default: `True`)

## Example Request

```json
{
  "model": "fal-ai/nano-banana-2/edit",
  "input": {
    "aspect_ratio": "auto",
    "output_format": "png",
    "safety_tolerance": "2",
    "image_urls": [
      "https://storage.googleapis.com/falserverless/example_inputs/nano-banana-edit-input.png",
      "https://storage.googleapis.com/falserverless/example_inputs/nano-banana-edit-input-2.png"
    ],
    "prompt": "make a photo of the man driving the car down the california coastline",
    "resolution": "1K",
    "num_images": 1
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

json

## Tags

image-editing, image-generation, gemini, google, character-consistency, multi-image-fusion, conversational-editing, google-search, typography, multilingual

## Documentation

https://fal.ai/models/fal-ai/nano-banana-2