系统 API 用于管理 MixRoute 账号中的资源，包括 API Key、智能路由 Key 和钱包操作。它与模型推理 API 相互独立。
系统访问令牌拥有账号级管理权限。请勿将其放入浏览器代码、移动应用、日志或源代码仓库。
获取系统访问令牌
在 MixRoute 控制台打开 账号设置 → API 访问，生成并复制系统访问令牌，然后将其保存到密钥管理系统。
GET /api/user/token 会生成新的系统访问令牌。这是轮换操作，不是查询操作，并会使旧令牌失效。日常自动化中不要调用该接口。
认证请求头
每个受保护的系统 API 请求都必须携带以下两个请求头：
发送 JSON 请求体时，还需要：
用户 ID 必须属于该系统访问令牌。认证失败并不总是使用同一个 HTTP 状态码：缺少凭证或用户 ID 不匹配时可能返回 HTTP 401，而无效的系统访问令牌目前会返回 HTTP 200 和 success: false。客户端必须同时检查 HTTP 状态码和响应结构。
可使用以下只读请求验证认证配置：
响应结构
多数系统 API 使用统一响应结构：
部分参数校验和认证错误会返回 HTTP 200 和 success: false，因此客户端需要同时检查 HTTP 状态码与 success 字段。
额度单位
账号余额和 API Key 额度使用内部额度单位存储，并不直接等于美元。请从公开状态接口读取当前换算系数：
换算公式如下：
quota_per_unit 是部署配置，可能发生变化。客户端应动态读取，不要写死当前数值。
账号余额与 Key 额度
- 账号余额来自
GET /api/user/self 的 quota 字段，是账号可用的钱包余额。
- Key 额度由
remain_quota 表示，是单个 API Key 的消费上限。
- 给 Key 设置额度不会从钱包中转移或冻结资金。
unlimited_quota: true 只表示没有 Key 级额度上限，请求仍会消耗账号余额。
读取并换算当前账号余额：
可用分组
创建 Key 前，应读取当前账号可选择的分组：
不要假设其他账号的分组也对当前账号开放。本教程中的通用示例使用 default 分组。
安全检查清单
- 系统访问令牌只能保存在服务端。
- 自动化任务应使用独立账号或独立凭证。
- 不要记录显示完整 Key 接口的响应。
- 尽量为每个 API Key 设置明确名称、过期时间、额度和 IP 限制。
- 轮换时先创建替代 Key，迁移流量后再停用并删除旧 Key。
