BroadRouter
开始使用

API 密钥(API key)

更新于

API 密钥是一串用于识别和授权 API 调用方的秘密字符串。大模型 API 通常要求把它放在 Authorization: Bearer 请求头里,任何持有该密钥的人都能发起请求,费用记在拥有该密钥的账户上。

又称: API key、API 令牌、秘钥、密钥、访问令牌、Bearer token、推理密钥、API token、secret key、bearer token、inference key

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 响应头的值。

常见问题

可以把大模型 API 密钥放进浏览器或手机 App 里吗?

不可以。凡是发到客户端的东西都能被提取出来。把密钥留在服务器上,让你的 App 调用你的服务器,再由服务器调用大模型 API。

密钥泄露了怎么办?

立即吊销,创建一个新密钥,并检查密钥暴露期间的用量。然后找出泄露途径,例如某次提交、某行日志或某张截图。

在 BroadNet Inference 上可以有多少个密钥?

每个账户最多十个有效的按量付费密钥。每个密钥自创建起有效一年。套餐密钥另行计算。

以 Markdown 格式阅读问 ChatGPT问 Claude问 Perplexity