Ошибки

При возникновении ошибки Nexara API возвращает соответствующий HTTP-код состояния и тело ответа в формате JSON с описанием проблемы в поле detail:

{
  "detail": "Недостаточно средств на аккаунте."
}

Ниже перечислены все коды ошибок, которые может вернуть API, с указанием причин и способов их устранения.

400 — Неверный запрос (Bad Request)

Самая частая категория ошибок. Возникает при некорректных параметрах запроса. Проверка выполняется до обработки файла, поэтому такие ошибки возвращаются быстро.

Возможные причины:

• Файл и ссылка одновременно — указаны и file, и url. Нужно передать что-то одно.
  • Неверный запрос: укажите либо аудиофайл, либо ссылку, но не оба одновременно.
• Не указан ни файл, ни ссылка — не передан ни file, ни url.
  • Неверный запрос: укажите либо аудиофайл, либо ссылку.
• Некорректная ссылка — значение url не прошло валидацию.
• Неподдерживаемая задача — параметр task не входит в список поддерживаемых.
  • Задача '...' не поддерживается. Вот список поддерживаемых задач: ...
• Неподдерживаемый формат ответа — параметр response_format не входит в список поддерживаемых.
  • Формат ответа '...' не поддерживается. Вот список поддерживаемых форматов: ...
• Неподдерживаемая модель — параметр model не входит в список поддерживаемых.
  • Модель '...' не поддерживается. Поддерживаемые модели: ...
• Неподдерживаемый словарь — параметр dictionary не входит в список поддерживаемых.
  • Словарь '...' не поддерживается. Поддерживаемые словари: ...
• Некорректные параметры генерации:
  • temperature должна быть в диапазоне от 0.1 до 1.
  • repetition_penalty должен быть в диапазоне от 0.1 до 2.
  • length_penalty должен быть в диапазоне от 0.1 до 2.
• Неподдерживаемый язык — параметр language не входит в список поддерживаемых.
  • Язык '...' не поддерживается. Список доступных языков - https://docs.nexara.ru/docs/languages.
• Файл слишком большой — размер файла превышает максимально допустимый.
  • Неверный запрос: файл слишком большой. Максимальный размер - ... байт.
• Слишком короткое аудио:
  • Минимальная длина аудио - 0.3 секунды.
  • Минимальная длина аудио при диаризации - 3 секунды. (для task=diarize)
• Некорректная гранулярность таймкодов — значение timestamp_granularities не поддерживается.
  • Гранулярность '...' не поддерживается. Поддерживаемые: ...
  • Гранулярность 'sentence' доступна только для задачи 'transcribe'.
• Ошибки тегирования ролей (roles):
  • Тегирование ролей (roles) доступно только с диаризацией (task=diarize).
  • roles должен быть 'auto', JSON-списком строк или JSON-объектом {роль: описание}.
  • Список ролей не может быть пустым. / Объект ролей не может быть пустым.
  • Слишком много ролей. Максимум — ...
  • Каждая роль должна быть непустой строкой не длиннее ... символов.
  • Роли не должны повторяться.
  • Описание роли должно быть строкой. / Описание роли не должно превышать ... символов.
• Ошибка обработки файла или ссылки:
  • Error while processing the file metadata.
  • Ошибка обработки ссылки на файл: ...

Как исправить: внимательно проверьте параметры запроса и сообщение в поле detail — оно указывает на конкретную проблему.

402 — Требуется оплата (Payment Required)

Недостаточно средств на балансе для выполнения запроса. Стоимость рассчитывается заранее по длительности аудио (с учётом надбавок за фильтр мата, тегирование ролей и LLM-обработку). Запрос отклоняется, если предполагаемая стоимость превышает баланс плюс лимит овердрафта.

• Недостаточно средств на аккаунте.

Как исправить: пополните баланс аккаунта.

403 — Доступ запрещён (Forbidden)

Проблема с аутентификацией по API-ключу. Это основной механизм авторизации для эндпоинтов транскрибации.

• No token specified — не передан API-ключ (заголовок Authorization).
• Invalid token — передан несуществующий или недействительный API-ключ.

Как исправить: убедитесь, что вы передаёте корректный API-ключ в заголовке Authorization.

404 — Не найдено (Not Found)

Запрашиваемый ресурс не существует.

• Model not found — запрошена несуществующая модель.
• API key not found — API-ключ не найден.
• Job not found — асинхронная задача с указанным job_id не найдена.

408 — Тайм-аут запроса (Request Timeout)

Превышено время анализа медиафайла (ffprobe).

• Media analysis timed out. — при обработке загруженного файла.
• Media analysis timed out (ffprobe). URL might be too slow or unresponsive. — при обработке по ссылке (медленный или недоступный url).

Как исправить: проверьте доступность и скорость отдачи файла по ссылке, либо загрузите файл напрямую.

415 — Неподдерживаемый тип файла (Unsupported Media Type)

Формат файла или его MIME-тип не поддерживается. Полный список поддерживаемых форматов — на странице Поддерживаемые файлы.

Как исправить: конвертируйте файл в один из поддерживаемых форматов и убедитесь, что указан правильный Content-Type.

429 — Слишком много запросов (Too Many Requests)

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

• Превышен лимит частоты запросов (rate limit).
• Too many concurrent async jobs. Maximum is ... Please wait for existing jobs to complete before submitting new ones. — превышено число одновременных асинхронных задач.

Как исправить: снизьте частоту запросов или дождитесь завершения текущих асинхронных задач перед отправкой новых.

500 — Внутренняя ошибка сервера (Internal Server Error)

Непредвиденная ошибка на стороне сервера.

• Internal Server Error — общая ошибка обработки.
• Error retrieving user information. — не удалось получить данные пользователя.
• Ошибка при получении LLM-саммари. — сбой при генерации LLM-обработки (при этом запрос не тарифицируется).

Как исправить: повторите запрос позже. Если ошибка повторяется — обратитесь в Поддержку.

502 — Сервис недоступен (Bad Gateway)

Сервис временно недоступен.

Как исправить: повторите запрос позже или обратитесь в Поддержку.