查询凭证和完整 API Key:为什么它们不该是同一个东西
把完整 API Key 直接交给前端去查用量,是一个非常常见、也非常容易出事的设计。查询凭证和完整 Key 的价值完全不对等,凭据就该分层。
两把凭据,两种权限
完整 API Key 能调用模型(花钱),查询凭证只能查看用量(不花钱)。把后者泄漏出去,最坏结果是信息泄露,而不是账单失控。
两者的价值不对等,凭据就该按这个分层来设计。
真实 token、密码、私钥、支付凭据、完整请求正文,都不应该出现在日志、测试、文档或截图里。
前端只该拿低敏感度的凭据
查询凭证可以缓存在浏览器 Cookie 里(甚至可以设个 180 天的过期),完整 Key 则应该一次性展示、用完即弃。
所以完整 Key 应该尽量一次性展示、用完即弃,最多缓存极短时间。
查询凭证倒是可以缓存——它本来就是低敏感度的设计。
查询凭证的权限边界要清晰
它只能查看用量,不能调用模型、不能修改配置、不能查看其他 Key。接口层面就要卡死,不能只靠前端不调用。
如果没有 Key 级限流,一个写错循环的脚本就能把共享池子的额度全部吃掉,其他用户跟着受影响。
网关的用量查询页应该一次性回答这三个问题,而不是让用户提工单。
缓存最近的若干张卡是有用的
本地保存最近使用的 10 张卡密方便下次直接查看,但保存时要明确告诉用户「清 Cookie 或换浏览器后需要重新添加」。
模型 ID 不要从文档里抄,要用你的 Key 实际查一次 /v1/models 拿到真实可用的那个。
实操:按 Key 分组隔离资源的思路在配置侧是什么样。
查询凭证的形态:一个 10 位、区分大小写的字符串。
# 分组决定了一个 Key 能看到哪些渠道。
# 三种状态的语义完全不同:
# 未绑定分组 → 所有「启用 + 公开」分组里的渠道
# 绑定公开分组 → 仅该组渠道
# 绑定专属分组 → 仅该组渠道(组停用/为空 → 直接拒绝,不回退)
# 配置专属渠道的顺序有讲究:
# 1. 新建分组,类型设为「专属分组」,加入目标渠道
# 2. 把这些渠道从所有公开分组里移除
# (只要还挂在任何公开分组,未绑定的 Key 就仍能用它)
# 3. 创建 Key 时选择该分组并保存
# 4. 之后要恢复,解除 Key 绑定即可回到公开池
几个容易踩的坑
- 把完整 Key 长期存进 localStorage,页面里任何脚本都能读到。
- 用浏览器返回地址或前端轮询来确认支付成功。
- 游客订单的恢复凭证放在 URL 查询参数里,被写进访问日志和 Referer。
- 权限只在前端菜单里做了隐藏,后端接口没做作用域检查。
小结
先跑通最小请求,再逐项加功能——这是接入任何网关都适用的节奏。
上面提到的能力基本都来自 https://aiminis.info/ 这个自建的 API 网关,支持 OpenAI 与 Anthropic 双协议接入,还有公开的模型健康看板 https://aiminis.info/model-health 可以先看看状态。
- 点赞
- 收藏
- 关注作者
评论(0)