Гайд
GigaChat API: как подключить и сколько это стоит
GigaChat API - это программный доступ к нейросети Сбера: ваш бот, CRM или 1С отправляет запрос и получает ответ модели. Ниже - как получить ключ в личном кабинете, какой scope выбрать физлицу и юрлицу, как сделать первый запрос и как заранее посчитать месячный расход на типовые задачи.
Обновлено 29.09.2026
Коротко
- Доступ к GigaChat API оформляется в личном кабинете разработчика Сбера: создаете проект и получаете ключ авторизации.
- Физлица работают со scope GIGACHAT_API_PERS, юрлица и ИП - с GIGACHAT_API_B2B при предоплате или GIGACHAT_API_CORP при постоплате.
- Ключ авторизации обменивается на токен доступа, который живет 30 минут. Запросы к модели идут с этим токеном.
- Платите вы за токены. Расход зависит от длины инструкции, контекста и ответа, а не от числа запросов.
- Цены за токены смотрите в тарифах поставщика. Ниже - формула и расчет объема токенов для бота, базы знаний и документов.
Как получить ключ GigaChat API: пошагово
Порядок на дату публикации. Интерфейс кабинета иногда меняется, но логика остается той же.
Шаг 1. Войдите в личный кабинет разработчика
Кабинет находится на портале developers.sber.ru, раздел Studio. Физлицо входит через Сбер ID. Юрлицу или ИП нужна регистрация организации и договор на использование API.
Шаг 2. Создайте проект GigaChat API
В кабинете выберите создание проекта и тип GigaChat API. Проект - это контейнер для ключей, лимитов и статистики расхода.
Шаг 3. Получите ключ авторизации
В настройках проекта сгенерируйте Authorization key. Он строится из Client ID и Client Secret. Сохраните ключ сразу: повторно кабинет его не покажет, придется выпускать новый.
Шаг 4. Установите сертификат
Серверы GigaChat используют сертификаты Национального удостоверяющего центра Минцифры. Если корневой сертификат не установлен, программа выдаст ошибку SSL. Отключать проверку сертификата в рабочем проекте не стоит.
Шаг 5. Получите токен доступа
Программа отправляет ключ авторизации на адрес авторизации (ngw.devices.sberbank.ru, путь /api/v2/oauth) с нужным scope и идентификатором запроса RqUID в формате UUID. В ответ приходит access token. Он действует 30 минут, после этого его запрашивают заново.
Scope, модели и адреса GigaChat API
Scope определяет, по какому договору и тарифу идут запросы. Перепутанный scope - частая причина ошибки авторизации.
| Scope | Для кого | Как оплачивается |
|---|---|---|
| GIGACHAT_API_PERS | Физические лица | Бесплатный лимит и платные пакеты токенов |
| GIGACHAT_API_B2B | Юрлица и ИП | Предоплата пакетами токенов |
| GIGACHAT_API_CORP | Юрлица и ИП | Постоплата по фактическому расходу |
Запросы к модели отправляются на gigachat.devices.sberbank.ru с путем /api/v1. Основные методы:
- /chat/completions - диалог с моделью, основной метод для ботов и агентов;
- /models - список доступных моделей на текущий момент;
- /embeddings - векторы для поиска по смыслу в базе знаний;
- /tokens/count - подсчет токенов в тексте до отправки запроса.
В линейке несколько моделей: облегченная для простых задач и более сильные Pro и Max для сложных рассуждений и длинных документов. Названия и версии обновляются, поэтому актуальный список берите из метода /models, а не из старых статей.
Первый запрос к GigaChat API на Python
Самый короткий путь - официальная библиотека gigachat для Python. Она сама получает и обновляет токен. Установка: pip install gigachat.
from gigachat import GigaChat
giga = GigaChat(credentials="ВАШ_КЛЮЧ_АВТОРИЗАЦИИ", scope="GIGACHAT_API_B2B", model="GigaChat")
response = giga.chat("Составь ответ клиенту, который спрашивает про сроки доставки в Казань")
print(response.choices[0].message.content)
Что проверить, если запрос не проходит:
- Ошибка SSL - не установлен корневой сертификат Минцифры.
- 401 при авторизации - неверный ключ или scope не совпадает с типом аккаунта.
- 401 при запросе к модели - истек токен доступа, нужно получить новый.
- Ответ про лимит - закончился пакет токенов или превышено число одновременных запросов.
Для связки с другими инструментами есть интеграция с LangChain. Во многих конструкторах автоматизации GigaChat подключается через HTTP-запрос. Что вообще такое API нейросети и чем он отличается от подписки, разобрано в словаре.
Сколько стоит GigaChat API для юрлица: расчет типовых задач в месяц
Цены за токены зависят от модели и способа оплаты. Смотрите их в тарифах поставщика. Мы покажем, как посчитать объем токенов, а стоимость получится умножением на цену из тарифа.
Стоимость в месяц = токены в месяц / 1 000 000 × цена за миллион токенов выбранной модели
Токены считаются на вход и на выход. Во вход попадают инструкция, история диалога и фрагменты базы. Это часто больше самого вопроса. Что такое токен и как его считать, объясняет статья токены в нейросети.
| Задача | Условный объем | Токенов на операцию | Токенов в месяц |
|---|---|---|---|
| ИИ-бот для клиентов | 1 500 диалогов по 6 сообщений | около 12 000 на диалог | около 18 млн |
| База знаний для сотрудников | 40 человек по 8 вопросов в рабочий день | около 3 000 на вопрос | около 21 млн |
| Разбор документов после распознавания | 800 счетов | около 2 000 на счет | около 1,6 млн |
| Сводка по звонкам | 1 000 звонков по 5 минут | около 2 500 на звонок | около 2,5 млн |
Это ориентиры для прикидки, а не замер. Точная цифра зависит от длины вашей инструкции и ответов. Проверьте на 50-100 реальных запросах через метод /tokens/count или статистику проекта.
Как снизить расход
- Простые задачи отдавайте облегченной модели, сложные - Pro или Max.
- Сокращайте инструкцию: лишние абзацы оплачиваются в каждом запросе.
- В базе знаний передавайте модели 3-5 найденных фрагментов, а не весь документ.
- Обрезайте историю длинного диалога до последних сообщений и краткой сводки.
Как подключить GigaChat API к боту, CRM или 1С
API сам по себе ничего не делает: нужна программа, которая принимает сообщение клиента или документ, отправляет запрос и кладет результат куда надо. Типовые схемы:
- Бот в мессенджере. Сообщение из Telegram или MAX уходит в GigaChat вместе с фрагментами вашей базы, ответ возвращается клиенту, заявка - в CRM.
- Агент в CRM. Новое письмо или сделка запускает сценарий: модель разбирает текст и заполняет поля, ставит задачу менеджеру.
- Связка с 1С. Модель разбирает документ или вопрос сотрудника, а обмен с 1С идет через ее интерфейсы. Возможность подключения конкретной конфигурации проверяем до старта.
GigaChat - российский сервис, поэтому его часто выбирают для задач с персональными данными. Согласие клиентов и порядок обработки данных по 152-ФЗ при этом остаются на вашей стороне. Как GigaChat выглядит на фоне YandexGPT, показано в сравнении GigaChat, YandexGPT или ChatGPT, а настройка API Яндекса - в статье YandexGPT API.
Когда подключать самим, а когда заказать
Прежде чем выбирать путь, ответьте на три вопроса: кто будет следить за ключами и лимитами, что делать, если модель ответила неверно, и где хранится история запросов.
Самостоятельно стоит подключать, если у вас есть разработчик и задача ограничена: сгенерировать описания, ответить на вопрос, сделать сводку. С официальной библиотекой первый рабочий запрос обычно делают за день.
Заказать проще, когда нужна вся цепочка: база знаний, проверка ответов, интеграция с CRM или 1С, журнал действий и обработка ошибок. Мы собираем такие решения на GigaChat и других моделях. Пилот ИИ-агента на одном процессе стоит 24 900 ₽, оплата модели идет по тарифам поставщика напрямую с вашего аккаунта. О внедрении GigaChat в компании подробнее на странице GigaChat для бизнеса.