ym88659208ym87991671
Ошибки REST API | Документация для разработчиков

Ошибки REST API

Обновлено 31 марта 2025

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

Ошибка в параметрах запроса

Возможные причины возникновения ошибки при получении токена доступа:

Проблема
Решение

Не задан заголовок RqUID или форма заголовка не соответствует uuid4.

Добавьте в запрос заголовок RqUID с произвольным идентификатором запроса в формате uuid4.


В поле scope не указана версия API, к которой выполняется запрос:

  {
"code": 5,
"message": "scope is empty"
}

Укажите версию API, к которой выполняется запрос:

GIGACHAT_API_PERS — доступ для физических лиц.

GIGACHAT_API_B2B — доступ для ИП и юридических лиц по предоплате.

GIGACHAT_API_CORP — доступ для ИП и юридических лиц по постоплате.


Ключ авторизации не соответствует версии API, которая указана в поле scope или не указана версия API:

  {
"code": 7,
"message": "scope from db not fully includes consumed scope"
}

Укажите корректную версию API. Версия API отображается в личном кабинете.

GigaChain по умолчанию работает с версией API для физических лиц — GIGACHAT_API_PERS.

Для использования другой версии API явно укажите ее в параметре scope при инициализации объекта GigaChat:

  llm = GigaChat(
credentials="ключ_авторизации",
scope="GIGACHAT_API_B2B",
model="GigaChat-Pro",
)

Поле scope содержит невалидные данные:

  {
"code": 1,
"message": "scope data format invalid"
}

Возможно, версия API указана с ошибкой. Проверьте значение поля scope и попробуйте еще раз.

Если ошибка возникает при отправке других POST-запросов, то тело ошибки будет содержать название параметра, который привел к ошибке:

{
"status": 400,
"message": "Id must not be empty"
}

Контакты

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

ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей. Вы можете запретить сохранение cookie в настройках своего браузера.