升阶暂立之篇
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（求之过频）
顷刻之间致请求过多，触服务商限速之规。宜候一二刻而复试，或改投他 AI 之商。
服务端之误（5xx）
500Internal Server Error（服务器内生之误）
服务商内生变故。此非尔之过，服务商多半顷刻即修，姑待而复试可也。
502Bad Gateway（关卡之误）
关卡自上游之服务器得无效之应。多服务商临时之恙，稍候复试即愈。
503Service Unavailable（役不可用）
役暂过载或正修缮之中。姑复试一次。倘久而不愈，可改投他 AI 之商。
504Gateway Timeout（关卡逾时）
关卡候上游之应而逾时。或服务商负荷过重，宜候而复试。
排查之方
- 遇429之码，姑候一二刻而复试，或径改投他 AI 之商。
- 遇503之码，多但再试一次即复。
- 4xx 之误久现不绝者，宜先核 API Key 与 Base URL 之配置确否无误。
- 诸提供商皆不可用者，恐本地网络之恙，请查网络之联或代理之设。