> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apisale.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Nano Banana 2 Lite — Edit
> Nano Banana 2 Lite image editing — fast multi-turn local edits at fixed 1K. Optimized for image to image via apisale.
## Overview
Nano Banana 2 Lite image editing — fast multi-turn local edits at fixed 1K. Optimized for image to image via apisale.
**Docs** = API contract + Try it (snapshot). **[Explore](https://apisale.ai/explore)** = browser playground. **[Model page](https://apisale.ai/models/google/nano-banana-2-lite/edit)** = product examples.
## Endpoint
```http theme={null}
POST https://api.apisale.ai/v1/run/google/nano-banana-2-lite/edit
```
| | |
| -------------- | -------------------------------- |
| **Model slug** | `google/nano-banana-2-lite/edit` |
| **Category** | Edit (`image-to-image`) |
| **Lab** | Google |
| **Mode** | async |
## Pricing
**From \$0.024/image**
apisale price is **30%** below the vendor's official list price.
| Tier | Unit | Official price | apisale price |
| -------------- | ----- | -------------- | ------------- |
| per image (1K) | image | \$0.034 | \$0.024 |
**Official price** = vendor list price. **apisale price** = what you pay through apisale.
## Request
```json theme={null}
{
"input": {
"prompt": "make a photo of the man driving the car down the california coastline",
"num_images": 1,
"aspect_ratio": "16:9",
"output_format": "png",
"system_prompt": "",
"safety_tolerance": "4"
}
}
```
### Parameters
Fields marked \* are required. Use `Authorization: Key YOUR_API_KEY` for REST.
Text prompt describing the edit.
Input image URLs for editing (1-14).
Default: `1` Range: 1 – 4
Default: `auto` Values: `auto`, `21:9`, `16:9`, `3:2`, `4:3`, `5:4`, `1:1`, `4:5`, `3:4`, `2:3`, `9:16`, `4:1`, `1:4`, `8:1`, `1:8`
Default: `png` Values: `jpeg`, `png`, `webp`
Default: \`\`
Values: `minimal`, `high`
Default: `4` Values: `1`, `2`, `3`, `4`, `5`, `6`
Optional HTTPS webhook when the run reaches a terminal state.
Block until completion (same Run response shape).
```json expandable theme={null}
{
"params": {
"prompt": {
"type": "string",
"required": true,
"max_length": 10000,
"description": "Text prompt describing the edit."
},
"image_urls": {
"type": "array",
"required": true,
"max_items": 14,
"min_items": 1,
"description": "Input image URLs for editing (1-14)."
},
"num_images": {
"max": 4,
"min": 1,
"type": "int",
"default": 1
},
"aspect_ratio": {
"type": "enum",
"values": [
"auto",
"21:9",
"16:9",
"3:2",
"4:3",
"5:4",
"1:1",
"4:5",
"3:4",
"2:3",
"9:16",
"4:1",
"1:4",
"8:1",
"1:8"
],
"default": "auto"
},
"output_format": {
"type": "enum",
"values": [
"jpeg",
"png",
"webp"
],
"default": "png"
},
"system_prompt": {
"type": "string",
"default": "",
"max_length": 2000
},
"thinking_level": {
"type": "enum",
"values": [
"minimal",
"high"
]
},
"safety_tolerance": {
"type": "enum",
"values": [
"1",
"2",
"3",
"4",
"5",
"6"
],
"default": "4"
}
}
}
```
## Submit response
Returns a **Run** with `run_id`. Poll with [GET /v1/runs/\{run\_id}](/model-apis/poll-runs) or use **Try it** above.
Unique run ID — save for polling and webhooks.
`queued` (async) or terminal state for sync runs.
Result when `status` is `succeeded` — see **Output schema** below.
### Example (async submit)
```json theme={null}
{
"run_id": "run_550e8400-e29b-41d4-a716-446655440000",
"endpoint": "google/nano-banana-2-lite/edit",
"model": "edit",
"capability": "image",
"mode": "image-to-image",
"status": "queued",
"output": null,
"error": null,
"billing": null,
"created_at": "2026-06-27T12:00:00.000Z",
"started_at": null,
"completed_at": null,
"elapsed_ms": null
}
```
Full lifecycle: [Runs lifecycle](/model-apis/runs-lifecycle).
## Output
When `status` is `succeeded`, `output` follows this schema:
```json expandable theme={null}
{
"type": "object",
"example": {
"images": [
{
"url": "https://example.com/out.png",
"content_type": "image/png"
}
]
},
"required": [
"images"
],
"properties": {
"images": {
"type": "array",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string"
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"file_name": {
"type": "string"
},
"content_type": {
"type": "string"
}
}
}
},
"description": {
"type": "string"
}
},
"description": "Succeeded task output: normalized images."
}
```
## Example
```bash theme={null}
curl -X POST "https://api.apisale.ai/v1/run/google/nano-banana-2-lite/edit" \
-H "Authorization: Key YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"prompt": "make a photo of the man driving the car down the california coastline",
"num_images": 1,
"aspect_ratio": "16:9",
"output_format": "png",
"system_prompt": "",
"safety_tolerance": "4",
"limit_generations": true
}
}'
```
## Related
* [Runs lifecycle](/model-apis/runs-lifecycle)
* [Image API overview](/api/image)
* [Account API](/get-started/account-and-monitoring)
## OpenAPI
````yaml openapi-catalog.json POST /v1/run/google/nano-banana-2-lite/edit
openapi: 3.0.3
info:
title: apisale Model Catalog
version: '2026-09-01T09:47:50.773Z'
description: Per-model OpenAPI operations for Mintlify Try playground.
servers:
- url: https://api.apisale.ai
security: []
paths:
/v1/run/google/nano-banana-2-lite/edit:
post:
tags:
- Model catalog
- image
- Google
summary: Create Nano Banana 2 Lite — Edit
description: >-
Nano Banana 2 Lite image editing — fast multi-turn local edits at fixed
1K. Optimized for image to image via apisale.
operationId: submit-google-nano-banana-2-lite-edit
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- input
properties:
input:
type: object
properties:
prompt:
description: Text prompt describing the edit.
type: string
image_urls:
description: Input image URLs for editing (1-14).
type: array
items:
type: string
num_images:
type: number
minimum: 1
maximum: 4
default: 1
aspect_ratio:
type: string
enum:
- auto
- '21:9'
- '16:9'
- '3:2'
- '4:3'
- '5:4'
- '1:1'
- '4:5'
- '3:4'
- '2:3'
- '9:16'
- '4:1'
- '1:4'
- '8:1'
- '1:8'
default: auto
output_format:
type: string
enum:
- jpeg
- png
- webp
default: png
system_prompt:
type: string
default: ''
thinking_level:
type: string
enum:
- minimal
- high
safety_tolerance:
type: string
enum:
- '1'
- '2'
- '3'
- '4'
- '5'
- '6'
default: '4'
required:
- prompt
- image_urls
example:
prompt: >-
make a photo of the man driving the car down the
california coastline
num_images: 1
aspect_ratio: '16:9'
output_format: png
system_prompt: ''
safety_tolerance: '4'
webhook_url:
type: string
format: uri
sync:
type: boolean
default: false
example:
input:
prompt: >-
make a photo of the man driving the car down the california
coastline
num_images: 1
aspect_ratio: '16:9'
output_format: png
system_prompt: ''
safety_tolerance: '4'
responses:
'201':
description: Run accepted
content:
application/json:
schema:
$ref: '#/components/schemas/RunObject'
security:
- ApiKeyAuth: []
components:
schemas:
RunObject:
type: object
required:
- run_id
- endpoint
- model
- capability
- mode
- status
- created_at
properties:
run_id:
type: string
description: Unique run identifier
endpoint:
type: string
description: Model slug
model:
type: string
capability:
type: string
mode:
type: string
status:
type: string
enum:
- queued
- processing
- succeeded
- failed
- timeout
- cancelled
output:
type: object
nullable: true
error:
type: object
nullable: true
properties:
type:
type: string
description: Machine-readable error code
code:
type: number
description: HTTP status
message:
type: string
billing:
type: object
nullable: true
properties:
amount:
type: string
currency:
type: string
enum:
- usd
created_at:
type: string
format: date-time
started_at:
type: string
format: date-time
nullable: true
completed_at:
type: string
format: date-time
nullable: true
elapsed_ms:
type: number
nullable: true
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: Authorization
description: Key sk-... (native REST) or Bearer sk-... (vendor SDKs)
````