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

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

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

• message
• type
• code
• 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-запрос.

insufficient_balance

На ключе недостаточно средств для нового запроса или для временного резерва под него.

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

pricing_unavailable

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

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

pricing_stale

Тариф для модели требует обновления перед новым запросом.

Повторите позже или напишите в поддержку.

duplicate_request_id

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

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

billing_finalization_failed

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

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

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

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

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

internal_error

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

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

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

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

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

Контакт:

• Личные сообщения на торговой площадке
• Telegram

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

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