Skip to content

Image Editing nano-banana

Overview

  • Method: POST
  • Path: /v1/images/edits

Authentication

  • Use HTTP Bearer Token, e.g.: Authorization: Bearer sk-xxxxx

Request Parameters (multipart/form-data)

ParameterTypeRequiredDescription
imagefileYes1-6 images, PNG/JPG/WebP
promptstringYesText description, max 32768 tokens
modelstringYesnano-banana / gemini-3-pro-image-preview etc.
response_formatstringNob64_json/url
sizestringNo1:1/2:3/3:2/3:4/4:3/4:5/5:4/9:16/16:9/21:9/1k/2k/4k
aspect_ratiostringNo2:3 etc. (pro series only)
nnumberNo1-10

Request Example

bash
curl -X POST "https://api.gpt.ge/v1/images/edits" \
  -H "Authorization: Bearer sk-xxxx" \
  -F "image=@otter.png" \
  -F "mask=@mask.png" \
  -F "prompt=A cute otter baby wearing a beret." \
  -F "model=nano-banana" \
  -F "n=2" \
  -F "size=1024x1024"

Response Example (200)

json
{
  "created": 1725007743,
  "data": [{"url": "https://oaidalleapiprod..."}]
}