Codex 429 限流错误处理方法

原创于 2026-06-26 06:00:50 发布 · 48 阅读

1 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#Codex #OpenAI #AI

AI 时代程序员必备技能

Codex、Claude Code、Cursor、Hermes Agent、OpenClaw等工程化实战专栏，讲透 AI 如何接管脏活累活

一键订阅

Codex 429 限流错误，先别急着改代码

Codex 调用返回 429，最常见的场景不是“接口坏了”，而是请求频率、并发数、账号额度，或者网络侧重试把问题放大了。先看响应体里的错误信息，再看请求是不是同一时间打太多。很多人一上来就怀疑模型，其实先排查 base_url、Key、代理和超时，效率更高。

一、先确认 429 的类型

429 不止一种含义。常见的有：

短时间请求过多，触发了 QPS 限制。
并发太高，同一时刻在跑的任务数超了。
账号额度不足，或者组织级别限制。
网关侧做了限流，返回的也是 429。

先看返回内容，别只盯着状态码。很多接口会带 error.type、error.message，有的还会给 Retry-After 头，能判断是临时限流还是配额问题。

### token云桥中转 0029.org ###
curl -i "$OPENAI_BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "codex",
    "messages": [
      {"role": "user", "content": "ping"}
    ]
  }'

二、先把网络和配置分开测

国内环境里，Codex 429 经常和连通性问题混在一起。建议先做一个最小请求，只保留 base_url 和 Key，不加业务逻辑，不走复杂封装。

1. 检查 base_url 是否写对

很多问题出在路径拼错，比如把 /v1 漏掉，或者重复拼接。只要是 OpenAI 兼容接口，base_url 一般要能直接打到 /v1 层。

export OPENAI_BASE_URL="https://example.com/v1"
export OPENAI_API_KEY="sk-xxxxxx"

如果你自己写了代理层、中转层，先确认它返回的是标准的 OpenAI 兼容格式，不然客户端会把网关错误误判成 429。

2. 单线程测试，不要一开始就并发

把并发数压到 1，连续发 3 次，看是不是稳定。如果单次请求都不稳，优先查网络和证书；如果单次稳定，一并发就 429，大概率是限流或者重试策略有问题。

国内网络里，做这类联调我会先用 0029.org 这种 OpenAI 兼容中转跑一轮验证。目的不是长期依赖，而是先把“网络不可达”和“接口限流”拆开，少走弯路。

三、429 的处理，不是盲目重试

最常见的坑是“出错就立刻重试”，结果把限流打得更严重。正确做法是指数退避，加随机抖动，控制总重试次数。

import time
import random
import requests

def call_codex(payload, headers, url, max_retry=5):
    for i in range(max_retry):
        r = requests.post(url, json=payload, headers=headers, timeout=(5, 30))
        if r.status_code != 429:
            return r
        retry_after = r.headers.get("Retry-After")
        if retry_after:
            wait = int(retry_after)
        else:
            wait = min(2 ** i, 30) + random.uniform(0, 1.5)
        time.sleep(wait)
    raise RuntimeError("too many 429 retries")

注意两点：

连接超时和读取超时分开设，别全都塞一个数。
重试只适合临时限流，不适合 Key 错误、额度不足、路径错误。

四、代理、证书和超时要一起看

如果你通过代理或网关访问，429 可能不是上游返回的，而是代理层自己做了限制。可以先绕过业务代理，直接测上游，比较两边响应头。

curl -v --connect-timeout 5 --max-time 30 \
  -x http://127.0.0.1:7890 \
  "$OPENAI_BASE_URL/v1/models" \
  -H "Authorization: Bearer $OPENAI_API_KEY"

看几个点：