# OpenRouter-совместимый API

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

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

## Адрес и авторизация

Базовый адрес — `https://hub.coreinfra.ai/openrouter/api/v1`. Передавайте ключ хаба в `Authorization: Bearer sk-ci2-...`.

Описание полей запросов приведено в [документации OpenRouter](https://openrouter.ai/docs/quickstart). Настройка клиента описана на странице [«OpenRouter-совместимый API»](https://coreinfra.ru/docs/use/openrouter.md).

## API методы

Пути в таблице указаны относительно базового адреса `https://hub.coreinfra.ai/openrouter/api/v1`. `OPTIONS` выполняет CORS preflight для того же пути и возвращает статус-код `204` без тела; ключ для preflight не нужен.

| Методы            | Путь                      | Назначение                                                                                     |
| ----------------- | ------------------------- | ---------------------------------------------------------------------------------------------- |
| `GET`, `OPTIONS`  | `/models`                 | [Список доступных моделей](https://coreinfra.ru/docs/reference/openrouter/models.md)           |
| `POST`, `OPTIONS` | `/images`                 | [Генерация изображений](https://coreinfra.ru/docs/reference/openrouter/images.md)              |
| `POST`, `OPTIONS` | `/videos`                 | [Создание задания генерации видео](https://coreinfra.ru/docs/reference/openrouter/videos.md)   |
| `GET`, `OPTIONS`  | `/videos/{jobId}`         | [Статус задания генерации видео](https://coreinfra.ru/docs/reference/openrouter/videos-job.md) |
| `GET`, `OPTIONS`  | `/videos/{jobId}/content` | [Скачивание видео](https://coreinfra.ru/docs/reference/openrouter/videos-content.md)           |

## Ответы и поток

Список моделей, генерация изображений без потока и операции со статусом заданий генерации видео используют JSON. Скачивание видео возвращает поток байтов.

Для изображений `stream: true` запрашивает SSE с `Content-Type: text/event-stream`. В `data:` приходит JSON с полем `type`: `image_generation.partial_image`, `image_generation.text_chunk`, `image_generation.completed` или `error`. Для некоторых моделей потоковый режим не поддерживается — в таких случаях хаб возвращает обычный JSON-ответ.

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

## Ошибки

Ошибки имеют формат OpenRouter:

```json
{"error":{"code":400,"message":"Missing required parameter: 'model'."}}
```

Данный формат ошибок используется при проверке параметров медиазапроса. Ошибка авторизации или недостатка средств возвращает ответ со статус-кодом `400` (при недействительном ключе или недостатке средств — с текстовым сообщением об ошибке; при отсутствующем заголовке авторизации — с пустым телом). Подробнее формат и коды общих ошибок хаба описаны в [общем справочнике](https://coreinfra.ru/docs/reference.md#errors) и на странице [«Лимиты и ограничения»](https://coreinfra.ru/docs/limits.md).
