Коды ошибок и частые ошибки

Если вызов завершается ошибкой, API возвращает код состояния HTTP и JSON. Причина ошибки указана в error.message:

{
  "error": {
    "code": "",
    "message": "Invalid token (request id: 2026101605444223...)",
    "type": "new_api_error"
  }
}

request id в конце message — это номер данного запроса; сообщайте его при обращении в поддержку. На странице «Журнал использования» в консоли также записываются время, модель и сообщение об ошибке для неудачных запросов. При разборе сначала смотрите на код состояния, затем на message.

Сообщения об ошибках выводятся на языке, сохранённом в профиле (или из заголовка Accept-Language клиента). Если ни то ни другое не задано, сообщение может прийти на китайском; смысл тот же, что описан ниже.

Краткая таблица

401: неверный токен

Частые сообщения: Invalid token, 无效的令牌 (неверный токен).

• API-ключ скопирован не полностью или содержит пробелы либо переносы строк в начале или в конце.
• Токен удалён в консоли. Создайте или скопируйте его заново на странице API-токены.
• Claude Code: одновременно задана старая переменная ANTHROPIC_API_KEY. Она имеет приоритет над ANTHROPIC_AUTH_TOKEN; удалите её и оставьте только ANTHROPIC_AUTH_TOKEN.
• Формат заголовка запроса: для формата OpenAI — Authorization: Bearer sk-...; для формата Anthropic — x-api-key: sk-....

403: токен недоступен, недостаточно средств или нет прав

Недостаточно баланса или квоты

Частые сообщения: Insufficient user quota, Not enough quota to pre-consume for this request: … remaining, … required.

• Баланса аккаунта не хватает на предварительное списание за этот запрос. Пополните баланс на странице Кошелёк.
• Баланс на аккаунте есть, но сообщение о нехватке всё равно появляется: у токена может быть собственный лимит квоты — проверьте остаток квоты этого токена.
• Claude Code показывает такую ошибку 403 как ошибку аутентификации или «API Error 403». Решение то же самое.

Токен в недоступном состоянии

Частое сообщение: This token status is unavailable.

Токен отключён, истёк или израсходовал свою квоту. На странице API-токены включите токен, измените срок действия или скорректируйте квоту.

Нет прав на группу или модель

Частые сообщения: No permission to access group …, API Key 所属专属分组不再允许当前用户使用 (выделенная группа, к которой относится этот API-ключ, больше недоступна текущему пользователю), This token has no access to model ….

• Текущий аккаунт не может использовать группу, привязанную к токену: отредактируйте токен и выберите группу, доступную в Витрине моделей.
• Для токена заданы ограничения по моделям: разрешите нужную модель в настройках токена или используйте другой токен.

Текущая группа не поддерживает этот интерфейс

Частое сообщение: This group does not allow /v1/messages dispatch.

Выбранная группа не поддерживает интерфейсы этого протокола (например, вызов /v1/messages Anthropic через группу, которая поддерживает только формат OpenAI). Для Claude Code используйте токен группы Claude; в других клиентах вызывайте тот тип интерфейса, который модель поддерживает согласно Витрине моделей.

404: адрес или модель не существует

Лишний или отсутствующий /v1 в адресе

Частые сообщения: Invalid URL, 404 page not found.

• В Claude Code для ANTHROPIC_BASE_URL укажите https://api.88api.ai без /v1 (Claude Code сам добавляет /v1/messages, и .../v1 превращается в /v1/v1/messages).
• В Codex для base_url укажите https://api.88api.ai/v1 — /v1 обязателен.
• В большинстве приложений, совместимых с OpenAI, указывается https://api.88api.ai/v1. Настройку для каждого приложения см. в руководствах по подключению приложений.

Модель недоступна в текущей группе

Частые сообщения: No available channel for model … under group …, Model "…" is not supported by any configured account in this group, model not found.

• Название модели указано с ошибкой или содержит лишний префикс или суффикс. Скопируйте точное название модели в Личных настройках или в Витрине моделей.
• Модели нет в группе, выбранной для токена. Посмотрите в Витрине моделей, какие группы поддерживают модель, и измените группу токена.

400: содержимое или параметры запроса не принимаются

429: слишком частые запросы или перегрузка

Превышен лимит частоты запросов аккаунта

Частое сообщение: Your request rate is too high. The current user group allows up to … successful requests within a …-minute window.

По умолчанию лимит — 60 RPM (запросов в минуту). Снизьте параллельность или добавьте интервалы между повторами в клиенте; если действительно нужна более высокая частота, обратитесь в поддержку с запросом на увеличение лимита.

Модель перегружена

Частые сообщения: Upstream rate limit exceeded, service error, please try again later, Concurrency limit exceeded.

Сейчас к модели поступает много запросов. Подождите несколько секунд и повторите; для стабильной работы можно выбрать другую группу в Витрине моделей.

500, 502, 503, 504, 524: сервис временно недоступен или истекло время ожидания

Частые сообщения: Upstream service temporarily unavailable, Service temporarily unavailable. Please retry., 系统过载，请稍后重试 (система перегружена, повторите попытку позже), 模型请求失败，请稍后重试或更换模型 (запрос к модели не выполнен, повторите позже или смените модель), bad response status code 504.

• Такие ошибки обычно вызваны кратковременной перегрузкой сервиса модели или колебаниями сети, и повторный запрос, как правило, проходит. Рекомендуем повторять запросы в клиенте с увеличивающимся интервалом: 1, 2, 4 секунды.
• Если одна и та же модель продолжает выдавать ошибку, смените группу или модель.
• 524 и 504 чаще всего возникают на запросах с долгой генерацией: для запросов чата включите потоковый вывод (stream: true); для изображений и видео используйте асинхронные интерфейсы задач и опрашивайте результат.

Если проблема не решена

Найдите неудачную запись в Журнале использования и отправьте время запроса, название модели, код состояния и полное сообщение об ошибке (включая request id) в онлайн-поддержку. Не отправляйте свой API-ключ целиком.