Claudeのエラー529 overloaded_error—

529は、コードが引き起こしたものではないClaudeの唯一のエラーです。過負荷なのはAnthropic側です。自分で修正することはできず、エレガントに吸収するしかありません。つまり、バックオフを伴う忍耐強い再試行、待ち時間に敏感な経路でのフォールバックモデル、そして障害を増幅する即時の再試行バーストを避けることが必要です。

エラー

respuesta (HTTP 529)

{
  "type": "error",
  "error": { "type": "overloaded_error",
             "message": "Overloaded" }
}

原因と対処法の概要

原因	対処法
プロバイダー側の過負荷（リリース日や地域的な障害）。すべての顧客に同時に影響します。	ジッター付きバックオフ。アプリケーションを再デプロイするのではなく、Anthropicのステータスページを確認してください。
自身の負荷急増が、すでに逼迫したキャパシティに重なっています。	バッチジョブの実行時刻をずらしてください。通常、10分遅らせると状況が解消します。
429との混同。ログではレート制限に見えますが、原因はまったく異なります。	429は上限を超えたことを意味します（サーバーは正常）。529はサーバーが過負荷であることを意味します（クォータは正常）。Retry-Afterのヒントが返るのは429だけです。
フォールバックが定義されていないため、プロバイダーの問題がエンドユーザーまで到達します。	フォールバックチェーンを定義してください。同じファミリー内（Sonnet → Haiku）なら挙動は似たままですが、プロバイダー間（Claude → GPT）なら完全な障害にも耐えられます。

障害を増幅せずに再試行する

529はRetry-Afterのない429として扱います。約2秒から指数バックオフを開始し、ジッターを加え、上限を30〜60秒に設定し、約5回の試行で諦めてジョブをキューに入れます。重要なのはジッターです。ジッターがないと、すべてのクライアントが同時に再試行し、解消しようとしている過負荷をさらに長引かせます。

停止するのではなく切り替える

待ち時間に敏感な経路では、フォールバックチェーンを定義してください。OpenAI互換エンドポイントでは、変更するテキスト文字列は1つだけです。2つ目のSDKも、2つ目のアカウントも必要ありません。

failover.py

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

def complete(messages):
    last = None
    for model in PREFERRED:
        try:
            return client.chat.completions.create(
                model=model, messages=messages, max_tokens=800)
        except APIStatusError as e:
            if e.status_code not in (429, 500, 529):
                raise
            last = e          # saturado — probar el siguiente nivel
    raise last

その後で初めてコードを確認する

他の呼び出しが同時に成功しているのに、529が1種類のリクエストでのみ発生する場合、全体的な障害ではありません。その経路が異常に大きなプロンプトを送っていないか、短いループでリクエストを連続送信していないかを確認してください。一方、すべての呼び出しに一斉に影響し、自然に消える場合はキャパシティの問題です。その場合に必要なのはリファクタリングではなく、再試行とフォールバックです。

Kunavo経由で呼び出している場合

Kunavoは複数のオリジン経路でClaudeをルーティングしており、マルチモデルのカタログによって、同じキーと同じウォレットのままモデル名を変更するだけでプロバイダーを切り替えられます。上記のパターンに2つ目のアカウントは必要ありません。それでも発生した529は、決して課金されません。キャパシティと料金は別の問題です。料金については、モデル別の料金が掲載されている Claudeの料金.

よくある質問

529は私の責任ですか？

いいえ。プロバイダー側のキャパシティの問題です。あなたの責任は、バックオフとジッターで障害を増幅しないこと、そして障害が待ち時間の予算を超えて続いた場合に備えてフォールバックを用意することだけです。

529と429の違いは何ですか？

429は上限を超えたことを意味し、サーバーは正常です。529はサーバー自体が過負荷で、クォータは正常であることを意味します。どちらも再試行できますが、Retry-Afterのヒントが返るのは429だけです。

529の障害は通常どのくらい続きますか？

予測も保証もできません。そのため、正しい対応は上限付きバックオフとキューであり、コードに固定した待機時間ではありません。経路に待ち時間の予算がある場合は、待機ではなくフォールバックへ引き継ぎます。

529で終了した呼び出しは課金されますか？

Kunavo経由では課金されません。エラーで終了したリクエストには課金されません。直接契約の場合は、該当プロバイダーの課金ルールによります。

Claude APIのエラー529 overloaded_errorとは？また、どう吸収すればよいですか？

エラー