# 错误、速率限制和重试

> LLM API 的所有错误：HTTP 状态码、代码和原因，哪些应重试，速率限制，以及遇到 402 余额不足时该怎么做。错误免费。

- URL: https://llmwithcrypto.com/zh/docs/errors/
- 最后更新: 2026-10-23
- 发布者: LLMwithCrypto (https://llmwithcrypto.com)

错误以 OpenAI 格式返回，因此 SDK 会像平常一样把它们作为异常抛出。本页列出每个状态码和代码，说明哪些值得重试，并给出一个遵守速率限制的重试循环。

**快速回答 — LLMwithCrypto API 会返回哪些错误，它们会收费吗？**

API 用 HTTP 状态码和 OpenAI 风格的 body 返回错误：`{"error": {"message", "type", "param", "code"}}`。**LLMwithCrypto** 用 400 表示请求有误，401 表示 key 错误，402 表示积分无法支付，404 表示未知模型，429 表示速率限制，500 或 503 表示我们这边的问题。以错误结束的调用不产生费用，依据的是 2026 年 10 月 23 日的文档。

## 有哪些错误？

任何错误都不会消耗积分。`code` 是在代码中测试的稳定值；`message` 是给人看的，可能会变化。

| HTTP | `code` | 原因 | 重试？ |
| --- | --- | --- | --- |
| 400 | `invalid_parameter` | 缺少必填字段，或值超出范围或类型错误 | 否：修正请求 |
| 400 | `context_length_exceeded` | messages 加上 `max_tokens` 无法容纳在模型的上下文窗口内 | 否：缩短输入或降低 `max_tokens` |
| 400 | `unsupported_parameter` | 此模型不支持的字段，例如在没有 JSON 模式的模型上使用 `response_format` | 否：移除它或更换模型 |
| 401 | `invalid_api_key` | key 缺失、拼写错误或被撤销 | 否：检查 API 密钥 |
| 402 | `insufficient_balance` | 剩余余额不足以支付此次调用 | 否：购买积分包 |
| 404 | `model_not_found` | `model` id 不在我们的列表中 | 否：请使用 `GET /api/v1/models` 中的 id |
| 429 | `rate_limit_exceeded` | 每分钟请求数或 token 数超出账户允许 | 是，暂停后再试 |
| 500 | `server_error` | 我们这边出了故障 | 是，使用退避重试 |
| 503 | `model_overloaded` | 模型 momentarily 达到容量上限 | 是，使用退避重试，或换一个模型 |

*错误响应：未知模型*

```json
{
  "error": {
    "message": "The model `gpt-4o` does not exist or is not available to your key.",
    "type": "invalid_request_error",
    "param": "model",
    "code": "model_not_found"
  }
}

```

## 为什么 gpt-4o 或 claude 会返回 404？

因为这些模型不在这里出售。我们不出售 GPT、Claude、Gemini 或 Grok 的访问权限：其开发商禁止未经其批准转售 API 访问，而我们并未获得该批准。为 OpenAI API 编写的代码通常会在多处指定模型名；在你的项目中搜索旧名称，并替换为[模型页面](https://llmwithcrypto.com/zh/models/)上的 id，例如 `deepseek-v4-pro` 或 `gpt-oss-120b`。

## 我的代码应该在什么时候重试？

重试 `429`、`500` 和 `503`，以及网络错误，例如超时或连接重置。绝不要重试 `400`、`401`、`402` 或 `404`：同样的请求会以同样的方式失败。

每次新的尝试前先等待。当响应带有 `Retry-After` 头时，等待该头指定的秒数；否则每次将暂停时间加倍（1、2、4、8 秒……）并加上一点随机时间，以免大量 worker 同步重试。尝试几次后放弃，并记录错误。OpenAI SDK 本身已会自动重试；下面的示例将其关闭，以完整展示逻辑。

*Python：对 429、500 和 503 使用指数退避重试*

```python
import os
import random
import time

from openai import APIConnectionError, APIStatusError, OpenAI

client = OpenAI(
    base_url="https://llmwithcrypto.com/api/v1",
    api_key=os.environ["LLMWITHCRYPTO_API_KEY"],
    max_retries=0,
)
RETRY = {429, 500, 503}


def chat(messages, model="deepseek-v4-pro", attempts=5):
    for attempt in range(attempts):
        try:
            return client.chat.completions.create(model=model, messages=messages, max_tokens=500)
        except APIStatusError as err:
            if err.status_code not in RETRY or attempt == attempts - 1:
                raise
            wait = err.response.headers.get("retry-after")
            delay = float(wait) if wait else min(30, 2**attempt) + random.random()
        except APIConnectionError:
            if attempt == attempts - 1:
                raise
            delay = min(30, 2**attempt) + random.random()
        time.sleep(delay)

```

## 收到 402 insufficient_balance 时该怎么办？

充值。此次调用未被计费，账户其他方面也不会变化：只要余额恢复，你的 API 密钥即可继续使用。加密货币充值确认、积分包购买完成后，你的 API 密钥就在 dashboard 里等着你。

为避免生产环境出现意外，请不时读取 `GET https://llmwithcrypto.com/api/v1/credits`，并在你选定的下限以下提醒自己；[模型与积分类页面](https://llmwithcrypto.com/zh/docs/models/)展示了此次调用。积分不会过期：这个月没花完的，明年还在，因此提前购买更大的积分包不会额外花费。

## 如何保持在 rate limit 之下？

每个账户都有每分钟请求数和 token 上限，显示在 dashboard 中；联系 support 可以调高。

- **限制并发。** 并行运行固定数量的请求，而不是一次性发出整批请求。
- **限制输出。** Token 限制也会计算模型写入的内容，因此合理的 `max_tokens` 能让更多请求保持在限制之内。
- **分散批次。** 对于大型离线任务，将请求分散到一分钟内，而不是集中突发发送。

## 错误：常见问题

### 失败的调用会收费吗？

不会。按 token 从余额扣费：输入和输出 token 由模型自己的 tokenizer 计数，按该模型每 1M token 的价格计费。以错误结束的调用不收费。

### 在哪里可以查看是否发生故障？

在[状态页面](https://llmwithcrypto.com/zh/status/)上。多个模型上连续出现 `500` 或 `503` 错误，通常意味着我们这边发生了故障；如果持续存在，请写信至 support@llmwithcrypto.com。

### 我能看到失败的请求吗？

我们这边看不到。我们不保存你的提示词或模型的回答：响应一旦发出，其文本即消失。每次调用只留一行日志，记录时间、账户、模型和 token 数量，30 天后删除。请在你的应用中记录错误 `code` 和你自己的请求 id。

---

LLMwithCrypto: LLMwithCrypto 是一个兼容 OpenAI 的开放权重模型 LLM API，涵盖 DeepSeek V4 Pro、DeepSeek V4.1 Flash、DeepSeek R1、Qwen3.5 397B A17B、Qwen3 235B A22B Instruct、gpt-oss-120b、gpt-oss-20b、GLM-4.7、Llama 3.3 70B Instruct、Gemma 4 31B、Mistral Large 3、Mistral Small 4，按 token 从预付加密货币余额中扣费，价格比公共托管商的中位价低 5%。无需 KYC：无需身份证件、无需自拍、无需文件。不存储提示词和输出。