POST /v1/images/edits

Method: POSTEndpoint: /v1/images/edits

Request Parameters

Header Parameters

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

Body Parameters multipart/form-data

image
file
Supports multiple images
Required
Example:
E:\\Desktop\\gpt\\icon_samll2.png
prompt
string
Required
Example:
Put on glasses
model
string
Required
Example:
qwen-image-edit
size
string
Optional
Example:
1024x1024
seed
string
Optional
guidance_scale
string
Optional
n
string
Optional
enable_safety_checker
string
Optional
output_format
string
Optional
negative_prompt
string
Optional

Example Request

Shell

curl --location --request POST '/v1/images/edits' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--form 'image=@"E:\\\\Desktop\\\\gpt\\\\icon_samll2.png"' \
--form 'prompt="Put on glasses"' \
--form 'model="qwen-image-edit"' \
--form 'size="1024x1024"' \
--form 'seed=""' \
--form 'guidance_scale=""' \
--form 'n=""' \
--form 'enable_safety_checker=""' \
--form 'output_format=""' \
--form 'negative_prompt=""'

Response

🟢 200 Success

Content Type: application/json

Response Schema

object

Example

{
    "created": 1713833628,
    "data": [
        {
            "url": "..."
        }
    ],
    "usage": {
        "total_tokens": 100,
        "input_tokens": 50,
        "output_tokens": 50,
        "input_tokens_details": {
            "text_tokens": 10,
            "image_tokens": 40
        }
    }
}