Эндпоинты API

Каждая операция, которую предоставляет API, сгенерирована из того же документа OpenAPI, который поддерживает интерактивную справку. Базовый URL — https://api.apihubs.ru, и каждый вызов аутентифицируется с помощью токена API — см. Аутентификация.

Агент

Метод	Путь	Назначение
`GET`	`/api/v1/agent/artifacts`	—
`GET`	`/api/v1/agent/artifacts/{id}/content`	—
`DELETE`	`/api/v1/agent/attachments/{id}`	—
`GET`	`/api/v1/agent/attachments/{id}`	—
`POST`	`/api/v1/agent/attachments/{id}/complete`	—
`GET`	`/api/v1/agent/attachments/{id}/content`	—
`GET`	`/api/v1/agent/conversations`	—
`POST`	`/api/v1/agent/conversations`	—
`GET`	`/api/v1/agent/conversations/{id}`	—
`PATCH`	`/api/v1/agent/conversations/{id}`	—
`DELETE`	`/api/v1/agent/conversations/{id}`	—
`POST`	`/api/v1/agent/conversations/{id}/attachments`	—
`GET`	`/api/v1/agent/conversations/{id}/context-references`	—
`PUT`	`/api/v1/agent/conversations/{id}/context-references`	—
`GET`	`/api/v1/agent/conversations/{id}/event-history`	—
`GET`	`/api/v1/agent/conversations/{id}/events`	—
`GET`	`/api/v1/agent/conversations/{id}/messages`	—
`POST`	`/api/v1/agent/conversations/{id}/messages`	Запуск с явным лимитом расходов в микро-USD
`GET`	`/api/v1/agent/models`	—
`GET`	`/api/v1/agent/profiles`	—
`GET`	`/api/v1/agent/projects`	—
`POST`	`/api/v1/agent/projects`	—
`GET`	`/api/v1/agent/projects/{id}`	—
`PATCH`	`/api/v1/agent/projects/{id}`	—
`DELETE`	`/api/v1/agent/projects/{id}`	—
`POST`	`/api/v1/agent/projects/{id}/assets`	—
`POST`	`/api/v1/agent/projects/{id}/assets/import`	—
`GET`	`/api/v1/agent/runs/{id}`	—
`PATCH`	`/api/v1/agent/runs/{id}/budget`	—
`GET`	`/api/v1/agent/runs/{id}/context/{referenceId}`	—
`GET`	`/api/v1/agent/runs/{id}/costs`	—
`POST`	`/api/v1/agent/runs/{id}/decisions`	—
`GET`	`/api/v1/agent/runs/{id}/result`	—
`POST`	`/api/v1/agent/runs/{id}/resume`	—
`POST`	`/api/v1/agent/runs/{id}/stop`	—
`GET`	`/api/v1/agent/settings`	—
`PUT`	`/api/v1/agent/settings`	—
`GET`	`/api/v1/agent/storage`	—
`POST`	`/api/v1/agent/storage/cancel-renewal`	—
`POST`	`/api/v1/agent/storage/enable-renewal`	—
`GET`	`/api/v1/agent/storage/files`	—
`DELETE`	`/api/v1/agent/storage/files/{id}`	—
`GET`	`/api/v1/agent/storage/operations/{id}`	—
`GET`	`/api/v1/agent/storage/plans`	—
`POST`	`/api/v1/agent/storage/quote`	—
`POST`	`/api/v1/agent/storage/retain`	—
`POST`	`/api/v1/agent/storage/subscribe`	—
`GET`	`/api/v1/agent/webhooks`	—
`POST`	`/api/v1/agent/webhooks`	—
`DELETE`	`/api/v1/agent/webhooks/{id}`	—
`GET`	`/api/v1/agent/webhooks/{id}/deliveries`	—
`GET`	`/api/v1/agent/workflows`	—
`GET`	`/api/v1/agent/workflows/{id}`	—

Управление аккаунтом

Метод	Путь	Что выполняет
`GET`	`/api/v1/stats`	Статистика использования и расходов для текущего пользователя
`GET`	`/api/v1/user/me`	Запрос на получение текущего пользователя

Каталог

Метод	Путь	Что делает
`GET`	`/api/v1/catalog`	Получить общий каталог моделей
`GET`	`/api/v1/catalog/{id}`	Получить одну запись каталога по идентификатору модели

Затраты

Метод	Путь	Что он делает
`GET`	`/api/v1/cost`	Получить все цены по модели
`GET`	`/api/v1/cost/{model}`	Получить цены для конкретной модели

Генерации

Метод	Путь	Что делает
`POST`	`/api/v1/generation/create`	Создает запрос на генерацию на основе модели. Возвращает сразу с taskId
`POST`	`/api/v1/generation/estimate`	Оценивает точную стоимость баланса для запроса на генерацию
`GET`	`/api/v1/generation/{id}`	Возвращает свою генерацию и её текущий статус

LLM

Метод	Путь	Что делает
`POST`	`/api/v1/chat/completions`	Совместимое с OpenAI завершение чата. Установите `stream: true` для событий, отправляемых сервером.
`POST`	`/api/v1/messages`	Эндпоинт, совместимый с Anthropic Messages API (модели Claude). Установите `stream: true` для событий, отправляемых сервером.
`GET`	`/api/v1/models`	Список доступных моделей чата с ценой за токен (USD за 1 млн токенов)

Управление задачами

Метод	Путь	Что делает
`GET`	`/api/v1/task/status/{taskId}`	Получить статус задачи

Полный документ доступен по ссылке /openapi.json, если вы предпочитаете с его помощью создать клиент.