30 天课程 · 第 11 天 · 基础排错

第 11 天｜API 401 是什么意思？

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

今天先解决这个卡点

今天先懂：401 多数是鉴权失败：Key 错、权限不够、接口地址不匹配。

常见卡点：不知道该查 Key、接口、权限还是余额。

留下结果：能区分 Key 问题和工具配置问题。

照着做

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

验收清单

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

可复制给 Agent 的任务

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

今天完成后，你应该得到

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

相关笔记

下一步