POST /v1/images/edits

Method: POSTEndpoint: /v1/images/edits

Supports multiple images or no reference image.

Request Parameters

Header Parameters

Authorization
string
Optional
Default Value:
Bearer {{YOUR_API_KEY}}

Body Parameters multipart/form-data

model
string
Required
Example:
gemini-3.1-flash-image-preview
prompt
string
Required
Example:
A cat
image
file
Required
Supports multiple images or no reference image.
Example:
["file://E:\\Downloads\\1745936044575403500.png","file://E:\\Downloads\\image_20250826114255_1785.jpg"]
response_format
string
Optional
url or b64_json
Example:
url
aspect_ratio
enum<string>
Optional
Enum Values:
4:3
3:4
16:9
9:16
2:3
3:2
1:1
4:5
5:4
21:9
1:4
4:1
8:1
1:8
image_size
enum<string>
Optional
Enum Values:
1K
2K
4K
512px
Example:
4K

Example Request

Shell

curl --location --request POST '/v1/images/edits' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--form 'model="gemini-3.1-flash-image-preview"' \
--form 'prompt="A cat"' \
--form 'image=@"E:\\Downloads\\1745936044575403500.png"' \
--form 'image=@"E:\\Downloads\\image_20250826114255_1785.jpg"' \\
--form 'response_format="url"' \
--form 'aspect_ratio=""' \
--form 'image_size="4K"'

Response

🟢 200 Success

Content Type: application/json

Response Schema

object

Example

{}