LLM 컨트롤플레인 API

LLM 프로바이더, 워크스페이스별 바인딩, AI 쿼터, 사용량을 관리하는 관리 API입니다.

LLM 프로바이더

prefix: /api/v1/admin/llm-providers — LLM 프로바이더(OpenAI/Anthropic/local 등) 등록·관리. admin 전용.

Method	Path	설명
GET	/api/v1/admin/llm-providers	프로바이더 목록
POST	/api/v1/admin/llm-providers	프로바이더 등록
GET	/api/v1/admin/llm-providers/{provider_id}	프로바이더 상세
PATCH	/api/v1/admin/llm-providers/{provider_id}	프로바이더 수정
DELETE	/api/v1/admin/llm-providers/{provider_id}	프로바이더 삭제
POST	/api/v1/admin/llm-providers/{provider_id}/test	연결/자격 테스트

LLM 바인딩

prefix: /api/v1/admin/llm-bindings — 워크스페이스↔프로바이더 매핑. admin 전용. 해석된 바인딩 조회는 별도 public 엔드포인트.

Method	Path	설명
GET	/api/v1/admin/llm-bindings	바인딩 목록
POST	/api/v1/admin/llm-bindings	바인딩 생성 (201)
GET	/api/v1/admin/llm-bindings/{binding_id}	바인딩 상세
PATCH	/api/v1/admin/llm-bindings/{binding_id}	바인딩 수정
DELETE	/api/v1/admin/llm-bindings/{binding_id}	바인딩 삭제 (204)
GET	/api/v1/llm-bindings/effective	현재 컨텍스트에 적용되는 프로바이더(해석 결과) — 별도 mount

LLM 쿼터

prefix: /api/v1/admin/llm-quotas — 워크스페이스별 AI 사용 쿼터. 상태 조회는 워크스페이스 스코프.

Method	Path	설명
GET	/api/v1/admin/llm-quotas	쿼터 목록
PUT	/api/v1/admin/llm-quotas/{workspace_id}	워크스페이스 쿼터 upsert
DELETE	/api/v1/admin/llm-quotas/{workspace_id}	쿼터 삭제 (204)
GET	/api/v1/workspaces/{slug}/ai-quota-status	워크스페이스 AI 쿼터 사용 현황

LLM 사용량

prefix: /api/v1/llm-usage — 토큰/비용 사용량 조회.

Method	Path	설명
GET	/api/v1/llm-usage/summary	사용량 요약
GET	/api/v1/llm-usage/log	사용 로그

인증

JWT Bearer 필요. providers/bindings/quotas 의 변경은 admin 전용, 쿼터 초과 시 /ai/ask 등은 429(Retry-After) 를 반환합니다.