---
title: "Nano Banana Pro Edit"
method: POST
path: "/api/v1/nano-banana-pro/edit"
tags: ["ImageAPI"]
---

# Nano Banana Pro Edit

`POST /api/v1/nano-banana-pro/edit`

## Request

- Base URL: `https://api.goenhance.ai`
- URL: `https://api.goenhance.ai/api/v1/nano-banana-pro/edit`
- Auth: none required
- TypeScript: <https://skmtc.dev/goenhance/apis/goenhance-api/docs/api/v1/nano-banana-pro/edit/post.ts> (a function with typed inputs; its response is checked against the schema)

**Pricing** — per image, in tokens (USD at $0.02/token):

| image_size | tokens | USD |
|---|---|---|
| 1k | 7 | $0.140 |
| 2k | 7 | $0.140 |
| 4k | 12 | $0.240 |

Returns an `img_uuid`; poll GET /api/v1/jobs/detail (or use `custom_callback_url`) to get the generated image.

## Headers

- `Authorization` string

## Request body

- object
  - `prompt` string, required: Text prompt describing the image.
  - `image_list` object[], required: Reference images, e.g. [{"url": "https://..."}].
    - `url` string, uri
  - `ratio` 'auto' | '1:1' | '16:9' | '9:16' | '4:3' | '3:4' | '2:3' | '3:2' | '4:5' | '5:4' | '21:9': Aspect ratio.
  - `image_size` '1k' | '2k' | '4k': Output resolution. Pricing (tokens/image): 1k: 7, 2k: 7, 4k: 12.
  - `web_search` boolean: Enable web search grounding.
  - `custom_callback_url` string, uri: Optional. A publicly accessible HTTPS URL. When the task status changes (processing / success / failed), GoEnhance sends a POST request to this URL. The request body is identical to the response of GET /api/v1/jobs/detail. If your server does not respond with HTTP 200, the notification is retried up to 3 times, with a 3-second timeout per attempt.

## Response `200`

- object
  - `code` integer, required
  - `msg` string, required
  - `data` object, required
    - `img_uuid` string, required

## Other responses

- `401`

---

[API](https://skmtc.dev/goenhance/apis/goenhance-api.md) - [All operations](https://skmtc.dev/goenhance/apis/goenhance-api/llms.txt) - [OpenAPI document](https://skmtc.dev/goenhance/apis/goenhance-api/revisions/0f636e1b6caf?raw)