OpenAI

Створення редагування зображення

Використовуйте POST /v1/images/edits у CometAPI для редагування зображень за допомогою multipart-завантажень, масок, GPT image models і параметрів керування закодованим виводом зображення.

POST

images

edits

curl https://api.cometapi.com/v1/images/edits \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F image=@cat.jpg \
  -F prompt="Add a small red bow tie on the cat" \
  -F model=gpt-image-2 \
  -F quality=low

{
  "created": 1781075000,
  "background": "opaque",
  "output_format": "png",
  "quality": "low",
  "size": "1024x1024",
  "usage": {
    "input_tokens": 784,
    "input_tokens_details": {
      "image_tokens": 768,
      "text_tokens": 16
    },
    "output_tokens": 196,
    "output_tokens_details": {
      "image_tokens": 196,
      "text_tokens": 0
    },
    "total_tokens": 980
  },
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
    }
  ]
}

Використовуйте цей маршрут, щоб редагувати наявні зображення за допомогою сумісних з OpenAI multipart-завантажень у CometAPI.

Використовуйте цей маршрут, коли

У вас уже є вихідне зображення, і ви хочете редагування за Prompt
Вам може знадобитися маска для цільових змін
Ви можете працювати з multipart-завантаженням файлів замість звичайного JSON-запиту

Безпечний перший запит

Почніть з одного файла PNG або JPG
Пропустіть маску, доки не запрацює базовий сценарій редагування
Використовуйте model: "gpt-image-2" для запитів на редагування GPT image у цьому маршруті
Використовуйте одну коротку інструкцію, яка просить про одну видиму зміну
Зчитуйте відредагований результат із data[0].b64_json
Встановіть output_format: "jpeg", якщо вам потрібне корисне навантаження JPEG
Очікуйте довшу затримку, ніж у звичайній генерації зображень

Поведінка моделі

Моделі GPT image edit у цьому маршруті повертають вбудовані base64-дані зображення
output_format керує типом закодованого зображення всередині b64_json
response_format має значення лише тоді, коли модель підтримує вивід URL
qwen-image-edit дотримується специфічної для провайдера поведінки редагування за тим самим маршрутом CometAPI

Авторизації

Authorization

string

header

обов'язково

Bearer token authentication. Use your CometAPI key.

Тіло

multipart/form-data

image

file

обов'язково

Source image file. Start with one PNG or JPG input for the simplest flow.

prompt

string

обов'язково

Edit instruction describing the change you want.

Приклад:

"Add a small red ribbon to the paper boat."

model

string

за замовчуванням:gpt-image-2

The image editing model to use. Choose a supported model from the Models page.

mask

file

Optional PNG mask. Transparent areas mark the regions to edit. The mask dimensions must match the source image exactly.

string

за замовчуванням:1

Number of edited images to return.

quality

enum<string>

Quality setting for models that support it.

Доступні опції:

high,

medium,

low

response_format

enum<string>

Requested response container when supported by the selected model. GPT image edit models return data[].b64_json; use output_format to choose the encoded image type.

Доступні опції:

url,

b64_json

output_format

string

Encoded image type for GPT image edit results returned in data[].b64_json. For example, use jpeg for a JPEG payload.

Приклад:

"jpeg"

size

string

Requested output size when supported by the selected model.

Відповідь

200 - application/json

Edited image result.

created

integer

обов'язково

usage

object

обов'язково

Show child attributes

data

object[]

обов'язково

Show child attributes

background

string

Background mode returned by models that expose it.

output_format

string

Encoded image type returned by GPT image models.

quality

string

Quality level returned by models that expose it.

size

string

Output size returned by models that expose it.

Останнє оновлення 23 червня 2026 р.

curl https://api.cometapi.com/v1/images/edits \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F image=@cat.jpg \
  -F prompt="Add a small red bow tie on the cat" \
  -F model=gpt-image-2 \
  -F quality=low

{
  "created": 1781075000,
  "background": "opaque",
  "output_format": "png",
  "quality": "low",
  "size": "1024x1024",
  "usage": {
    "input_tokens": 784,
    "input_tokens_details": {
      "image_tokens": 768,
      "text_tokens": 16
    },
    "output_tokens": 196,
    "output_tokens_details": {
      "image_tokens": 196,
      "text_tokens": 0
    },
    "total_tokens": 980
  },
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
    }
  ]
}

Модерація контенту

API-ключі

Створення редагування зображення

Використовуйте цей маршрут, коли

Безпечний перший запит

Поведінка моделі

Авторизації

Тіло

Відповідь

​Використовуйте цей маршрут, коли

​Безпечний перший запит

​Поведінка моделі

Авторизації

Тіло

Відповідь

Використовуйте цей маршрут, коли

Безпечний перший запит

Поведінка моделі