docs

第三方模型 API 返回 401、403 或 404?

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

← 返回文档目录

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

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

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

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

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

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