进阶临时
AI 错误码解析
当 Verity 调用 LLM 服务失败时，会返回对应的 HTTP 错误码。 本文列出常见的错误码及其含义，帮助你快速定位问题。
客户端错误（4xx）
400Bad Request（请求格式错误）
发送给 API 的请求参数不正确，例如 JSON 格式错误、缺少必填字段或参数值不合法。通常由客户端配置问题引起。
401Unauthorized（未授权）
API Key 无效、已过期或未提供。请检查你的 Key 是否正确，或在服务商控制台重新生成。
403Forbidden（禁止访问）
Key 有效但没有权限访问所请求的资源。可能是账户未完成实名认证，或所选模型未开通。
404Not Found（资源不存在）
请求的模型或接口地址不存在。请检查 Base URL 和 Model 名称是否正确。
408Request Timeout（请求超时）
服务器在规定时间内未收到完整请求。可能因网络不稳定导致，建议检查网络后重试。
422Unprocessable Entity（参数无法处理）
请求格式正确但内容不合法，例如消息内容过长、包含不支持的参数等。
429Too Many Requests（请求频率过高）
在短时间内发送了过多请求，触发了服务商的速率限制。建议等待 1–2 分钟后重试，或切换到其他 AI 提供商。
服务端错误（5xx）
500Internal Server Error（服务器内部错误）
服务商内部出现异常。这不是你的问题，通常服务商会在短时间内修复。请稍后重试。
502Bad Gateway（网关错误）
网关从上游服务器收到了无效响应。通常是服务商临时故障，稍等片刻重试即可。
503Service Unavailable（服务不可用）
服务暂时过载或正在维护中。请稍后重试一次。如果持续出现，可尝试切换到其他 AI 提供商。
504Gateway Timeout（网关超时）
网关等待上游服务器响应超时。可能是服务商负载较高，建议等待后重试。
排查建议
- 遇到 429 时， 等待一两分钟再重试，或直接切换到其他 AI 提供商。
- 遇到 503 时， 通常只需再试一次即可恢复。
- 持续出现 4xx 错误时，优先检查 API Key 和 Base URL 配置是否正确。
- 如果所有提供商都不可用，可能是本地网络问题， 请检查网络连接或代理设置。