错误处理
由于 Antix 处于您应用程序的关键路径上,因此了解其错误代码至关重要。
标准化的错误代码
Antix 拦截并标准化了跨多个提供商的错误:
400 Bad Request(错误请求) — 载荷格式错误或请求了上游不支持的模型。401 Unauthorized(未授权) — 缺少或格式错误的Authorization标头、未知的虚拟密钥、密钥已撤销或删除、JWT 已过期(超过 15 分钟的生存时间(TTL)),或者在阻止列表中找到了 JWTjti。402 Payment Required(需要付款) — 虚拟密钥已超出其max_budget(最大预算)。403 Forbidden(禁止访问) — 调用者的凭据无权访问所请求的端点或组织范围。404 Not Found(未找到) — 未知的端点 UUID,或者(在模型 API 上)模型 id 当前未被提供服务。413 Payload Too Large(载荷过大) — 请求主体超过了上游提供商的大小限制。410 Gone(已失效) — 请求针对了一个已被归档的端点。归档是永久性的;此 URL 将永远不会再次变为活动状态。429 Too Many Requests(请求过多) — 超出了网关的请求速率限制。这目前是一个全局的每个 IP 限制,而不是按虚拟密钥(Virtual-Key)分配的配额。502 Bad Gateway(错误的网关) — 针对该请求的所有上游提供商尝试均失败。503 Service Unavailable(服务不可用) — Antix 的故障关闭路径。当无法访问计费后端或所请求的模型没有定价行(model_not_priced)时触发。