Перейти к основному содержанию
POST
/
v1
/
images
/
edits
Edit images
curl --request POST \
  --url https://api.cometapi.com/v1/images/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'prompt=Add a small red ribbon to the paper boat.' \
  --form image='@example-file' \
  --form mask='@example-file'
{
  "created": 1773381100,
  "usage": {
    "input_tokens": 226,
    "input_tokens_details": {
      "image_tokens": 194,
      "text_tokens": 32
    },
    "output_tokens": 4160,
    "total_tokens": 4386
  },
  "data": [
    {
      "b64_json": "<base64-image-data>"
    }
  ]
}
Используйте этот маршрут, чтобы редактировать существующие изображения через OpenAI-совместимые multipart-загрузки в CometAPI.

Используйте этот маршрут, когда

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

Первый путь валидации

  • Начните с одного PNG- или JPG-файла
  • Пропустите маску, пока не убедитесь, что базовый сценарий редактирования работает
  • Используйте одну короткую инструкцию с просьбой внести одно видимое изменение
  • Ожидайте более высокой задержки, чем при обычной генерации изображений

Поведение модели

  • gpt-image-1, gpt-image-1-mini и gpt-image-1.5 лучше рассматривать как маршруты редактирования с приоритетом base64
  • dall-e-3 может возвращать URL-результат, если это поддерживается маршрутом провайдера
  • qwen-image-edit следует специфичному для провайдера поведению редактирования за тем же маршрутом CometAPI
Проверка в реальных условиях от 2026-03-13 подтвердила, что запрос gpt-image-1 на основе PNG успешно выполнился при увеличенном timeout. Ответ содержал usage.input_tokens, usage.output_tokens, usage.total_tokens и payload data[0].b64_json.

Авторизации

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-1

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

mask
file

Optional PNG mask. Transparent areas indicate regions that should be edited.

n
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 output format when supported by the selected model.

Доступные опции:
url,
b64_json
size
string

Requested output size when supported by the selected model.

Ответ

200 - application/json

Edited image result.

created
integer
обязательно
data
object[]
обязательно
usage
object