#错误码参考

#错误结构

{
  "error": {
    "code": "model_not_found",
    "message": "Unknown or unavailable model alias.",
    "param": "model",
    "type": "invalid_request_error"
  }
}

#稳定错误码

#上游错误边界

TokenPostie 不会把上游原始错误 code、message、raw body、request ID 或网络异常 cause 直接返回给 API 用户或客户管理员。最终用户侧应使用 TokenPostie 的 error.code 做稳定处理。

流式响应已经开始后，最初的 HTTP 状态仍可能是 200。客户端还必须读取终止 SSE 事件：OpenAI-compatible 流使用 data: {"error": ...}，Responses 和 Anthropic 流使用 event: error。

#请求日志排障

请求失败时，先保留响应里的 request id 或客户控制台请求日志中的请求 ID，再按以下顺序排查：

1. 在客户控制台打开请求日志，确认模型、API Key、项目、HTTP 状态和 error.code。
2. 如果是 model_not_found 或 model_access_denied，重新调用 GET /v1/models，只使用返回的模型 id。
3. 如果是 rate_limit_exceeded，按当前 API Key 的 RPM、TPM、QPM 限额降速。
4. 如果是 insufficient_quota 或 credit_limit_exceeded，检查余额、授信和付款状态。
5. 联系 TokenPostie 运营时只提供请求 ID、错误码和时间，不提供完整 API Key。

相关排障步骤见 排障与安全。