Коды ошибок

В ответ на любой запрос модели AI Studio возвращают сообщение, содержащее код и статус обработки запроса. Если при обработке запроса произошла ошибка, сообщение также будет содержать возможную причину ее возникновения.

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

gRPC REST Статус Причина Решение
0 200 OK Операция выполнена —
3 400 INVALID_ARGUMENT Некорректный запрос Проверьте формат запроса. Возможно, указан неправильный URI модели, превышена длина промпта, задано недопустимое значение параметра или нарушены этические ограничения YandexART.
Например, для решения ошибок invalid model_uri, Failed to parse model URI проверьте, правильно ли введен URI модели и указан ли идентификатор каталога.
Ошибка вида Specified folder ID does not match with service account означает, что неправильно указан идентификатор каталога или у сервисного аккаунта, от которого вы отправляете запрос, нет доступа к указанному каталогу — проверьте, от имени какого аккаунта вы отправляете запрос.
4 504 DEADLINE_EXCEEDED Превышен срок выполнения запроса Проблемы в сети между клиентом и сервером либо превышен таймаут ожидания ответа. Попробуйте отправить запрос повторно. При использовании AI SDK увеличьте таймаут с помощью метода config.run(timeout). Если проблема сохраняется, обратитесь в техническую поддержку.
7 403 PERMISSION_DENIED Недостаточно прав Проверьте:
  • наличие необходимых ролей у сервисного аккаунта, от имени которого вы делаете запрос;
  • предоставлен ли доступ к модели, если он предоставляется по запросу;
  • привязан ли платежный аккаунт к облаку и не находится ли оно в статусе CREATING.
8 429 RESOURCE_EXHAUSTED Превышена квота В зависимости от квоты, подождите или обратитесь в техническую поддержку, чтобы увеличить квоту. При запросе увеличить квоту укажите модель, режим работы и название квоты, которую необходимо увеличить. Специалисты технической поддержки могут попросить дополнительную информацию.
12 501 UNIMPLEMENTED Проблема на стороне сервиса Обратитесь в техническую поддержку.
13 500 INTERNAL Внутренняя ошибка сервиса Обратитесь в техническую поддержку.
14 503 UNAVAILABLE Сервис недоступен Попробуйте отправить запрос повторно или обратитесь в техническую поддержку.
16 401 UNAUTHENTICATED Ошибка авторизации Проверьте, от имени какого аккаунта вы отправляете запрос, правильно ли указан API-ключ или IAM-токен, и не истек ли срок действия токена. Сообщения ошибок могут содержать информацию об ошибке, например: Unknown api key — неправильно указан API-ключ или его область действия, The apikey has expired — истек срок действия API-ключа.
Предыдущая
Вопросы и ответы
Следующая
Заголовки для диагностики ошибок