Teapot Router / 使用文档
创建与管理 API Key
为应用创建独立的 Key，理解有效期、余额和额度。
打开工作台创建一把 Key
- 登录工作台，进入「API 令牌」，点击「创建 API Key」。
- 填写容易识别的名称，例如应用名或环境名。默认有效期为「永久有效」，可改成 7、30 或 90 天。
- 默认选择「使用账户余额」；如需单独控制这把 Key 的累计使用量，选择「设置 Key 独立额度」并填写金额。点击创建。
独立额度只是这把 Key 的使用上限，实际费用仍从账户余额扣除。它不等于额外充值。
显示、使用与撤销
- 在 Key 列表点击「显示」，复制真实 Key。请只粘贴到可信客户端；不要发到聊天、截图或公开仓库。
- 为不同应用或环境分别建 Key，便于从「用量记录」识别调用。
- 不再使用或怀疑泄露时，在列表点击「撤销」。撤销后使用该 Key 的客户端需要换新 Key。
创建成功不代表能调用模型。还需要账户余额、可用上游渠道，以及与 Key 权限匹配的模型。
核对额度与排查失败
- 创建后回到 Key 列表，核对名称、状态、到期时间以及独立额度是否符合预期。把 Key 放进客户端后，用一条短请求验证。
- 请求报 401 时，检查是否复制了完整 Key、是否已撤销或过期，再检查客户端使用的接口地址。
- 请求提示额度不足时，分别检查账户余额和这把 Key 的剩余额度；提示模型不可用时，核对客户端填写的模型 ID，并让管理员检查渠道。
切换密码不会自动轮换 API Key。若怀疑 Key 泄露，先撤销旧 Key，再创建并更新客户端配置。