Image Editing (gpt-image-1)
POST
https://api.cometapi.com/v1/images/edits
Maintainer:Not configured
Image Editing Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
image | file or file array | ✅ | The image(s) to edit. Must be a supported image file or array. • gpt-image-1: PNG, WEBP, or JPG, each <25MB. • dall-e-3: 1 square PNG <4MB. |
prompt | string | ✅ | A text description of the desired image(s). • Max length: 1000 chars for dall-e-3, 32000 chars for gpt-image-1. |
mask | file | Optional PNG mask image. Transparent areas (alpha = 0) indicate regions to edit. Must match size of image and be <4MB. Applies to first image. | |
model | string | Model to use: "dall-e-3" or "gpt-image-1". | |
n | integer or null | Number of images to generate. Must be between 1 and 10. Default: 1. | |
quality | string or null | For gpt-image-1 only. Options: "high", "medium", "low".Default: "auto". | |
response_format | string or null | Response format. Options: "url" or "b64_json".Only dall-e-3 supports "url" (valid for 60 minutes). | |
size | string or null | Image size: • gpt-image-1: "1024x1024", "1536x1024", "1024x1536", "auto" (default)• dall-e-3: "256x256", "512x512", "1024x1024" |
Request
Header Params
Body Params multipart/form-data
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.cometapi.com/v1/images/edits' \
--header 'Authorization: Bearer {{api-key}}' \
--form 'image=@"MQ==/test.png"' \
--form 'prompt="Put on glasses"' \
--form 'model="gpt-image-1"' \
--form 'mask=@""' \
--form 'n=""' \
--form 'quality=""' \
--form 'response_format=""' \
--form 'size=""'Response Response Example
{
"created": 1713833628,
"data": [
{
"b64_json": "..."
}
],
"usage": {
"total_tokens": 100,
"input_tokens": 50,
"output_tokens": 50,
"input_tokens_details": {
"text_tokens": 10,
"image_tokens": 40
}
}
}Modified at 2025-10-26 05:42:11