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

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

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

## 1. Настройте адрес и ключ

Укажите базовый адрес `https://hub.coreinfra.ai/openrouter/api/v1` и подставьте ключ хаба `sk-ci2-...` в заголовок `Authorization: Bearer`.

Проверьте вызов через cURL:

```bash
export COREINFRA_API_KEY='sk-ci2-...'
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":"Красный круг на белом фоне"}'
```

В ответе изображение приходит в `data[].b64_json`, его тип — в `data[].media_type`.

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

Полное описание параметров запросов приведено в [документации OpenRouter](https://openrouter.ai/docs/api-reference/overview). При работе через хаб действуют следующие отличия:

* Этот адрес API не поддерживает текстовые модели. Для текстовых запросов используйте [OpenAI-совместимый API](https://coreinfra.ru/docs/use/openai.md).
* Поле `user` и настройки маршрутизации внутри объекта `provider` (кроме `provider.options`) игнорируются.
* У видео параметр `callback_url` отсутствует: проверяйте состояние задания опросом `GET /videos/{jobId}`. Для получения статуса и скачивания видео используйте ключ хаба, с помощью которого было создано задание. До завершения задания скачивание возвращает ошибку со статус-кодом `409`.
* Входные изображения передавайте в кодировке base64 (`data:image/...;base64,...`). Ссылки на внешние ресурсы отклоняются со статус-кодом `400`.
* Для некоторых моделей изображений `stream: true` не поддерживается — в таких случаях хаб возвращает обычный JSON-ответ.
* Когда ответ содержит данные о стоимости и сумма списания рассчитана, хаб возвращает стоимость запроса в рублях в поле `usage.cost_rub`: для изображений — в JSON-ответе и в завершающем событии потока `image_generation.completed` (в промежуточных событиях `image_generation.partial_image` и `image_generation.text_chunk` поле отсутствует), а для видео — в объекте завершенного задания (пока задание находится в статусе `pending` или `in_progress` либо если данные о стоимости в `usage` отсутствуют, поле не добавляется). Фактическое списание по каждому запросу всегда доступно в [аналитике](https://coreinfra.ru/docs/team-analytics.md#analytics); правила оплаты описаны на страницах [«Стоимость генерации изображений»](https://coreinfra.ru/docs/billing/images.md) и [«Стоимость видео»](https://coreinfra.ru/docs/video-billing.md).

## Что доступно

Доступны следующие API методы относительно базового адреса `https://hub.coreinfra.ai/openrouter/api/v1`:

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

Получите список доступных моделей запросом `GET /models` с тем же Bearer-ключом. Возможности моделей приведены в [каталоге моделей](https://coreinfra.ru/docs/catalog.md), цены — на странице [«Тарифы»](https://hub.coreinfra.ai/pricing).

## Ошибки

Неизвестная или неподходящая для этого API метода модель возвращает ошибку со статус-кодом `400`, а обращение к чужому или несуществующему видеозаданию — со статус-кодом `404`. Формат и примеры ошибок приведены в [справочнике OpenRouter API](https://coreinfra.ru/docs/reference/openrouter.md#errors), а общие ошибки авторизации, баланса и лимитов расходов — в [общем справочнике API](https://coreinfra.ru/docs/reference.md#errors) и на странице [«Лимиты и ограничения»](https://coreinfra.ru/docs/limits.md).
