> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nexusapi.link/llms.txt
> Use this file to discover all available pages before exploring further.

# Частые ошибки API

> Диагностируйте проблемы NexusAPI по коду ошибки, протоколу и Request ID.

Сначала сохраните текст ошибки, Request ID, время, модель и endpoint. Ошибки параметров, протокола и состояния сессии не устраняются частыми повторами.

## `status_code=500, not implemented`

Для Anthropic-типа Claude, вызванного через `/v1/responses`, это **несовместимость протокола**, а не временный сбой.

1. В собственном приложении используйте `/v1/chat/completions`.
2. В Claude Code используйте настройку Messages из [руководства](/ru/tools/claude-code).
3. Не отправляйте тот же запрос без изменений.

## HTTP-статусы

| Код             | Типичная причина                                         | Первое действие                                                    |
| --------------- | -------------------------------------------------------- | ------------------------------------------------------------------ |
| 400             | Неверные модель, endpoint, параметр или состояние сессии | Проверьте протокол и сделайте минимальный тест в новой сессии.     |
| 401             | Ключ отсутствует, неверен, истёк или отключён            | Снова скопируйте ключ и Bearer-формат.                             |
| 403             | Группа, ограничение, IP, аккаунт или отказ upstream      | Проверьте настройки ключа.                                         |
| 404             | Неверный путь или дублированный `/v1`                    | Проверьте фактический URL.                                         |
| 429             | Ограничение частоты или параллельности                   | Уменьшите параллельность и следуйте `Retry-After`.                 |
| 500 / 502 / 503 | Временная ошибка обработки или upstream                  | Подождите 10–30 секунд и повторите один раз.                       |
| 504 / 524       | Таймаут ожидания                                         | При необходимости сократите контекст/вывод и сохраните Request ID. |

## Другие сообщения

* **`no available channel`**: в группе ключа нет включённого маршрута к модели. Проверьте точный ID, группу и каталог; новый ключ или пополнение это не исправляет.
* **`Concurrency limit exceeded for user`**: дождитесь текущих запросов и уменьшите параллельность клиента.
* **`Content block not found`**: часто возникает в длинной сессии, вызове инструмента или прерванном потоке. См. [Content block not found](/ru/faq/content-block-not-found).
* **Ошибка/таймаут изображения**: проверьте модель, Images endpoint и параметры; не отправляйте ту же задачу сразу повторно.

Неожиданное списание сверяйте по Request ID и журналам за тот же период. Не считайте, что обычный запрос автоматически повторяется платформой.