错误与状态码
根据 HTTP 状态、结构化错误代码和 x-request-id 处理失败，不在日志中记录凭据或提示词内容。
| 状态 | 含义 | 客户端操作 |
|---|---|---|
400 | 请求无效 | 修正内容，不要原样重试。 |
401 | 认证失败 | 更新或替换账户令牌。 |
403 | 功能或套餐拒绝 | 检查权益和请求模型。 |
404 | 路由或资源不存在 | 核对 /v1 路径和标识。 |
429 | 请求上限 | 按重置提示等待并降低并发。 |
5xx | 服务失败 | 仅对安全工作进行有界退避和随机抖动重试。 |
未知路由返回 NOT_FOUND，校验失败返回 VALIDATION_ERROR，意外失败返回 INTERNAL_ERROR。上游提示可能变化，不要用自然语言错误消息决定程序控制流程。
预期结果： 客户端修复永久错误，或在保留请求标识的前提下进行有限重试。