刚好前阵子做OpenAI集成的时候踩过一模一样的坑！一开始把所有429错误都当成普通速率限制来重试，结果碰到「配额耗尽」的情况时，程序死循环重试完全没用，还白白浪费资源。后来翻了新版SDK的错误结构，发现OpenAI其实已经给了明确的区分方式，根本不用去瞎匹配错误消息字符串。

核心结论：用错误码区分，别碰错误消息 #

OpenAI的v1版本Python SDK（现在的官方标准库）里，所有API错误都会抛出OpenAI.APIError异常，这个异常里的error属性包含一个稳定的code字段——这才是我们要抓的关键：

• 当是总配额耗尽（比如当月免费额度用完、付费账户的月度额度超了），错误码是insufficient_quota
• 当是常规速率限制（比如RPM/TPM超了，也就是每分钟请求数/令牌数超了），错误码是rate_limit_exceeded

完全不用去匹配错误消息里的"quota"或者"rate limit"关键词——毕竟OpenAI哪天改了错误消息的措辞（比如本地化、换表述），字符串匹配就直接失效了，错误码是官方承诺稳定的标识。

结合Tenacity实现智能重试（终止无效循环） #

你用的是Tenacity，那只需要写一个自定义的重试判断函数，在里面检查错误码，决定要不要继续重试。直接上完整可运行的代码示例：

from openai import OpenAI, APIError
from tenacity import retry, wait_exponential, stop_after_attempt, retry_if_exception

# 初始化OpenAI客户端
client = OpenAI()

def should_retry(e):
    # 先判断是不是API返回的429错误
    if isinstance(e, APIError) and e.status_code == 429:
        error_code = e.error.code
        # 配额耗尽，直接终止重试
        if error_code == "insufficient_quota":
            print("检测到配额耗尽，终止重试循环")
            return False
        # 常规速率限制，继续指数退避重试
        elif error_code == "rate_limit_exceeded":
            print("触发速率限制，将进行指数退避重试")
            return True
    # 5xx服务器错误（比如OpenAI服务故障）也可以重试
    if isinstance(e, APIError) and 500 <= e.status_code < 600:
        return True
    # 其他错误（比如参数错误、无效密钥）直接抛出，不重试
    return False

# 用Tenacity装饰你的API调用函数
@retry(
    wait=wait_exponential(multiplier=1, min=2, max=10),  # 指数退避：2s→4s→8s…最多10s
    stop=stop_after_attempt(5),  # 速率限制的话，最多重试5次基本够等限制解除
    retry=retry_if_exception(should_retry)
)
def call_gpt_api(prompt):
    response = client.chat.completions.create(
        model="gpt-3.5-turbo",
        messages=[{"role": "user", "content": prompt}]
    )
    return response.choices[0].message.content

# 测试调用
try:
    result = call_gpt_api("帮我写一段简单的Python循环代码")
    print(result)
except APIError as e:
    print(f"最终错误：{e.error.message}（错误码：{e.error.code}）")

针对你场景的补充说明 #

你提到在免费额度内，但还是收到了「quota exceeded」的错误消息——这其实是免费 tier的RPM（每分钟请求数）限制触发的，但OpenAI有时候会把速率限制的子类型用类似的消息表述，但错误码依然是准确的：如果是RPM超了，错误码一定是rate_limit_exceeded，而不是insufficient_quota。你可以在捕获错误的时候打印e.error.code，就能明确区分。

另外要注意：必须用v1版本的OpenAI SDK（也就是pip install openai>=1.0.0），旧的v0.x版本的错误结构不一样，没有统一的error.code字段，那时候才需要匹配字符串，但现在完全没必要。

最后再啰嗦一句：永远优先用错误码做判断，别碰错误消息——这是API开发的通用最佳实践，避免因为服务商的文案更新导致你的代码失效。