> ## Documentation Index
> Fetch the complete documentation index at: https://bianxieai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 错误处理

> HTTP 状态码、限流和重试建议

| 状态码       | 含义与处理                                                     |
| --------- | --------------------------------------------------------- |
| `400`     | 参数不正确。根据响应中的 `message` 修正请求。                              |
| `401`     | API Key 缺失、格式错误或已失效。                                      |
| `403`     | 余额不足或权限不足。请检查账户余额、Key 状态和模型访问权限。                          |
| `429`     | 上游、风控或异常重试触发限制。查看 `message` 判断 RPM、RPD、TPM、TPD、IPM 或 IPD。 |
| `500`     | 未知服务错误。记录请求时间与错误信息并联系支持。                                  |
| `503/504` | 服务负载较高或上游超时。稍后按指数退避重试；对话请求可尝试流式输出。                        |

平台默认不主动设置固定速率限制，但上游服务、异常重试或风控仍可能返回 `429`。只对临时错误重试，并设置最大次数与随机抖动。

仍无法解决时，请前往[联系我们](https://docs.bianxie.ai/zh/faq/contact)获取技术支持，并提供请求时间、接口、模型 ID、HTTP 状态码和完整 `message`。请勿发送完整 API Key。
