Hubris Integrations API
The Integrations API from Hubris — 2 operation(s) for integrations.
The Integrations API from Hubris — 2 operation(s) for integrations.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/hubris-pw:hubris-pw-integrations-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Hubris Integrations API
version: 1.0.0
description: 'OpenAI-совместимый API российского LLM-агрегатора. Все цены в рублях.
Версии и вывод из эксплуатации (deprecation policy): несовместимые изменения — только в новой версии префикса (`/v2`); об отключении эндпоинта или поля предупреждаем не меньше чем за 90 дней заголовками `Deprecation` (RFC 9745) и `Sunset` (RFC 8594), записью в журнале изменений и письмом. Подробно: https://hubris.pw/docs/api/versioning'
servers:
- url: https://api.hubris.pw
description: Production
tags:
- name: Integrations
paths:
/v1/integrations/bitrix24/connectors:
post:
operationId: createBitrix24Connector
tags:
- Integrations
summary: Создать коннектор Битрикс24
description: 'Коннектор подключает модель Hubris к CoPilot (BitrixGPT) портала Битрикс24 как собственный движок. Под коннектор выпускается отдельный API-ключ «Битрикс24 · »: расход по нему виден отдельно, отзыв ключа выключает коннектор.
`completions_url` из ответа передайте порталу в `ai.engine.register`. Адрес содержит секрет и показывается один раз.
Модель закрепляется за коннектором; нужна другая — создайте второй коннектор. Сам вызов ничего не списывает. Нужен ключ без ограничений (без лимита, адресов, «только чтения» и с включёнными «Деньгами кабинета»): выпущенный ключ тратит баланс аккаунта.'
security:
- bearerAuth: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/Bitrix24ConnectorCreateRequest'
responses:
'201':
description: Коннектор создан.
content:
application/json:
schema:
$ref: '#/components/schemas/Bitrix24ConnectorCreated'
'400':
description: 'Невалидное тело. Ответ — результат проверки схемы (`success: false`, `error.issues`), а не `{ error: { message, type, code } }`.'
'401':
description: Ключ не передан, невалиден, отозван или заморожен (`invalid_api_key`, `key_frozen_spike`).
'403':
description: 'Ключ с ограничениями (`key_restricted`): лимит, адреса, только чтение или выключенные «Деньги кабинета»; OAuth-токен — тоже. Ещё причины: management-ключ (`inference_key_required`), запрос не с адреса, к которому привязан ключ (`key_ip_not_allowed`), или заблокированный аккаунт (`account_blocked`).'
'404':
description: Модель не найдена (`model_not_found`).
'503':
description: Коннекторы временно недоступны (`bitrix24_unavailable`).
get:
operationId: listBitrix24Connectors
tags:
- Integrations
summary: Список коннекторов Битрикс24
description: 'Действующие коннекторы аккаунта, новые первыми: имя, модель, префикс выпущенного ключа, время создания и последнего использования. `completions_url` не возвращается — он показывается только при создании.'
security:
- bearerAuth: []
responses:
'200':
description: Коннекторы.
content:
application/json:
schema:
$ref: '#/components/schemas/Bitrix24ConnectorList'
'401':
description: Ключ не передан, невалиден, отозван или заморожен (`invalid_api_key`, `key_frozen_spike`).
'403':
description: 'Ключ с ограничениями (`key_restricted`): лимит, адреса, только чтение или выключенные «Деньги кабинета»; OAuth-токен — тоже. Ещё причины: management-ключ (`inference_key_required`), запрос не с адреса, к которому привязан ключ (`key_ip_not_allowed`), или заблокированный аккаунт (`account_blocked`).'
/v1/integrations/bitrix24/connectors/{id}:
delete:
operationId: deleteBitrix24Connector
tags:
- Integrations
summary: Удалить коннектор Битрикс24
description: Удаляет коннектор и отзывает выпущенный им ключ. Движок в портале уберите сами (`ai.engine.unregister`), иначе CoPilot продолжит слать запросы на несуществующий адрес.
security:
- bearerAuth: []
parameters:
- schema:
type: string
format: uuid
description: ID коннектора из ответа создания или списка.
required: true
name: id
in: path
responses:
'200':
description: Коннектор удалён.
content:
application/json:
schema:
$ref: '#/components/schemas/Bitrix24ConnectorDeleted'
'401':
description: Ключ не передан, невалиден, отозван или заморожен (`invalid_api_key`, `key_frozen_spike`).
'403':
description: 'Ключ с ограничениями (`key_restricted`): лимит, адреса, только чтение или выключенные «Деньги кабинета»; OAuth-токен — тоже. Ещё причины: management-ключ (`inference_key_required`), запрос не с адреса, к которому привязан ключ (`key_ip_not_allowed`), или заблокированный аккаунт (`account_blocked`).'
'404':
description: Коннектора нет, он чужой или уже удалён (`not_found`).
components:
schemas:
Bitrix24ConnectorDeleted:
type: object
properties:
deleted:
type: boolean
enum:
- true
required:
- deleted
Bitrix24ConnectorList:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Bitrix24Connector'
required:
- data
Bitrix24ConnectorCreated:
type: object
properties:
id:
type: string
format: uuid
completions_url:
type: string
format: uri
description: Адрес для `completions_url` при регистрации движка в Битрикс24 (`ai.engine.register`). Содержит секрет и показывается один раз.
model:
type: string
key_prefix:
type: string
description: Маскированный префикс выпущенного ключа.
example: sk-gw-a1b2...c3d4
required:
- id
- completions_url
- model
- key_prefix
Bitrix24Connector:
type: object
properties:
id:
type: string
format: uuid
name:
type: string
model:
type: string
key_prefix:
type: string
example: sk-gw-a1b2...c3d4
created_at:
type: string
format: date-time
last_used_at:
type: string
nullable: true
format: date-time
required:
- id
- name
- model
- key_prefix
- created_at
- last_used_at
Bitrix24ConnectorCreateRequest:
type: object
properties:
name:
type: string
minLength: 1
maxLength: 60
description: 'Имя подключения: видно в кабинете и в имени выпущенного ключа «Битрикс24 · <имя>».'
example: Отдел продаж
model:
type: string
minLength: 1
maxLength: 200
description: Полный ID модели каталога. Битрикс24 модель не передаёт, она закрепляется за коннектором.
example: anthropic/claude-sonnet-5
limit_kopecks:
type: integer
minimum: 100
maximum: 10000000
description: Дневной лимит расхода выпущенного ключа, копейки.
example: 50000
required:
- name
- model
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: sk-gw-...
description: API-ключ в формате `sk-gw-` + 32 hex. Создаётся в дашборде на /keys. Обычный ключ даёт все права, ключ только для чтения не может тратить баланс.
oauth2:
type: oauth2
description: 'OAuth-токен приложения с ограниченными правами. Регистрация клиента — `POST /oauth/clients` (RFC 7591), PKCE S256 обязателен. Метаданные: `/.well-known/oauth-authorization-server`, `/.well-known/oauth-protected-resource`.'
flows:
authorizationCode:
authorizationUrl: https://api.hubris.pw/oauth/authorize
tokenUrl: https://api.hubris.pw/oauth/token
refreshUrl: https://api.hubris.pw/oauth/token
scopes:
chat:write: 'Запросы к моделям от имени пользователя (списывают баланс): чат, Responses, Messages, эмбеддинги, реранкеры, модели решений, изображения, распознавание и озвучка речи, расшифровка видео; коннекторы Битрикс24.'
models:read: Видеть цепочки резервных моделей пользователя в `GET /v1/models`.
balance:read: Видеть остаток баланса пользователя.
videos:write: Создавать видео от имени пользователя (`POST /v1/videos`, резервирует и списывает баланс).
videos:read: Узнавать статус и скачивать видео пользователя (`GET /v1/videos/{id}`, `GET /v1/videos/{id}/content`).
offline_access: Выдать refresh-токен, чтобы подключение жило 90 дней без повторного входа.