Описание ошибок

Обновлено 16 апреля 2026

На этой странице вы найдете краткое описание ошибок API GigaChat, примеры и причины их возникновения, а также возможные способы решения.

REST API

Требуется оплатить сервис

Проблема

Решение

Закончились токены модели, к которой выполняется запрос.

{
    "status": 402,
    "message": "Payment Required"
}

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

После этого пополните баланс в личном кабинете.

Нет доступа к запрашиваемому ресурсу

Проблема

Решение

Ошибка возникает при отправке запроса GET /balance, если вы оплачиваете работу с API по схеме pay-as-you-go.

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

Пример:

{
    "status": 403,
    "message": "Permission denied"
}

Превышен максимальный размер входных данных

Проблема

Решение

Превышен максимальный размер входных данных.

Пример:

{
    "status": 413,
    "message": "Payload too large"
}

Для решения проблемы уменьшите размер промпта. Количество токенов в промпте должно быть меньше размера окна контекста модели. Оценить количество токенов в промпте можно с помощью запроса POST /tokens/count.

Ошибка валидации параметров запроса

Проблема

Решение

Модель не поддерживает пользовательские функции. Ошибка может возникнуть при вызове пользовательских функций.

{
    "status": 422,
    "message": "Requested model does not support functions"
}

Для решения проблемы — обратитесь на почту.

---

Некорректный порядок сообщений.

Ошибка может возникнуть при использовании более одного системного промпта, или если системный промпт не в начале списка сообщений.

{
    "status": 422,
    "message": "Invalid params: system message must be the first message"
}

Перед отправкой запроса проверьте порядок сообщений, названия полей и значения параметров.

---

Содержимое текстового файла, переданного в поле attachments, превышает размер контекста модели.

{
    "status": 422,
    "message": "Unprocessable Entity for url: <...>/chat/completions"
}

Разделите или сократите текст в файле.

Слишком много запросов

Проблема

Решение

Выполнено слишком много запросов.

Пример:

{
    "status": 429,
    "message": "Too Many Requests"
}

Количество выполняемых одновременных запросов не соответствует вашему client_id. По умолчанию физическим лицам доступен один одновременный поток, а ИП и юридическим лицам — 10.

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

Проблема

Решение

Произошла ошибка сервиса.

Пример:

{
    "status": 500,
    "message": "Internal Server Error"
}

Обратитесь в службу поддержки.

gRPC API

На этой странице вы найдете краткое описание ошибок gRPC API GigaChat.

Код ошибки gRPC	Аналогичный HTTP-код	Описание
3	400, 413, 422	Ошибка в параметрах запроса
4	408	Истекло время ожидания
5	404	Запрошенный ресурс не найден. Например, допущена ошибка в названии модели
7	403	Ошибка авторизации
8	402, 429	Закончились токены модели, к которой выполняется запрос
13	500 или любой другой код	Внутренняя ошибка сервиса

Подробнее о кодах состояния gRPC — в официальной документации .

Контакты

Если проблема сохраняется, обратитесь в поддержку по электронной почте.