Справочник API
Справочник API
REST API центра управления LLM Mart. Используется личным кабинетом и вашими автоматизациями.
Base URL
https://llmmart.ru
Проверка доступности:
GET /healthzcurl https://llmmart.ru/healthzФормат запросов
- Тело — JSON (
Content-Type: application/json), если не указано иное. - Ответ — JSON (кроме CSV export usage).
- Кодировка — UTF-8.
Авторизация
Большинство запросов требуют сессию:
Authorization: Bearer <token>Токен выдаётся при:
POST /api/auth/registerPOST /api/auth/loginPOST /api/invitations/acceptGET /api/auth/oidc/callback(после SSO)
Проверка текущей сессии: GET /api/auth/session.
Запросы на изменение (организация, ключи, модели, usage, политики, аудит) — роли owner или admin.
Ошибки
При ошибке тело обычно содержит поле error с текстом на русском:
{"error": "Требуется авторизация"}| Код | Значение |
|---|---|
| 400 | Некорректные данные |
| 401 | Не авторизован |
| 403 | Нет прав |
| 404 | Ресурс не найден |
| 500 | Внутренняя ошибка |
Документация по разделам
| Раздел | Файл | Методы API |
|---|---|---|
| Аутентификация | Аутентификация | register, login, session, accept invitation, OIDC |
| Организации | Организации | GET /api/overview, PATCH /api/organization |
| Приглашения | Приглашения | POST .../invitations, GET /api/invitations/preview, POST /api/invitations/accept |
| API-ключи | API-ключи | POST .../api-keys, POST .../api-keys/{keyId}/revoke |
| Способы входа | Способы входа | POST .../auth-providers, OIDC discover |
| Модели | Модели | статус API моделей, GET/PATCH .../models |
| Расходы | Расходы | sync, snapshots, export |
| Коммерческий биллинг | Коммерческий биллинг | invoices, top-ups, mark-paid |
| Политики | Policy Rules | rules, evaluate, preview, virtual-groups, systems |
| Аудит | Журнал аудита | GET .../audit-events |
Сводная таблица методов API
Аутентификация
| Метод | Путь | Auth | Описание |
|---|---|---|---|
| POST | /api/auth/register | — | Регистрация организации |
| POST | /api/auth/login | — | Вход |
| GET | /api/auth/session | Bearer | Текущая сессия |
| GET | /api/invitations/preview | — | Предпросмотр ссылки-приглашения |
| POST | /api/invitations/accept | — | Принять приглашение |
| GET | /api/auth/oidc/{providerId}/login | — | Начало OIDC |
| GET | /api/auth/oidc/callback | — | Callback OIDC |
| POST | /api/auth/oidc/providers/{id}/discover | Bearer | Discovery OIDC |
Организация
| Метод | Путь | Auth | Описание |
|---|---|---|---|
| GET | /api/overview | Bearer | Сводка кабинета |
| PATCH | /api/organization | сессия (owner/admin) | Обновить организацию |
| POST | /api/organization/invitations | сессия (owner/admin) | Создать ссылку-приглашение |
| POST | /api/organization/api-keys | сессия (owner/admin) | Создать ключ |
| POST | /api/organization/auth-providers | сессия (owner/admin) | Способ входа |
Модели
| Метод | Путь | Auth | Описание |
|---|---|---|---|
| GET | /api/organization/gateway/status | сессия (owner/admin) | Статус API моделей |
| GET | /api/organization/models | сессия (owner/admin) | Каталог моделей |
| PATCH | /api/organization/models | сессия (owner/admin) | Включить модели |
Расходы
| Метод | Путь | Auth | Описание |
|---|---|---|---|
| GET | /api/organization/usage | сессия (owner/admin) | Сводка расходов за период |
| POST | /api/organization/usage/snapshots | сессия (owner/admin) | Снимок |
| GET | /api/organization/usage/snapshots | сессия (owner/admin) | Список снимков |
| GET | /api/organization/usage/export | сессия (owner/admin) | JSON/CSV |
Коммерческий биллинг
| Метод | Путь | Auth | Описание |
|---|---|---|---|
| GET | /api/organization/billing/invoices | сессия (owner/admin) | Список счетов |
| POST | /api/organization/billing/top-ups | сессия (owner/admin) | Счет на пополнение |
| POST | /api/organization/billing/invoices/{invoiceId}/mark-paid | сессия (owner/admin) | Отметить счет оплаченным |
Политики и аудит
| Метод | Путь | Auth | Описание |
|---|---|---|---|
| GET | /api/organization/policy/rules | сессия (owner/admin) | Список policy rules |
| POST | /api/organization/policy/rules | сессия (owner/admin) | Создать policy rule |
| PATCH | /api/organization/policy/rules/{id} | сессия (owner/admin) | Обновить policy rule |
| DELETE | /api/organization/policy/rules/{id} | сессия (owner/admin) | Удалить policy rule |
| GET | /api/organization/policy/form-options | сессия (owner/admin) | Справочник для форм |
| POST | /api/organization/policy/evaluate | сессия (owner/admin) | Проверить контент по policy |
| POST | /api/organization/policy/preview | сессия (owner/admin) | Предпросмотр access для ключа/системы |
| GET | /api/organization/virtual-groups | Bearer | Список виртуальных групп |
| POST | /api/organization/virtual-groups | сессия (owner/admin) | Создать виртуальную группу |
| PATCH | /api/organization/virtual-groups/{id} | сессия (owner/admin) | Обновить группу |
| DELETE | /api/organization/virtual-groups/{id} | сессия (owner/admin) | Архивировать группу |
| GET | /api/organization/systems | сессия (owner/admin) | Список систем/агентов |
| POST | /api/organization/systems | сессия (owner/admin) | Создать систему/агента |
| GET | /api/organization/audit-events | сессия (owner/admin) | Журнал |
API моделей (запросы к моделям)
Запросы приложений к моделям идут не через API платформы, а через API моделей:
| Формат | OpenAI-compatible API (снимок 2026-07-09) |
| Base URL | https://llmmart.ru/api/v1 |
| Auth | Authorization: Bearer <api-key> (sk-…) |
| Документация | Обзор API моделей |
Основные маршруты: POST /chat/completions, POST /responses, POST /embeddings, POST /images/*, POST /audio/*, POST /videos, Realtime WebSocket.
См. Первый запрос к модели и Примеры SDK.