API 密钥就像程序用的密码。它同时也是一种支出授权:谁拿到它,谁就能花你的余额。
工作原理
大模型 API 把密钥当作 Bearer 令牌。客户端在每个请求中发送它:
curl https://inference.broadnet.ai/v1/models \
-H "Authorization: Bearer $BROADNET_API_KEY"
RFC 6750 对 Bearer 令牌的定义是 “any party in possession of the token”(译文:任何持有该令牌的一方)都可以使用它,没有第二重验证。所以同一份 RFC 规定,客户端必须始终通过 TLS(https://)发送 Bearer 令牌。
服务商会查找密钥、找到对应账户、检查限制和策略,然后处理或拒绝请求。缺少密钥或密钥错误通常返回 401;被策略拒绝的密钥(例如 IP 白名单)通常返回 403。
为什么重要
密钥泄露是 API 账单失控最常见的原因之一,因为有机器人专门扫描公开代码中的密钥。如果密钥能访问返回账户信息的端点,还可能泄露数据。按照 OWASP 的密钥管理指南,良好的做法是:
- 从环境变量或密钥管理服务中加载密钥。绝不要提交到代码仓库,也不要打包进容器镜像。
- 给每个应用或智能体单独的密钥,这样吊销一个时不会影响全部。
- 定期轮换密钥,一旦怀疑泄露就立即轮换。
- 限制密钥的使用范围,例如设置服务器 IP 白名单。
在 BroadNet Inference 上
BroadNet 区分两种凭据。推理密钥用于在 /v1/* 上调用模型。门户凭据用于自动化管理账户:密钥、允许的 IP 和购买操作。请把后者视为拥有完整账户权限。
两者都只显示一次。BroadNet 只保存 SHA-256 哈希值,因此无法再次显示密钥。按量付费密钥有效期一年,一个账户最多可持有十个有效密钥。每个密钥可以有自己的 IP 白名单。吊销密钥或修改白名单后,新请求会在五秒内被停止。
固定价格套餐的套餐密钥是独立的,从不扣减你的余额。设置步骤见 API 密钥与 IP 白名单,状态码见错误与重试。
常见错误
- 记录完整的请求头。这会把密钥写进日志。
- 整个团队共用一个密钥。这样就无法单独吊销某个人的访问权限。
- 把密钥发给技术支持。应该发送
X-Request-ID响应头的值。