OpenRouter 429 怎么解决？免费模型限额、请求过快和模型不可用一次讲清

01 先判断：你的 429 属于哪一种

不同原因的 429，处理方式完全不同。先用下面这张表定位。

关键区分：402 = 要钱（余额/额度），429 = 太快/太多（限速）。退避对 402 没用，先查余额。

02 最常见：免费请求额度到了

官方当前规则（核实于 2026-09-08）：以 :free 结尾的免费模型变体，平台限额如下：

• 这是平台层对免费变体的限制，和具体模型无关。
• 购买「至少 10 credits」后，即使余额后来低于 10，更高的日限额仍然保留。
• 失败的请求也计入当日配额——疯狂重试会更快把额度打满，所以一定要退避、不要高频重发。
• Cloudflare 的 DDoS 防护会在请求量「明显超出合理使用」时直接拦，表现为 429。

规则可能变化，以 OpenRouter 当前官方说明为准。

03 请求太快导致 429

即使日额度还很多，每分钟 20 次（免费档）的上限也可能被瞬间并发打爆。注意：

• 不同模型 / provider 的限速不同，不要凭空假设一个固定 RPM/TPM；以官方速率限制文档为准。
• 真正危险的是「并发」而不是「平均速率」：100 个 worker 同时发请求，可能在任何单个请求收到 429 之前就越限。
• 解法不是「排更长的队」，而是降低并发、用退避和共享限流队列，让重试错开。

04 免费模型自身拥堵

这是最容易误判的一种：你的账户还有额度，但某个免费 provider 暂时没有容量。

• 免费模型由上游 provider 提供，高峰期（尤其热门模型）provider 可能暂时满负荷。
• 此时 OpenRouter 会先自动 fallback 到其他 provider；若所有 provider 都满，错误里的 error.metadata.provider_code 会带上 provider 原始错误码。
• 表现就是间歇性 429，过一会儿（或换时段）又好了。

05 模型已经下架 / 不可用了怎么办

如果你一直调用的某个免费模型突然 429 且稳定不复活，很可能它已经下架或暂时不可用。处理：

1. 打开 OpenRouter 免费模型怎么找（当前可用清单），确认它是否还在架。
2. 优先改用在架的 :free 模型；不要把全部流量压在单一免费模型上。
3. 在代码里配置 fallback 模型，模型 A 不可用时自动切到 B。

06 最简单的解决顺序（5 分钟定位）

1. 看错误码：是 429 还是 402？402 先去查余额/充值，不要退避。
2. 看错误体：有没有 error.metadata.provider_code？有 → 是 provider 侧容量；没有且带 X-RateLimit-* → 是平台免费限额。
3. 数请求：当天免费请求是不是接近 50 / 1000？并发是不是瞬间很高？
4. 退避重试：尊重 Retry-After，否则指数退避，不要立即高频重发。
5. 换模型 / 充值：仍不行就换在架免费模型、配置 fallback，或充值提升日限额。

07 推荐的代码处理方式

核心原则：捕获 429 → 指数退避（带抖动）→ 设最大重试次数 → 绝不无限重试 → 最终失败给出明确提示。下面是可直接改用的模板，Key 用占位符 YOUR_OPENROUTER_API_KEY。

Python

import time, random, requests

API_URL = "https://openrouter.ai/api/v1/chat/completions"
API_KEY = "YOUR_OPENROUTER_API_KEY"  # 替换为你自己的 OpenRouter API Key

def call_openrouter(messages, model="openrouter/auto", max_retries=5):
    headers = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}
    payload = {"model": model, "messages": messages}
    backoff = 1.0
    for attempt in range(1, max_retries + 1):
        resp = requests.post(API_URL, headers=headers, json=payload, timeout=30)
        if resp.status_code != 429:
            resp.raise_for_status()
            return resp.json()
        # 429：尊重 Retry-After，否则指数退避（带抖动），上限 30s
        ra = resp.headers.get("Retry-After")
        wait = int(ra) if (ra and ra.isdigit()) else backoff
        wait += random.uniform(0, 0.5)
        print(f"[429] 第 {attempt}/{max_retries} 次，{wait:.1f}s 后重试")
        time.sleep(wait)
        backoff = min(backoff * 2, 30)
    raise RuntimeError("已重试 max_retries 次仍收到 429，请稍后或换模型/充值")

JavaScript / Node.js

const API_URL = "https://openrouter.ai/api/v1/chat/completions";
const API_KEY = "YOUR_OPENROUTER_API_KEY"; // 替换为你自己的 OpenRouter API Key

async function callOpenRouter(messages, model = "openrouter/auto", maxRetries = 5) {
  const payload = { model, messages };
  let backoff = 1000;
  for (let attempt = 1; attempt <= maxRetries; attempt++) {
    const resp = await fetch(API_URL, {
      method: "POST",
      headers: { "Authorization": `Bearer ${API_KEY}`, "Content-Type": "application/json" },
      body: JSON.stringify(payload),
    });
    if (resp.status !== 429) {
      if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
      return resp.json();
    }
    const ra = resp.headers.get("Retry-After");
    let wait = ra && /^\d+$/.test(ra) ? parseInt(ra, 10) * 1000 : backoff;
    wait += Math.random() * 500;
    console.log(`[429] 第 ${attempt}/${maxRetries} 次，${(wait / 1000).toFixed(1)}s 后重试`);
    await new Promise((r) => setTimeout(r, wait));
    backoff = Math.min(backoff * 2, 30000);
  }
  throw new Error("已重试 maxRetries 次仍收到 429，请稍后或换模型/充值");
}

流式（streaming）场景下，限流可能在 200 已经发出后才到达，表现为 SSE 的 finish_reason: "error" 事件，客户端要单独处理，不能只看 HTTP 状态码。

08 openrouter/free 能不能减少 429

openrouter/free 是「免费模型路由器」，会自动帮你挑一个在架的免费模型。它能解决什么：把请求分散到多个免费模型，降低单个模型被你打满的概率。不解决什么：

• 不绕过平台的 50 / 1000 每日总限额——所有免费模型共享这条日上限。
• 不解决某个 provider 暂时没容量的问题。
• 不解决 402（余额不足）。

所以 openrouter/free 值得用，但别指望它「永远不会 429」。

09 免费用户最稳的使用方法

• 不要把所有请求压在同一个免费模型：准备 2–3 个在架 :free 模型做轮换/ fallback。
• 先查询当前在架免费模型：定期看 免费模型清单，下架的及时换掉。
• 合理退避：拿到 429 就退避，不要立刻高频重发（失败也计费/计额度）。
• 请求失败不要立即重发：加指数退避 + 抖动 + 最大重试上限。
• 保留备用模型：在代码里配置 fallback，单模型不可用时无缝切换。
• 真要做生产流量：考虑充值提升日限额，或对关键路径用付费变体（无平台级请求上限）。

10 FAQ

免费资源

拿走即可用的排查与重试模板：

• 429 排查清单（openrouter-429-checklist.md）
• Python 重试模板（openrouter-retry-python.py）
• Node.js 重试模板（openrouter-retry-node.js）

文中速率与额度数据核实于 2026-09-08，可能随 OpenRouter 政策调整，以 官方速率限制文档 为准。