# Редактирование изображений OpenAI

Загрузка изображений, ограничения и оплата POST /openai/api/v1/images/edits.

`POST /openai/api/v1/images/edits` редактирует изображения моделями GPT Image. Поля описаны в [документации OpenAI Create image edit](https://developers.openai.com/api/reference/resources/images/methods/edit), модели — в [каталоге](https://coreinfra.ru/docs/catalog.md).

Минимальный запрос с локальным PNG-файлом `image.png`:

```bash
curl https://hub.coreinfra.ai/openai/api/v1/images/edits \
  -H "Authorization: Bearer $COREINFRA_API_KEY" \
  -F 'model=gpt-image-1' \
  -F 'prompt=Сделайте фон белым' \
  -F 'image=@image.png;type=image/png'
```

Фрагмент ответа:

```json
{"data":[{"b64_json":"…"}]}
```

## Отличия от API OpenAI

Хаб принимает JSON и `multipart/form-data`. Загрузки `image` и `image[]` преобразуются в `images[]`; загруженные `mask` и `markup` сохраняют назначение. Байты файлов преобразуются в base64 data URL. У загружаемого файла должен быть тип `image/*`.

В JSON изображения задаются через `images[].image_url`, маска и разметка — через `mask.image_url` и `markup.image_url`. Принимаются только данные в кодировке base64 (`data:image/...;base64,...`). Непустой `file_id` и ссылка на внешний ресурс отклоняются со статус-кодом `400`; строковый адрес изображения в multipart проходит ту же проверку. Размер всего запроса ограничен [общими лимитами](https://coreinfra.ru/docs/reference.md#limits).

Поля `user` и `safety_identifier` игнорируются. Параметр `output_format: "svg"` и модель `glm-image` в этом API методе отклоняются со статус-кодом `400`.

Резерв учитывает текст, входные изображения и разметку, а также оценку выходных токенов по размеру и количеству изображений, включая частичные. Маска не входит в оценку входа. При `size: auto` или неизвестном размере используется оценка наибольшего изображения модели.

Списание идет по `usage.input_tokens` и `usage.output_tokens`. Цены находятся на [«Тарифах»](https://hub.coreinfra.ai/pricing), подробности — на странице [«Стоимость генерации изображений»](https://coreinfra.ru/docs/billing/images.md).

## Ошибки

* `400` — неверный JSON или multipart, недопустимое вложение, отсутствующая либо неподдерживаемая модель, `output_format: "svg"` или модель без поддержки редактирования (`glm-image`).
* `502` — ошибка на стороне провайдера модели при выполнении запроса.

Формат ошибок приведен в [разделе OpenAI API](https://coreinfra.ru/docs/reference/openai.md#errors); общие ошибки авторизации, баланса и лимитов расходов описаны в [общем справочнике](https://coreinfra.ru/docs/reference.md#errors).
