docs

排查模型 API 错误:401、403、404、429 与超时

HTTP 错误描述的是端点如何处理请求,单凭状态码无法判断宣称的模型是否真实。不同服务商和网关对状态码的使用可能不同,应结合响应内容和服务商 API 文档排查。

← 返回文档目录

401 通常与密钥缺失、无效、过期或权限范围不符有关。确认密钥属于当前服务商,发送格式符合接口要求,并且有权访问目标模型。不要把密钥贴进日志或公开求助内容。

403 常表示请求已被识别,但访问被拒绝。检查模型权限、账号或项目选择、IP 白名单、区域限制和可用额度。有些网关也会用 401 或 404 表示相同的限制。

404 常见原因是 Base URL 路径或接口路由不正确,或该端点不提供填写的模型 ID。请从服务商接入文档复制 API 基础地址和精确模型标识;保留文档要求的版本前缀,不要把 chat/completions 之类的请求路径拼进 Base URL。

429 可能来自 API 服务商、上游网关或 ModelVerify 自身的频率限制。先看页面提示和服务商文档,确认拒绝请求的是哪一方;核对额度、并发和 Retry-After 等待提示,按照要求降低请求频率并等待。不要立即反复提交;会话或网络限制未必能通过更换密钥或模型解除。429 不代表模型不匹配。

超时可能与网络、服务商负载、网关或服务的等待时间有关。先检查服务商状态、文档中的端点与模型可用性,并对照应用中已使用的配置;账号、地区和模型权限也可能影响访问。超时或模型不可用时身份仍无法确定,持续失败可向相关服务商提供发生时间、错误与请求 ID,但不要提供密钥。

如果仍然报错,请对照端点文档检查请求格式,并在自己的环境中尝试最小请求。ModelVerify 显示握手失败,表示检查未能继续,不代表模型是假冒的。各字段的填写方法见配置指南。

ModelVerify 会通过你的 API Key 发送验证请求,服务商可能因此收费。服务商支持时请使用受限密钥,并把结果理解为当前观测到的行为证据,而不是无条件保证。