# 错误与限流 (/docs/developers/model/limits-and-errors)



<Callout>
  本页讲

  **怎么办**

  ：错误码、重试策略、具体限流数字。原理见

  [限流与错误](/docs/api/errors)

  ，账号额度见

  [配额与限流](/docs/developers/account/quotas)

  。
</Callout>

## 错误码速查 [#错误码速查]

| HTTP | 含义        | 你该做什么                        |
| ---- | --------- | ---------------------------- |
| 400  | 请求参数有误    | 检查请求体格式、字段名、模型 ID            |
| 401  | 认证失败      | 检查 API Key 是否完整、是否已过期        |
| 403  | 权限不足或余额耗尽 | 确认 Key 有效；检查账户余额             |
| 404  | 路径或模型不存在  | 检查 API 地址后缀；模型 ID 是否在目录中     |
| 429  | 速率限制      | 按 `X-RateLimit-Reset` 头等待后重试 |
| 500  | 服务端错误     | 稍后重试                         |

## 常见 400 错误 [#常见-400-错误]

**STREAMING\_UNPROVEN**：该模型路由暂未开放流式。去掉 `stream: true` 或换模型。

**模型不存在**：到[控制台 → 模型](https://console.deepraxis.ai/models)复制确切 ID。

**缺少 max\_tokens**（Anthropic 协议）：加 `"max_tokens": 256`。

## 重试策略 [#重试策略]

**可重试**：429（等重置）、500（指数退避 1s→2s→4s 最多 3 次）、网络瞬断（直接重试）。

**不可重试**：400（修正请求）、401（修复 Key）、404（修正地址或模型）。

## 速率限制 [#速率限制]

| 响应头                              | 含义       |
| -------------------------------- | -------- |
| `X-RateLimit-Limit-Requests`     | 每分钟最大请求数 |
| `X-RateLimit-Remaining-Requests` | 本窗口剩余次数  |
| `X-RateLimit-Reset-Requests`     | 距离重置秒数   |