# 错误与状态码

根据 HTTP 状态、结构化错误代码和 `x-request-id` 处理失败，不在日志中记录凭据或提示词内容。

| 状态 | 含义 | 客户端操作 |
| --- | --- | --- |
| `400` | 请求无效 | 修正内容，不要原样重试。 |
| `401` | 认证失败 | 更新或替换账户令牌。 |
| `403` | 功能或套餐拒绝 | 检查权益和请求模型。 |
| `404` | 路由或资源不存在 | 核对 `/v1` 路径和标识。 |
| `429` | 请求上限 | 按重置提示等待并降低并发。 |
| `5xx` | 服务失败 | 仅对安全工作进行有界退避和随机抖动重试。 |

未知路由返回 `NOT_FOUND`，校验失败返回 `VALIDATION_ERROR`，意外失败返回 `INTERNAL_ERROR`。上游提示可能变化，不要用自然语言错误消息决定程序控制流程。

**预期结果：** 客户端修复永久错误，或在保留请求标识的前提下进行有限重试。