# POST /v1/images/edits

**Method**: `POST`
**Endpoint**: `/v1/images/edits`

Supports gpt-image-1, flux-kontext-pro, and flux-kontext-max

## Request Parameters

### Header Parameters

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

### Body Parameters multipart/form-data

```text
image
file
Supports multiple images
Required
Example:
E:\\Desktop\\gpt\\icon_samll2.png
prompt
string
Required
Example:
Put on glasses
model
string
Required
Supports gpt-image-1, flux-kontext-pro, and flux-kontext-max
Example:
gpt-image-1
```

## Example Request

### Shell

```bash
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="gpt-image-1"'
```

## Response

### 🟢 200 Success

**Content Type**: `application/json`

#### Response Schema

```text
object
```

#### Example

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