值班交接：中转接口返回401，先核对钥匙和入口

收到401，先把它当成门禁提示

请求发出后，没有等到模型回答，只收到401。先别急着换模型或充值。这个状态码表示请求没有提供有效的身份凭据。可以把接口想成一道门，密钥就是钥匙；401提醒你先检查钥匙，而不是说明门后的模型坏了。([developer.mozilla.org](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/401?utm_source=openai))

接入中转后，排查时建议把路线分成两段：你的工具到中转服务，以及中转服务到上游。先记录实际请求地址、错误正文和发生时间，再判断该检查哪一段。不要仅凭一个401，就认定问题一定出在自己的密钥。

先确认拿的是这道门的钥匙

密钥错误、过期或被撤销，都是身份验证失败的常见原因。官方接口的错误文档也把这些情况列为检查重点，但不能据此断定每家中转服务都采用完全相同的错误规则。([developers.openai.com](https://developers.openai.com/api/docs/guides/error-codes))

• 请在中转控制台核对本次使用的密钥，不要把网站登录密码当作接口密钥，也不要默认上游平台的密钥可以直接用于中转。
• 请检查复制内容是否混入空格、换行或引号，并确认程序读到的不是示例占位文字。
• 请核对运行程序实际使用的配置，而不只是编辑器里刚保存的文件；必要时重新启动工具，再做一次测试。

使用兼容OpenAI的接口时，常见认证格式是请求头中的Authorization: Bearer 加密钥。若由客户端库负责添加请求头，就在密钥配置项中填写密钥本身，不要自行重复拼接认证前缀。([developers.openai.com](https://developers.openai.com/api/reference/overview))

让请求地址和密钥属于同一套配置

排查时，把接口地址和密钥放在一起核对。不要一边保留默认官方地址，一边只替换中转密钥；也不要只改入口，却留下旧环境的凭据。每轮只修改一个配置点，并记录修改前后的结果，方便确认哪一步真正有效。

按照Relay365的接入信息，使用OpenAI客户端时，需要在其接口基础地址后加上/v1。请同时核对客户端要求填写的是基础地址还是完整请求路径，避免重复添加路径。其他工具则应按对应接入说明设置，不要直接照搬全部配置。

用一次短请求缩小401的范围

建议暂时关闭批量任务，只保留一个已确认可用的模型和一句简短输入。测试期间不要同时切换模型、密钥和网络环境，否则即使恢复，也难以知道是哪项修改起作用。

• 如果最小请求成功，请逐项恢复原来的工具配置，每恢复一项就测试一次。
• 如果仍然返回401，请保存经过脱敏的错误正文，并核对其中是否明确提到无效密钥或身份验证失败。
• 如果错误指向上游认证，请把这条线索交给中转支持人员核查，不要立即反复更换自己的密钥。

不要把所有失败都归入401。以官方接口的规则为例，请求频率过高和额度不足可能返回429，需要与认证问题分开处理；中转服务的具体映射仍应以其说明和返回正文为准。([developers.openai.com](https://developers.openai.com/api/docs/guides/error-codes))

交接给支持人员时留下证据，不留下密钥

建议提交发生时间及所在时区、工具名称、请求路径、模型标识、状态码，以及脱敏后的错误正文。如果响应包含请求编号，也一起保留；官方接口文档同样建议记录请求编号，以便排查具体请求。([developers.openai.com](https://developers.openai.com/api/reference/overview))

不要发送完整密钥、带认证信息的截图或未经检查的日志。若怀疑密钥已经泄露，请先撤销，再更新相关运行环境。修复后只做一次小规模验证，确认成功后再恢复任务，避免用连续重试代替诊断。

选用中转后，把接入配置留作交接底稿

如果你需要按量使用多个模型家族，Relay365可以作为接入选项。你可以创建一个账户，先完成一次小规模验证，再决定是否接入日常工作流。选择中转并不会免除认证检查；保留一份不含密钥的配置清单，才方便下次接班时迅速定位问题。