Справочник API
Модели
Статус API моделей и управление каталогом организации.
Кому подходит
- Администраторам — какие модели доступны компании.
Требуется токен администратора (роли owner или admin).
GET /api/organizations/{orgId}/gateway/status
Статус доступности API моделей (без полного списка с флагами).
curl -s https://api.example.com/api/organizations/org_abc/gateway/status \
-H "Authorization: Bearer <token>"Ответ 200:
{
"healthy": true,
"message": "API моделей доступен",
"modelCount": 3,
"providers": [
{
"name": "openai",
"label": "OpenAI",
"status": "online",
"models": ["gpt-4o-mini"]
}
]
}GET /api/organizations/{orgId}/models
Полный каталог: статус + модели с флагом enabled.
curl -s https://api.example.com/api/organizations/org_abc/models \
-H "Authorization: Bearer <token>"Ответ 200:
{
"organizationId": "org_abc",
"gateway": { "healthy": true, "message": "…", "modelCount": 3, "providers": [] },
"models": [
{ "id": "gpt-4o-mini", "provider": "openai", "enabled": true }
]
}Если enabledModels организации пуст, все модели каталога помечаются enabled: true.
PATCH /api/organizations/{orgId}/models
Включить модели для организации.
Тело:
| Поле | Тип | Описание |
|---|---|---|
enabledModels | string[] | ID моделей из каталога |
curl -s -X PATCH https://api.example.com/api/organizations/org_abc/models \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"enabledModels": ["gpt-4o-mini"]}'Ошибки 400: модель не найдена в каталоге.