529 overloaded_error у Anthropic: что значит и почему через go2llm он почти не встречается

Ошибка 529 overloaded_error означает, что API Anthropic временно перегружен — это официальная формулировка вендора, а не проблема ключа, баланса или конкретного запроса. У go2llm такого статуса нет вовсе: шлюз стоит перед несколькими маршрутами к модели и до первого байта ответа может тихо переключиться на рабочий, поэтому клиент go2llm в большинстве случаев не видит аналог 529 — только 502 или 503, если рабочего маршрута не осталось.

Страница составлена 2026-09-22, обновлена 2026-09-22.

Как выглядит ошибка у Anthropic

Прямой API api.anthropic.com возвращает статус 529 с телом:

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

Официальная документация Anthropic описывает это прямо: «529 errors can occur when the API experiences high traffic across all users» — перегрузка общая, по всем пользователям API, а не персональный лимит конкретного аккаунта. Источник: platform.claude.com/docs/en/api/errors, сверено 2026-09-22.

Claude Code при получении 529 от прямого API обычно показывает в терминале короткое сообщение об ошибке и завершает текущий запрос — так же, как и с другими 5xx от вендора.

Причины

1. Общая перегрузка инфраструктуры Anthropic

Единственная официально названная причина — всплеск трафика по всем клиентам API одновременно. Это не зависит от вашего собственного объёма запросов: Anthropic отдельно предупреждает, что резкий рост именно вашего трафика скорее даст 429 из-за acceleration limits, а не 529 — это разные механизмы защиты.

2. У go2llm 529 не существует как код ошибки

В таблице кодов ошибок go2llm статуса 529 нет: шлюз возвращает 502 upstream_unavailable, если конкретный запрос к поставщику не удался, или 503 product_paused / 503 no_eligible_route, если сервис приостановлен или для запроса не осталось разрешённого маршрута. Формально это разные коды с разной причиной, но по сути они покрывают тот же сценарий «сейчас ответа от модели нет» — разбор 502 и 503 с ретраями.

3. Почему через go2llm перегрузка одного маршрута часто остаётся незамеченной

go2llm может использовать совместимый fallback-маршрут на разрешённых классах ошибок до начала ответа — то есть до первого байта или до первого валидного события SSE-потока переключение на другой рабочий маршрут к той же модели возможно, и клиент получает 200 вместо ошибки. После первого байта переключение уже не выполняется: если поток начался и оборвался, это отдельная ситуация, а не то же самое, что 529 у прямого API. Прямой API Anthropic такого fallback не делает по определению — это одна инфраструктура, и 529 доходит до клиента напрямую.

Как чинить

Если вы работаете напрямую с api.anthropic.com. Официальная рекомендация Anthropic — повторить запрос с экспоненциальной задержкой. Официальные SDK делают это автоматически: по умолчанию две попытки с экспоненциальным backoff, с учётом заголовка retry-after, если он присутствует. Ручной ретрай стоит строить по тому же принципу:

import random, time
import httpx

def call_anthropic_with_retry(payload, api_key, max_attempts=3, base=1.0, cap=16.0):
    with httpx.Client(timeout=60.0) as client:
        for attempt in range(max_attempts):
            r = client.post(
                "https://api.anthropic.com/v1/messages",
                headers={
                    "x-api-key": api_key,
                    "anthropic-version": "2023-06-01",
                    "content-type": "application/json",
                },
                json=payload,
            )
            if r.status_code != 529:
                return r
            if attempt == max_attempts - 1:
                return r
            delay = min(cap, base * (2 ** attempt))
            time.sleep(delay * (0.5 + random.random() / 2))

Если вы хотите не думать про 529 вообще. Переключитесь на go2llm — те же две переменные, что и всегда:

export ANTHROPIC_BASE_URL=https://go2llm.tech
export ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY
export ANTHROPIC_MODEL=claude-sonnet-5
claude

Это не устраняет перегрузку Anthropic как явление — если перегружены все маршруты, годные для вашего запроса, go2llm вернёт 502 или 503 с тем же смыслом, что и 529 у вендора. Разница в том, что до этого момента у шлюза есть попытка тихого переключения, которой у прямого подключения к одному вендору нет по конструкции.

Как отличить 529 от похожих ошибок

529 overloaded_error — не то же самое, что 429 rate_limit_error. У 429 причина в лимитах именно вашей организации или ключа — квота, RPM, спенд-кап; у 529 причина в общей нагрузке на API и к вашему аккаунту отношения не имеет. Ретраить в лоб оба кода можно, но 429 дополнительно требует не наращивать частоту запросов резко — Anthropic отдельно предупреждает, что резкий скачок трафика от одного аккаунта может упереться в acceleration limits и дать 429, даже если формальная квота не исчерпана.

У go2llm ближайший по смыслу код — 503 no_eligible_route: для запроса не нашлось разрешённого маршрута прямо сейчас. 429 rate_limit и 429 quota у go2llm — это отдельная история, про лимит 20 RPM на ключ и про баланс, а не про перегрузку инфраструктуры.

Связанные ошибки

502 и 503: как правильно ретраить — ближайший по смыслу код у go2llm.
429 rate_limit_error — лимит запросов, а не перегрузка API.
401 authentication_error — если проблема в ключе, а не в доступности модели.
Справочник всех кодов go2llm и docs/errors.

FAQ

Можно ли получить 529 от go2llm? Нет. У go2llm такого кода ошибки не существует — таблица ошибок шлюза ограничена кодами, которые он сам формирует: 400–405, 409, 413, 429, 502, 503. Аналогичная по смыслу ситуация — недоступность модели прямо сейчас — на go2llm выражается как 502 upstream_unavailable или 503 no_eligible_route.

Значит ли отсутствие 529 у go2llm, что перегрузок не бывает? Нет, значит только то, что часть перегрузок одного маршрута закрывается автоматическим переключением до первого байта ответа, а оставшаяся часть отдаётся под другими кодами (502, 503) с той же в общем логикой «повторить чуть позже». Полной гарантии доступности это не даёт: доступность в целом зависит от внешних поставщиков.

Стоит ли ретраить 529 бесконечно? Нет. Официальные SDK Anthropic ограничивают автоматический ретрай двумя попытками по умолчанию. Если после нескольких попыток с экспоненциальной задержкой ошибка сохраняется, это устойчивая перегрузка, а не кратковременный всплеск, и стоит либо подождать дольше, либо переключиться на маршрут с автоматическим fallback.

Получить ключ и сделать первый запрос за 3 минуты → go2llm.tech. Цены на все модели — на странице тарифов, инструкции по подключению — в документации.