Перейти к содержанию

Ошибки и поддержка

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

Если Nexus отклоняет запрос, ответ содержит:

  • message
  • type
  • code
  • param иногда, если ошибка относится к конкретному полю
  • request_id

Для поддержки важнее всего request_id.

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

invalid_key

Ключ не передан, указан неверно, отключен или отозван.

Проверьте:

  • заголовок Authorization: Bearer <API_KEY>;
  • заголовок x-api-key, если ваш клиент использует его;
  • отсутствие лишних пробелов.

endpoint_not_allowed

Ваш ключ не имеет доступа к выбранному маршруту.

Проверьте, что клиент настроен под нужный сценарий. Если нужен другой доступ, обратитесь в поддержку.

model_not_allowed

Модель не включена для вашего ключа.

Выполните GET /v1/models и выберите модель из ответа.

unsupported_model

Модель не работает на выбранном маршруте.

Например, одна модель может быть доступна для chat.completions, но не для responses.

unsupported_endpoint

Клиент отправил запрос на неподдерживаемый маршрут.

Используйте только маршруты из страницы Поддерживаемые маршруты

streaming_not_supported

Клиент запросил streaming там, где Nexus его не поддерживает.

Streaming поддерживается для:

  • POST /v1/messages;
  • POST /v1/responses;
  • POST /v1/responses/compact.

missing_model

В теле запроса нет поля model.

Добавьте модель в JSON-запрос.

invalid_request_json

Nexus не смог разобрать JSON body.

Проверьте синтаксис JSON. Если в ответе есть param: "body", проблема именно в теле запроса.

unsupported_content_type

Для этого маршрута передан неверный Content-Type.

JSON-маршруты требуют application/json. Multipart-маршруты требуют multipart/form-data.

payload_too_large

Размер запроса превышает допустимый лимит маршрута.

Уменьшите размер body, файла или base64-вложения и повторите запрос.

insufficient_balance

Текущий баланс профиля Nexus ниже порога допуска нового запроса.

Пополните баланс и повторите запрос.

pricing_unavailable

Для выбранной модели временно недоступен безопасный расчет стоимости.

Обычно это решается на стороне поддержки. Повторите позже или напишите в поддержку с request_id.

duplicate_request_id

Такой x-request-id уже был принят раньше.

Создайте новый x-request-id или уберите этот заголовок, если ваш клиент не требует его явно.

billing_finalization_failed

Запрос дошел до этапа финального учета, но автоматическое завершение не удалось.

Передайте request_id в поддержку. Повторять запрос сразу не стоит, пока не понятно, был ли ответ учтен.

Ошибка внешнего запроса

Внешний запрос не был успешно завершен.

Повторите позже. Если ошибка повторяется, передайте в поддержку модель, маршрут, время ошибки и request_id.

upstream_unavailable

Nexus не может безопасно обратиться к внешнему провайдеру из-за конфигурации или временной недоступности.

Обычно это требует проверки на стороне сервиса. Повторите позже или напишите в поддержку с request_id.

upstream_timeout

Внешний провайдер не ответил за допустимое время.

Такой запрос обычно можно повторить позже. Если таймауты повторяются, передайте в поддержку request_id.

internal_error

Внутренняя ошибка сервиса.

Передайте request_id в поддержку.

Когда писать в поддержку

Пишите, если:

  • ключ активен, но модели не отображаются;
  • баланс пополнен, но запросы отклоняются;
  • одна и та же ошибка повторяется;
  • нужен дополнительный ключ или восстановление доступа к аккаунту;
  • нужна ручная проверка списания.

Контакт:

Что приложить

  • request_id;
  • модель;
  • маршрут;
  • примерное время ошибки;
  • название клиента или инструмента.