跳转到内容

管理 API 索引

管理 API 供控制台与运维调用,需 Sa-Token 登录态Authorization: Bearer <sa-token>)。调用方模型调用 API(/v1/*/anthropic/v1/*)使用 调用方 API Key,与管理 API 认证体系不同。

写操作冲突(如复制时名称重复)返回 409 CONFLICT,资源不存在返回 404 NOT_FOUND,统一 ApiResponse 格式。

端点说明
POST /api/v1/auth/login登录(返回会话 token)
POST /api/v1/auth/logout登出
GET /api/v1/auth/me当前用户信息
PATCH /api/v1/auth/me/password修改当前用户密码
GET /api/v1/me/api-keys查询我的 API Key
端点说明
/api/v1/users用户 CRUD、PATCH /{id}/state 启停、PUT /{id}/roles 角色、POST /{id}/reset-password 重置密码、GET /users/{userId}/api-keys 用户的 Key
/api/v1/user-api-keys调用方 API Key CRUD(GET /{id}/detail 详情),创建时绑定用户与应用
端点说明
/api/v1/applications应用 CRUD、渠道授权(含 priority)
/api/v1/channels渠道 CRUD(列表支持 providerId / billingMode / sortBy / sortOrder)、POST /{id}/copy 复制、状态切换、端点管理、健康检查、应急熔断
/api/v1/channels/{channelId}/credentials渠道凭证(上游 API Key)管理
/api/v1/channels/{channelId}/models渠道模型映射(含上游模型名更新、状态管理)
/api/v1/provision渠道配置供给(按套餐 / 供应商 / 模型批量开通)
/api/v1/providersProvider CRUD、连通性测试
/api/v1/protocols已注册协议元数据
端点说明
/api/v1/models模型管理 CRUD、POST /{id}/copy 复制、POST /{id}/unlock 解锁、PATCH /{id}/state 状态(区别于调用端点 /v1/models
/api/v1/plan-catalogs套餐目录与定价查询
/api/v1/catalog/sync模型目录同步(POST 手动触发、GET /status 状态)
端点说明
/api/v1/token-limitsToken 限额管理(含 PATCH /{id}/reset-usage 重置用量)
/api/v1/stats用量统计(概览、/trend?days= 按天趋势、/model-usage?limit= 模型用量 TopN)
/api/v1/resilience/events容灾事件查询(转移事件流、/exhausted 候选耗尽告警)
端点说明
/api/v1/audit-logs管理端操作审计日志(分页查询、DELETE 按时间清理)
/api/v1/settings系统设置键值(GET 全部、PUT /{key} 更新)
端点说明
POST /api/v1/experience/chatPlayground 流式体验(SSE,指定渠道直连调试)
GET /api/v1/experience/providers/{providerId}/models体验端点的供应商模型列表

各管理 API 的字段与操作详见对应功能文档: