API 密钥与鉴权

算汇使用 Bearer Token 鉴权。每个请求都要在 Authorization 请求头中携带 API 密钥。

Authorization: Bearer sk-您的密钥

创建密钥#

在控制台 · API 密钥选择「新建密钥」。可以按用途拆分密钥，例如生产环境、测试环境和不同应用各用一把，便于单独停用和核对费用。

创建时可设置：

• 有效期：到期后自动失效；
• 消费上限：限制该密钥最多可以消费的额度；
• 模型范围：需要收窄访问范围时，仅允许指定模型。

安全保存#

推荐通过环境变量保存：

export SUANHUI_API_KEY="sk-您的密钥"

• 不要提交到 Git；
• 不要写入 URL 查询参数；
• 不要在日志中输出完整密钥；
• 怀疑泄漏时立即停用并新建密钥，而不是继续观察。

鉴权失败#

收到 401 时，依次检查：

1. 请求头是否为 Authorization: Bearer <密钥>；
2. 密钥是否完整，前后没有多余空格或引号；
3. 密钥是否已停用或过期；
4. 调用的域名与路径是否正确。

密钥达到消费上限通常返回 403，账户余额不足则返回 402。更多情况见错误处理。