Skip to main content
当你确认 API Key 已经填入代码,但请求仍然失败时,问题可能出在 Key 的格式、账户状态或权限上。本文提供一个系统的排查清单,帮助你逐一验证。

排查清单

1

检查 Key 是否复制正确

从控制台复制 API Key 时,容易多复制空格或换行符。建议粘贴后检查首尾是否有空白字符,或在代码中对 Key 执行 strip() 处理。
2

检查 Header 格式

确认请求头格式严格为:
常见错误包括:缺少 Bearer 前缀、使用 Api-Key 作为 Header 名、或 Bearer 与 Key 之间没有空格。
3

在控制台验证 Key 是否存在

登录 Sub2API 控制台,进入 API Key 管理页面,确认当前使用的 Key 仍在列表中且状态正常。如果 Key 已被删除,需要重新创建。
4

检查账户余额

Sub2API 采用 Token 计费模式(按量付费)。如果账户余额不足,即使 Key 格式正确,请求也可能被拒绝。请在控制台查看余额,如有需要请充值。具体操作请参考 余额充值
5

创建新的 API Key 并测试

如果以上步骤均确认无误但请求仍失败,尝试在控制台生成一个新的 API Key,替换后再次测试。新 Key 可以排除旧 Key 因未知原因被标记为无效的情况。

常见错误对照表

有效预防

  • 将 API Key 存储在环境变量中,避免硬编码
  • 复制 Key 后习惯性地执行 strip() 清理空白字符
  • 定期检查控制台中的 Key 列表和账户余额,避免因余额耗尽导致服务中断
如需创建新的 API Key,请参考 创建 API Key