API Key 与认证
所有请求都用一个 HTTP Header 鉴权,没有签名、没有时间戳、没有额外参数。
怎么带 Key
Authorization: Bearer sk-你的Key
Content-Type: application/jsonKey 缺失、格式不对、已被删除,都会返回 401。
Key 的生命周期
- 创建:控制台「API 密钥」→ 新建。名称自己取,用于区分用途(比如「线上」「测试」)。
- 可见性:完整 Key 只在创建时完整显示一次,之后列表里是打码的。丢了就重建,找不回来。
- 限额:单个 Key 可以设额度上限和过期时间。给客户端用的 Key 建议设上限,避免一把钥匙刷穿账户。
- 停用:在列表里切到「已禁用」,即时生效;删除则不可恢复。
安全建议
- 不要把 Key 写进前端代码或提交到 Git 仓库——它等同于你的账户余额。
- 服务端调用时从环境变量读,别硬编码。
- 一把 Key 只给一个用途,出问题时能单独停用,不影响其他业务。
- 怀疑泄露就立刻在控制台删除该 Key,重新生成一把。
返回 401 时怎么排查,见错误码页。