Коды ошибок
Статья создана
Обновлена 20 ноября 2025 г.
В ответ на любой запрос модели 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 |
Превышен срок выполнения запроса | Проблемы в сети между клиентом и сервером. Попробуйте отправить запрос повторно или обратитесь в техническую поддержку |
| 7 | 403 | PERMISSION_DENIED |
Недостаточно прав | Проверьте наличие необходимых ролей у сервисного аккаунта, от имени которого вы делаете запрос. Если доступ к выбранной вами модели предоставляется по запросу, убедитесь, что он предоставлен |
| 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-ключа. |