Коды ошибок
Обзор кодов ошибок, причин и решений для быстрого устранения
Мы используем стандартные коды из спецификации HTTP. Успешные коды начинаются на 2xx. Если вы получаете ответ с кодом состояния из диапазона 4xx или 5xx значит возникла ошибка, давайте рассмотрим самые частые из них.
Список кодов
| Код | Причина | Решение |
|---|---|---|
| 400 | Bad Request - Неправильно сконфигурированный запрос | Убедитесь, что в теле запроса вы передаете корректным JSON-объект если это application/json, подробнее, а ключ API указан верно. |
| 401 | Unauthorized - Отсутствует или недействительный токен | Убедитесь, что вы используете правильный API токен и правильно его указываете. Создайте новый если ошибка сохраняется на странице. |
| 402 | Payment Required - На аккаунте, связанном с API токеном, закончились средства либо достигнут месячный лимит. | Увеличьте месячный лимит по расходам или сделайте платеж для возобновления работы. |
| 404 | Not found - Неверный URL-адрес конечной точки или название модели | Убедитесь, что ваш запрос отправляется на правильную конечную точку и что запрашиваемая модель доступна. Актуальный список доступных моделей |
| 422 | Unprocessable Entity - Слишком много запросов отправлено за короткий промежуток времени | Убедитесь, что параметры которые вы подаете на вход модели корректны. Перейдите на страницу модели, например https://connecte.ai/openai/whisper далее на вкладку API -> SCHEMA JSON, сверьте типы данных и обязательные параметры (required). |
| 429 | Too Many Requests - Запрос верный, но не проходит валидацию | Ограничьте скорость, с которой ваши запросы отправляются на наши серверы, либо создайте заявку на расширение лимитов. |
| 500 | Server Error - Неизвестная ошибка сервера | Произошла ошибка из-за сбоя на наших серверах. Попробуйте повторить запрос позже. Если ситуация не изменится, воспользуйтесь диагностикой обнаружения проблем. |
Диагностика ошибок
Если у вас возникает ошибка, которая не описана на данной странице или вы не можете самостоятельно решить проблему, сообщите в техническую поддержку
По умолчанию мы не логируем и не сохраняем параметры запросов, если вы явно не укажите обратное. Добавьте следующие заголовки для того чтобы мы могли отследить и провести диагностику проблемы/
- x-request-id — идентификатор запроса. Рекомендуем применять UUID. Пожалуйста, передайте этот идентификатор в службу технической поддержки
- x-log-request — флаг разрешающий сохранить данные переданные в запросе, true/false.
curl https://connecte.ai/api/v1/openai/whisper \
--request POST \
--header "Authorization: Bearer $CONNECTE_TOKEN" \
--header "x-request-id: 89ae1d22-9745-42d1-bb7b-12**********" \
--header "x-log-request: true" \
--header "Content-Type: application/json" \
--data '{
"audio" : "https://site.ru/audio.mp3"
}'
Синхронная обработка
Некоторые коды состояния могут возникать только при синхронном режиме выполнения.
Статус 202
Иногда вы можете столкнуться с кодом состояния 202 (Accepted). Код указывает, что запрос перешел в асинхронный режим из-за превышения времени ожидания синхронной обработки. Подробнее а режимах запроса можно прочитать здесь