Edit image (GET)

Modify an existing image using query parameters. Image must be provided as a URL.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Provide a URL, or send base64-encoded data along with your editing prompt. The API will intelligently apply your requested changes and return the edited image.

Query Params
string
required
length ≥ 1

Text instruction for editing the image.

uri
required

Image URL to edit.

string
enum
Defaults to nano-banana

Edit model. Only nano-banana is documented for this worker.

Allowed:
integer
1 to 4
Defaults to 1

Number of edited images to request.

string
enum
Defaults to 1024x1024

OpenAI-compatible legacy size parameter. Prefer aspect_ratio for Nano Banana. Known mappings: 1024x1024 -> 1:1, 1792x1024 -> 16:9, 1024x1792 -> 9:16, 768x1024 -> 3:4, 1024x768 -> 4:3.

Allowed:
string
enum
Defaults to 1:1

Aspect ratio for edited images.

Allowed:
string
enum
Defaults to url

Response format. Use url for a worker-hosted image URL, or b64_json for base64 image data.

Allowed:
Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json