# Nano Banana | Edit

Perform fast in-painting operations to correct errors or add objects to your existing images with nano-banana-edit.

## API Information

- **Model Slug:** nano-banana-edit
- **Branded URL:** https://www.eachlabs.ai/google/nano-banana/nano-banana-edit
- **Provider:** Google
- **Category:** Image to Image
- **Output Type:** array
- **Status:** active
- **Version:** 0.0.1
- **Base Cost:** $0.04 per image (input.num_images, default 1)
- **Estimated Processing Time:** 5 seconds
- **Last Updated:** 2026-06-10
- **Interactive Demo:** https://www.eachlabs.ai/ai-models/nano-banana-edit

## Pricing

- **Charge Type:** dynamic
- **Estimated Price (default example):** $0.0400
- **Pricing Details:** $0.04 per image (input.num_images, default 1)

### Pricing Rules

| Condition | Pricing |
| --- | --- |
| Rule 1 | $0.04 per image (input.num_images, default 1) |

## Input Schema

| Parameter | Type | Required | Default | Constraints | Description |
|-----------|------|----------|---------|-------------|-------------|
| prompt | string | Yes | - | 0–50000 | - |
| image_urls | array | Yes | - | 1–10 | - |
| num_images | integer | No | 1 | 1–4 | - |
| aspect_ratio | string | No | 1:1 | 21:9,1:1,4:3,3:2,2:3,5:4,4:5,3:4,16:9,9:16,auto | Aspect ratio for generated images. |
| output_format | string | No | jpeg | jpeg,png | Output format for the images |
| limit_generations | boolean | No | true | - | 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 |

## Example Request

```bash
curl -X POST https://api.eachlabs.ai/v1/prediction/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "nano-banana-edit",
  "input": {
    "prompt": "Professional outdoor fashion photoshoot background. Modern city streets with elegant minimalist architecture, soft natural daylight, slightly overcast sky for diffused lighting. Neutral tones like beige, gray, and stone textures, creating a sophisticated and timeless atmosphere. Clean pavements, subtle depth of field, no distracting elements, high-end editorial style. ",
    "image_urls": [
      "https://storage.googleapis.com/magicpoint/thumbs/nano_banana_input.png"
    ]
  }
}'
```

## Output Schema

Response returned by `GET /v1/prediction/{id}` when the job completes:

```json
{
  "status": "success",
  "predictionID": "string",
  "output": "array",
  "metrics": {
    "predict_time": "number (seconds)"
  }
}
```

## Polling

```bash
curl https://api.eachlabs.ai/v1/prediction/{PREDICTION_ID} \
  -H "X-API-Key: YOUR_API_KEY"
```

| Status | Meaning |
|--------|---------|
| `processing` | Still running — poll again |
| `success` | Done — read `output` |
| `error` | Failed — read `message` / `details` |

## Webhook (alternative to polling)

Pass `"webhook_url": "https://your.host/path"` in the create request. Eachlabs POSTs this payload when the job ends:

```json
{
  "exec_id": "prediction-uuid",
  "status": "succeeded",
  "output": "https://...",
  "error": ""
}
```

`status` is `"succeeded"` or `"failed"`. `exec_id` equals the `predictionID` from create. Return 2xx within 30 seconds.

## Errors

Error body: `{ "status": "error", "message": "...", "details": "..." }`

| Code | Meaning |
|------|---------|
| `400` | Invalid input |
| `401` | Missing / invalid `X-API-Key` |
| `404` | Unknown model or prediction id |
| `429` | Rate limit — 100 creates / min, 10 concurrent per key |
| `5xx` | Retry with backoff |

## Overview

**nano-banana-edit — Image Editing AI Model**

Developed by Google as part of the **nano-banana** family, **nano-banana-edit** delivers fast inpainting for correcting errors or adding objects to existing images using simple text prompts, solving the need for time-consuming manual edits.

This **Google image-to-image** model, akin to Gemini 2.5 Flash Image capabilities, excels in mask-free inpainting and layout-aware outpainting, enabling precise changes like "replace the background with a snowy mountain" without altering unprompted areas.

Ideal for users seeking an **image-to-image AI model** with superior speed—generating edits in 1-5 seconds—**nano-banana-edit** maintains character consistency across modifications, making it perfect for iterative workflows in creative projects.

## Usage Notes

- API Base URL: `https://api.eachlabs.ai/v1`
- Authentication: send `X-API-Key: YOUR_API_KEY`. Generate a key from the Eachlabs dashboard at https://www.eachlabs.ai/dashboard/api-keys.
- File-typed parameters (`*_url`, `image_url`, `video_url`, `audio_url`, etc.) accept publicly-reachable HTTPS URLs only. Upload your asset first (GCS / S3 / your CDN) and pass the resulting URL. Data-URIs and localhost URLs are rejected.
- For structured parameters (arrays / objects) send real JSON values, not stringified payloads.
- Monetary values are reported in USD; per-token / per-megapixel rates may be billed in micro-cents internally.
- Prefer `webhook_url` over polling for long-running predictions — see the Webhook Callback section.