跳到主要内容

鉴权、余额与权限问题

逐步排查 401 鉴权失败与 403 无权限或额度不足:检查请求头和密钥状态、核对模型限制、分组、IP 白名单与账户余额。

401:鉴权失败​

常见原因:API Key 错误、过期或已禁用。按顺序检查:

  1. 请求头格式:Authorization: Bearer sk-...,Bearer 后有一个空格;/v1/messages 也可以用 x-api-key,见鉴权方式。
  2. 密钥内容:使用控制台中的完整密钥,确认复制时没有带上空格、换行或引号。
  3. 环境变量:确认程序实际读到了密钥,例如先 echo 检查变量是否为空(注意不要把输出贴到公开场合)。
  4. 密钥状态:在「API 密钥」页确认密钥存在、已启用、未过期。
  5. 仍然失败:删除旧密钥,重新创建后再试。

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。

密钥疑似泄露​

立即在控制台删除该密钥并创建新密钥,然后在「使用日志」中检查异常调用,见轮换与泄露处理。