# POST /images — генерация изображений

Поля, ограничения, поток и списание средств при генерации изображений через OpenRouter-совместимый API хаба.

`POST /openrouter/api/v1/images` создает изображения по тексту и референсам для моделей изображений из [списка медиамоделей](https://coreinfra.ru/docs/reference/openrouter/models.md). Поля запроса описаны в [документации OpenRouter](https://openrouter.ai/docs/api/api-reference/images/generate-an-image).

```bash
curl https://hub.coreinfra.ai/openrouter/api/v1/images \
  -H "Authorization: Bearer $COREINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"bytedance-seed/seedream-5-0-flash","prompt":"Круг"}'
```

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

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

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

Поле `user` и настройки маршрутизации в `provider` (кроме `provider.options`) игнорируются.

В изображениях из `input_references` поле `image_url.url` должно содержать встроенное изображение в кодировке base64 (`data:image/...;base64,...`). Ссылки на внешние ресурсы отклоняются со статус-кодом `400`.

Недоступная модель возвращает ошибку со статус-кодом `400`.

Для некоторых моделей `stream: true` не поддерживается — в таких случаях хаб возвращает обычный JSON-ответ. Формат потока описан в [разделе API](https://coreinfra.ru/docs/reference/openrouter.md#responses).

Перед вызовом хаб резервирует стоимость запрошенного числа изображений `n`, а при завершении списывает фактическую стоимость (правила расчета — на странице [«Стоимость генерации изображений»](https://coreinfra.ru/docs/billing/images.md)). Отключение клиента не останавливает обработку уже запущенного запроса.

Когда в `usage` присутствуют данные о стоимости и сумма списания рассчитана, хаб возвращает стоимость запроса в рублях в поле `usage.cost_rub` в JSON-ответе и в завершающем событии потока `image_generation.completed` (в промежуточных событиях потока или при отсутствии данных о стоимости в `usage` поле не добавляется). Цены опубликованы на странице [«Тарифы»](https://hub.coreinfra.ai/pricing).

## Ошибки

| Статус-код | Условие                                                                              |
| ---------- | ------------------------------------------------------------------------------------ |
| `400`      | Отсутствующая или недоступная для этого API метода модель                            |
| `400`      | Некорректный JSON или ссылка на внешний ресурс вместо изображения в кодировке base64 |
| `502`      | Ошибка на стороне провайдера модели при выполнении запроса                           |

Общие ошибки ключа, баланса и лимитов — в [справочнике API](https://coreinfra.ru/docs/reference.md#errors); формат ошибок — в [разделе этого API](https://coreinfra.ru/docs/reference/openrouter.md#errors).
