Перейти к содержанию

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

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

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

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

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

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. При работе через хаб действуют следующие отличия:

  • Обслуживается только 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).

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

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

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

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

МетодПутьНазначение и справочник
POST/systemoneTypeSafe System One

Когда выбирать модели принятия решений и как устроены типы вопросов — на странице «Модели принятия решений». Идентификаторы моделей приведены в каталоге моделей, правила расчета — на странице «Стоимость моделей принятия решений».

Ошибки​

Формат и примеры ошибок проверки запроса приведены в справочнике TypeSafe API. Общие ошибки авторизации, баланса и лимитов расходов описаны в общем справочнике API и на странице «Лимиты и ограничения».