鉴权、余额与权限问题
逐步排查 401 鉴权失败与 403 无权限或额度不足:检查请求头和密钥状态、核对模型限制、分组、IP 白名单与账户余额。
401:鉴权失败
常见原因:API Key 错误、过期或已禁用。按顺序检查:
- 请求头格式:
Authorization: Bearer sk-...,Bearer后有一个空格;/v1/messages也可以用x-api-key,见鉴权方式。 - 密钥内容:使用控制台中的完整密钥,确认复制时没有带上空格、换行或引号。
- 环境变量:确认程序实际读到了密钥,例如先
echo检查变量是否为空(注意不要把输出贴到公开场合)。 - 密钥状态:在「API 密钥」页确认密钥存在、已启用、未过期。
- 仍然失败:删除旧密钥,重新创建后再试。
403:无权限或额度不足
常见原因:模型、分组或 IP 无权限,或额度不足。按顺序检查:
| 检查项 | 方法 |
|---|---|
| 账户余额 | 控制台「钱包」查看余额 |
| 密钥剩余配额 | 「API 密钥」页查看该密钥的剩余配额 |
| 模型限制 | 用该密钥调用 GET /v1/models,确认目标模型在返回结果中 |
| 分组 | 确认密钥所属分组启用了该模型,见模型查找与权限 |
| IP 白名单 | 如果启用了白名单,确认当前出口 IP 在列表中(服务器、代理和本地网络的出口 IP 往往不同) |
Anthropic 格式的鉴权
- 使用 Anthropic SDK 时,
api_key填 Fluxlane 的密钥,base_url填https://run.fluxlane.ai; - 直接请求时带
x-api-key和anthropic-version: 2023-06-01,或改用Authorization: Bearer。
密钥疑似泄露
立即在控制台删除该密钥并创建新密钥,然后在「使用日志」中检查异常调用,见轮换与泄露处理。