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

Настройка клиента TypeSafe System One для вызова моделей принятия решений через CoreInfra AI Hub.

TypeSafe-совместимый API хаба позволяет вызывать [модели принятия решений](https://coreinfra.ru/docs/decisions.md) через хаб без VPN по протоколу TypeSafe System One с оплатой по ключу хаба.

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

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

Минимальный запрос через cURL:

```bash
export COREINFRA_API_KEY='sk-ci2-...'
curl https://hub.coreinfra.ai/typesafe/api/v1/systemone \
  -H "Authorization: Bearer $COREINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"jev-latest","state":"2 + 2 = 4","questions":{"check":{"type":"noul","instructions":"Верно ли равенство?"}}}'
```

Результат вопроса `check` приходит в `answers.check`. Это решение модели, а не текстовый ответ чата.

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

Полное описание протокола приведено в [документации TypeSafe System One](https://docs.typesafe.ai/api/system-one). При работе через хаб действуют следующие отличия:

* Обслуживается только API метод `POST /systemone`; отдельного `GET /models` на этом адресе нет.
* Стриминг ответа SSE-событиями и неизвестные поля в запросе не поддерживаются (возвращается ошибка со статус-кодом `400`). Поле `inference_geo` игнорируется.
* В JSON изображения передаются в `assets` через `data_base64` (PNG или JPEG); для запросов с изображениями или вопросами `box` к моделям TypeSafe передавайте заголовок `TypeSafe-Danger-Zone-Images: true`. Также поддерживается загрузка PNG и JPEG через `multipart/form-data` (подробности — в [справочнике System One](https://coreinfra.ru/docs/reference/typesafe/systemone.md)).

## Конвертация

По этому адресу можно также вызвать модель, работающую по протоколу OpenAI Decisions (например, `gpt-6-luna`) — хаб конвертирует запрос на своей стороне и вернет ответ в формате TypeSafe System One. При такой конвертации вопросы `box` (поиск координат объекта на изображении) не поддерживаются и отклоняются со статус-кодом `400`.

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

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

| Метод  | Путь         | Назначение и справочник                                                          |
| ------ | ------------ | -------------------------------------------------------------------------------- |
| `POST` | `/systemone` | [TypeSafe System One](https://coreinfra.ru/docs/reference/typesafe/systemone.md) |

Когда выбирать модели принятия решений и как устроены типы вопросов — на странице [«Модели принятия решений»](https://coreinfra.ru/docs/decisions.md). Идентификаторы моделей приведены в [каталоге моделей](https://coreinfra.ru/docs/catalog.md#decisions), правила расчета — на странице [«Стоимость моделей принятия решений»](https://coreinfra.ru/docs/billing/decisions.md).

## Ошибки

Формат и примеры ошибок проверки запроса приведены в [справочнике TypeSafe API](https://coreinfra.ru/docs/reference/typesafe.md#errors). Общие ошибки авторизации, баланса и лимитов расходов описаны в [общем справочнике API](https://coreinfra.ru/docs/reference.md#errors) и на странице [«Лимиты и ограничения»](https://coreinfra.ru/docs/limits.md).
