基础排错 · 第 11 天

API 401 是什么意思？

401 的核心是鉴权失败。不要先怀疑模型能力，先查 Key、BASE_URL、模型权限和复制粘贴错误。

今天完成什么

能区分 Key 问题和工具配置问题。

用最小 curl 请求验证 Key 和 BASE_URL 是否能取到模型列表。

操作步骤

  1. 先从 Help 按工具和协议复制对应的最小测试；只有 OpenAI 兼容入口才使用 /v1/models。
  2. 检查 BASE_URL 是否与当前工具的协议匹配，并排除多余路径、斜杠或空格。
  3. 重新生成一个测试 Key，排除旧 Key 被禁或复制错误。

教学样例

虚构现象：工具返回 HTTP 401。只有错误码，没有凭据内容或原始请求日志。

参考结果

  • 先归入鉴权方向，不直接断言余额不足。
  • 核对当前接入方式、Key 是否启用及 Authorization 字段格式，不展示其值。
  • 核对 Key 与接口所属平台是否一致。
  • 需要帮助时仅提供工具版本、接口路径和脱敏错误摘要。

任务模板

请帮我排查 API 401。工具={工具名}，BASE_URL={脱敏地址}，模型名={模型名}，报错={必要且已脱敏的错误上下文}。请按 Key、地址、权限、模型名顺序排查。

检查结果

  • 能用最小请求验证 Key。
  • BASE_URL 和模型名来自同一个平台。
  • 没有把 OpenAI 官方 Key 填到中转地址，或反过来。

今天留下的是 401 排查四步表。

卡住时先看

不知道该查 Key、接口、权限还是余额。