Skip to main content
POST
Nano Banana 2.1 Edit

Headers

Authorization
string

Body

application/json
model
enum<string>
required

Model name. Must be nano-banana-2-1-edit.

Available options:
nano-banana-2-1-edit
prompt
string
required

Text prompt describing the image.

Required string length: 1 - 2000
image_list
object[]
required

Reference images, e.g. [{"url": "https://..."}].

Required array length: 1 - 9 elements
ratio
enum<string>
default:auto

Output aspect ratio. Defaults to auto, which lets the model choose the framing from your prompt.

Available options:
auto,
1:1,
16:9,
9:16,
4:3,
3:4,
2:3,
3:2,
4:5,
5:4,
21:9,
1:4,
4:1,
1:8,
8:1
image_size
enum<string>
default:1k

Output resolution. Price per image:

  • 1k — 2.92 tokens ($0.0584)
  • 2k — 4.02 tokens ($0.0804)
  • 4k — 8.08 tokens ($0.1616)

0.5k is not available on this model.

Available options:
1k,
2k,
4k

Enable web search grounding.

thinking_level
enum<string>

Reasoning depth. Omit it to use the model's default (medium); thinking cannot be turned off on this model.

Available options:
High,
Minimal
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.

Example:

"https://your-server.com/goenhance/callback"

Response

code
integer
required
msg
string
required
data
object
required