# Генерация изображений OpenAI

Изменяемые поля, ограничения GLM Image и оплата POST /openai/api/v1/images/generations.

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

```bash
curl https://hub.coreinfra.ai/openai/api/v1/images/generations \
  -H "Authorization: Bearer $COREINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"gpt-image-1","prompt":"Белый круг на черном фоне"}'
```

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

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

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

Поля `user` и `safety_identifier` игнорируются. Параметр `output_format: "svg"` у моделей GPT Image отклоняется со статус-кодом `400`.

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

### Для GLM Image

Для `glm-image` передавайте JSON; ответ возвращается в формате OpenAI Images:

* Генерируется одно изображение. Если `n` задан, он должен быть равен `1`. `stream: true`, а также заданные `images`, `mask` или `markup` отклоняются со статус-кодом `400`.
* Значения `quality: low`, `medium` и `standard` соответствуют `standard`, а `high`, `xhigh`, `max` и `hd` — `hd`.
* Игнорируются `size: auto`, `background`, `complexity`, `output_format`, `frame_count`, `frame_duration_ms`, `svg`, `output_compression`, `partial_images`, `moderation`, `response_format`, `style` и `input_fidelity`.
* Сгенерированное изображение возвращается в `data[].b64_json` (до 32 МиБ).

### Резерв и списание

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

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

## Ошибки

* `400` — отсутствует `model`, модель не поддерживает Images, переданы запрещенные вложения или `output_format: "svg"` у моделей GPT Image, либо нарушены ограничения `glm-image`.
* `502` — ошибка на стороне провайдера модели при выполнении запроса.

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