Lỗi 529 overloaded_error trong Claude API — có nghĩa là gì và cách xử lý

Hãy retry như một công dân tốt

Xử lý 529 như 429 không có tiêu đề retry-after: backoff hàm mũ bắt đầu khoảng 2 giây, có jitter, trần 30–60 giây, dừng sau khoảng 5 lần thử và đưa công việc vào hàng đợi. Có thể dùng cùng nhánh mã xử lý 429 cho 529.

import time, random
from openai import APIStatusError

def com_retry(fn, tentativas=5):
    for i in range(tentativas):
        try:
            return fn()
        except APIStatusError as e:
            if e.status_code not in (429, 500, 529):
                raise
            espera = min(2 ** i + random.random(), 60)
            time.sleep(espera)
    raise RuntimeError("esgotou as tentativas")

Đổi mô hình thay vì dừng lại

Trong các đường dẫn nhạy với độ trễ, hãy xác định một mô hình dự phòng: trong cùng họ mô hình (Sonnet → Haiku), hành vi vẫn tương tự; giữa các nhà cung cấp (Claude → GPT), bạn có thể vượt qua toàn bộ một sự cố. Trên endpoint tương thích với OpenAI, đây chỉ là việc đổi một chuỗi.

PREFERIDOS = ["claude-sonnet-5", "claude-haiku-4-5", "gpt-5-6-terra"]

def completar(mensagens):
    ultimo = None
    for modelo in PREFERIDOS:
        try:
            return client.chat.completions.create(
                model=modelo, messages=mensagens, max_tokens=800)
        except APIStatusError as e:
            if e.status_code not in (429, 500, 529):
                raise
            ultimo = e          # saturado — tenta o próximo
    raise ultimo

Đừng nhầm 529 với 429 hoặc 402

429 nghĩa là bạn đã vượt giới hạn của mình (máy chủ vẫn hoạt động tốt). 529 nghĩa là máy chủ quá tải (hạn ngạch của bạn vẫn ổn). 402 nghĩa là số dư không đủ. Cả ba trông giống nhau trong log nhưng cách khắc phục hoàn toàn khác: chỉ 429 và 529 nên được retry.

Lỗi 529 có phải do tôi không?

Không. Đây là vấn đề về năng lực phía nhà cung cấp. Trách nhiệm duy nhất của bạn là không làm vấn đề trầm trọng hơn (backoff có jitter) và chuẩn bị nơi chuyển sang nếu sự cố kéo dài hơn ngân sách độ trễ của bạn.

529 khác 429 như thế nào?

429 nghĩa là bạn đã vượt giới hạn; 529 nghĩa là máy chủ quá tải. Cả hai đều có thể retry, nhưng chỉ 429 thường đi kèm gợi ý retry-after.

Tôi có bị tính phí cho yêu cầu trả về 529 không?

Thông thường là không — yêu cầu không tạo ra token. Tại Kunavo, các yêu cầu thất bại không bị trừ vào số dư.