GigaChat API - это программный интерфейс, через который компании и разработчики подключают нейросеть Сбера к своим сервисам: чат-ботам, CRM, 1С, порталам. Чтобы начать, нужно создать проект в личном кабинете разработчика, получить ключ авторизации, обменять его на токен доступа и отправить запрос к модели. Физлицам дают бесплатно 365 млн токенов на год, компании платят по тарифу: от 0,065 рубля за 1000 токенов для GigaChat 2 Lite до 0,65 рубля для GigaChat 2 Max.
За 2026 год в API многое поменялось: новый адрес, новые тарифы, оплата через cloud.ru для новых клиентов. Многие инструкции в интернете устарели, поэтому ниже собрали актуальную картину на ноябрь 2026 года: модели и цены, калькулятор стоимости, получение ключа и первый запрос, сертификаты, ошибки, лимиты и сравнение с YandexGPT. Если нужен готовый ассистент на GigaChat по вашим документам и данным, посмотрите, как мы делаем ИИ-ассистентов для бизнеса.
Подключим GigaChat к вашим процессам
Оставьте заявку - на бесплатной диагностике подберем модель под задачу, посчитаем стоимость и соберем прототип на ваших данных до договора.
Что изменилось в GigaChat API в 2026 году
Если вы подключались к GigaChat раньше или пользуетесь старой инструкцией, проверьте четыре изменения. Они влияют и на код, и на то, как компания платит за модель.
- Новые тарифы действуют со 2 февраля 2026 года, цены ниже приведены по ним.
- Новый адрес API. С 17 июля 2026 года для всех новых подключений используется https://api.giga.chat. Старый адрес gigachat.devices.sberbank.ru пока работает у тех, кто подключился раньше, но его выведут из эксплуатации.
- Оплата через cloud.ru. С 1 сентября 2026 года новые клиенты и те, кто раньше не покупал пакеты, оплачивают модели через облако cloud.ru. Купить пакет напрямую у Сбера могут только действующие клиенты.
- Метод v2. С 6 октября 2026 года есть новый метод с параллельным вызовом функций, пока только для GigaChat 3 Ultra.
Адрес сервиса авторизации, где получают токен, не изменился. Меняется только адрес, на который отправляют запросы к модели.
Модели GigaChat, доступные через API
Для компаний в API доступны три модели второго поколения и модели для эмбеддингов, то есть для превращения текста в числа при поиске по документам. Все текстовые модели принимают до 128 000 токенов контекста и умеют вызывать функции, а старшие работают и с изображениями и аудио.
| Модель | Для каких задач | Что принимает | Цена для юрлиц за 1000 токенов |
|---|---|---|---|
| GigaChat 2 Lite | Простые ответы, классификация, короткие тексты, большой поток запросов | Текст | 0,065 ₽ |
| GigaChat 2 Pro | Работа с документами, ассистенты, большинство бизнес-задач | Текст, изображения, аудио | 0,5 ₽ |
| GigaChat 2 Max | Сложные рассуждения, агенты, анализ длинных документов | Текст, изображения, аудио | 0,65 ₽ |
| Embeddings | Поиск по базе знаний и документам | Текст | 0,014 ₽ |
Модель GigaChat 3 Ultra в API на ноябрь 2026 года доступна только физлицам в бесплатном тарифе: на странице модели прямо сказано, что у платных тарифов доступа к ней пока нет. Компании могут работать с моделями поколения 3.5 через каталог моделей cloud.ru.
Тарифы GigaChat API для юрлиц и физлиц
Сбер считает расход в токенах: в оплату идут и вопрос, и ответ, включая системные инструкции. Один токен в русском тексте - это в среднем 3-4 символа. Что такое токены и как они считаются, мы подробно разбирали в статье про токены в нейросети.
Юрлица и ИП платят двумя способами. При оплате по факту (pay-as-you-go) цена считается за каждые 1000 токенов, а счет и УПД приходят в конце месяца. Минимальный платеж - 600 рублей в месяц с НДС, но только если сервисом пользовались. Асинхронные запросы, когда ответ можно подождать, стоят вдвое дешевле.
| Модель | Синхронно, за 1000 токенов | Асинхронно, за 1000 токенов | Пакет |
|---|---|---|---|
| GigaChat 2 Lite | 0,065 ₽ | 0,0325 ₽ | 300 млн токенов за 19 500 ₽ |
| GigaChat 2 Pro | 0,5 ₽ | 0,25 ₽ | 50 млн токенов за 25 000 ₽ |
| GigaChat 2 Max | 0,65 ₽ | 0,325 ₽ | 30 млн токенов за 19 500 ₽ |
| Embeddings | 0,014 ₽ | 0,007 ₽ | 1 млрд токенов за 14 000 ₽ |
Минимальный платеж важно учитывать на старте. В документации Сбера есть пример: компания израсходовала на Lite 876 835 токенов, по тарифу это около 57 рублей, но к оплате выйдет 600 рублей.
Физлица получают бесплатный тариф Freemium на 12 месяцев: всего 365 млн токенов, из них 250 млн на Lite, 40 млн на Pro, 25 млн на Max и 50 млн на GigaChat 3 Ultra. Запросы обрабатываются в один поток. Когда лимит закончится, можно купить пакет на месяц: 20 млн токенов Lite стоят 1 300 рублей, 3 млн токенов Pro - 1 500 рублей, 3 млн токенов Max - 1 950 рублей. Для компании бесплатный лимит на странице тарифов не указан.
Калькулятор стоимости GigaChat API
Чтобы прикинуть бюджет, умножьте число запросов на средний размер запроса с ответом. Например, ассистент поддержки обрабатывает 500 обращений в день, и на каждое вместе с инструкциями и найденными фрагментами базы знаний уходит 2 000 токенов. За месяц это 30 млн токенов: около 1 950 рублей на Lite, 15 000 рублей на Pro и 19 500 рублей на Max. Подставьте свои цифры.
Расчет сделан для синхронных запросов. Если ответы не нужны сразу, например при ночной обработке документов, асинхронный режим сократит сумму вдвое.
Как сократить расходы на GigaChat API
Счет за API зависит от трех вещей: какая модель отвечает, сколько токенов уходит на запрос и нужен ли ответ сразу. На каждой можно сэкономить, не теряя в качестве.
Начните с разделения задач по моделям. Классификацию обращений, извлечение реквизитов и короткие ответы по шаблону обычно тянет Lite, а Max нужен для рассуждений и длинных документов. Разница в цене десятикратная, поэтому даже частичный перенос потока на Lite заметно снижает счет. Дальше следите за размером запроса. Системная инструкция на две страницы и вся история переписки в каждом запросе быстро съедают бюджет. Точное число токенов до отправки показывает метод подсчета токенов в API.
Асинхронный режим подходит для всего, что может подождать: ночная обработка документов, разметка архива, подготовка отчетов. Он стоит вдвое дешевле. Остается выбор между пакетом и оплатой по факту. Если сравнить цены, 1000 токенов в пакете стоят столько же, сколько при оплате по факту: 30 млн токенов Max за 19 500 рублей - те же 0,65 рубля. Пакет удобен для планирования бюджета и предоплаты, а оплата по факту - когда объем пока непредсказуем.
Функции и эмбеддинги в GigaChat API
Для ассистентов и агентов важны две возможности API. Первая - вызов функций. Вы описываете функции своей системы, например «найти заказ по номеру» или «создать заявку», а модель сама решает, когда их вызвать, и заполняет параметры. Ваш код выполняет функцию и возвращает результат модели, а она формулирует ответ. Так GigaChat подключают к CRM, 1С и внутренним сервисам. С октября 2026 года в методе v2 модель может вызывать несколько функций одновременно, пока только GigaChat 3 Ultra.
Вторая - эмбеддинги. Они превращают текст в набор чисел так, что близкие по смыслу фрагменты получают близкие числа. На этом строится поиск по базе знаний: документы заранее разбивают на фрагменты и считают для них эмбеддинги, а при вопросе сотрудника находят самые подходящие фрагменты и передают модели вместе с вопросом. Эмбеддинги стоят 0,014 рубля за 1000 токенов: архив документов на 50 млн токенов обработается примерно за 700 рублей. Если модели не хватает знаний, обычно достаточно такого поиска, а если нужен особый стиль или формат ответов, модель дообучают на примерах компании - когда это оправдано, мы разбирали в статье про дообучение LLM.
Как получить ключ GigaChat API
Ключ получают в личном кабинете разработчика Сбера (Studio). Порядок зависит от того, кто подключается и как будет платить.
- Войдите в Studio на developers.sber.ru через Сбер ID и создайте пространство. Физлицу хватает личного пространства, компании на пакетах нужно пространство «Корпоративное», для оплаты по факту - «Корпоративное Плюс».
- Создайте проект. Физлицо выбирает GigaChat API, компания на пакетах - GigaChat API Business. Для оплаты по факту в блоке GigaChat API Enterprise нажимают «Запросить доступ», заполняют заявку и подписывают договор через ЭДО, менеджер связывается в течение двух рабочих дней.
- Получите ключ. В настройках API нажмите «Получить ключ» и сохраните ключ авторизации, Client ID и Client Secret. Ключ авторизации и Client Secret показываются один раз, в кабинете они не хранятся.
Генерировать ключи в компании могут только пользователи с ролями Owner и Administrator. Если ключ утек, выпустите новый: старый может работать еще до 250 минут после перевыпуска.
Как подключить GigaChat API: токен и первый запрос
Ключ авторизации сам по себе не дает доступа к модели. Сначала его обменивают на токен доступа, который живет 30 минут, а уже с токеном отправляют запросы. В запросе за токеном передают ключ, идентификатор запроса RqUID (случайный uuid) и область доступа: GIGACHAT_API_PERS для физлиц, GIGACHAT_API_B2B для компаний на пакетах и GIGACHAT_API_CORP для оплаты по факту.
curl -X POST https://ngw.devices.sberbank.ru:9443/api/v2/oauth \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'Accept: application/json' \
-H 'RqUID: <случайный uuid4>' \
-H 'Authorization: Basic <ключ авторизации>' \
--data-urlencode 'scope=GIGACHAT_API_PERS'В ответе придет токен. Его передают в заголовке Authorization: Bearer в запросах к модели на адрес api.giga.chat. Токен нужно обновлять каждые 30 минут, поэтому вручную так работают только при проверке. В рабочих проектах удобнее официальная библиотека для Python, которая сама получает и обновляет токен:
from gigachat import GigaChat
with GigaChat(
credentials='<ключ авторизации>',
scope='GIGACHAT_API_PERS',
model='GigaChat-2-Max',
ca_bundle_file='russian_trusted_root_ca.cer',
) as giga:
response = giga.chat('Объясни, что такое токен, в двух предложениях')
print(response.choices[0].message.content)Кроме Python, есть официальные библиотеки для JavaScript и Java и пакет langchain-gigachat для LangChain и LangGraph. API частично совместим с форматом OpenAI, но с оговорками: вместо постоянного ключа все равно нужен токен на 30 минут, а часть параметров не поддерживается.
Сертификаты Минцифры и ошибка SSL
Самая частая проблема при первом запросе - ошибка SSL: CERTIFICATE_VERIFY_FAILED. Она означает, что на компьютере или сервере не установлены корневые сертификаты Национального удостоверяющего центра Минцифры, которыми подписан сервис. Сертификат скачивают на портале Госуслуг и подключают одним из способов: передают путь к файлу в библиотеку (параметр ca_bundle_file в Python), добавляют в переменную NODE_EXTRA_CA_CERTS в Node.js или устанавливают в систему.
В некоторых инструкциях советуют просто отключить проверку сертификатов. Документация Сбера прямо называет это небезопасным: так соединение становится уязвимым для подмены, а через него идут данные компании и ключ доступа.
Ошибки GigaChat API и что с ними делать
Ниже основные коды ошибок из документации и их частые причины. По ним обычно сразу понятно, что исправлять.
| Код | Что означает | Частая причина |
|---|---|---|
| 400 | Ошибка в параметрах запроса | Нет заголовка RqUID или неверный scope при получении токена |
| 401 | Ошибка авторизации | Неверный ключ или токен старше 30 минут |
| 402 | Требуется оплата | Закончились токены в пакете или бесплатном лимите |
| 403 | Нет доступа к ресурсу | Запрос баланса при оплате по факту, нет заголовка User-Agent |
| 413 | Слишком большой запрос | Текст длиннее контекста модели |
| 422 | Ошибка проверки параметров | Модель не поддерживает функции или системное сообщение стоит не первым |
| 429 | Слишком много запросов | Превышено число одновременных потоков |
| 500 | Внутренняя ошибка сервиса | Сбой на стороне Сбера, запрос стоит повторить позже |
Лимиты GigaChat API
В GigaChat API ограничено число одновременных потоков, лимита запросов в минуту в документации нет. У физлиц это один поток: пока модель отвечает на запрос, следующий ждет. У компаний по умолчанию 10 потоков, больше можно запросить письмом в поддержку. Токен доступа можно запрашивать до 10 раз в секунду.
Для чат-бота с десятком одновременных пользователей 10 потоков обычно хватает, если ответы короткие. Для массовой обработки документов лучше асинхронный режим: он дешевле и не упирается в лимит потоков так жестко.
GigaChat API или YandexGPT API: что выбрать
Для российской компании выбор обычно стоит между GigaChat и YandexGPT. Обе модели работают на серверах в России, умеют вызывать функции и доступны по договору. Различаются они ценой, способом авторизации и экосистемой.
| GigaChat API | YandexGPT API | |
|---|---|---|
| Цена старшей модели за 1000 токенов | Max - 0,65 ₽ | Pro 5.1 - 0,8 ₽ |
| Цена младшей модели | Lite - 0,065 ₽ | Lite - 0,2 ₽ |
| Асинхронный режим | Вдвое дешевле | Примерно вдвое дешевле |
| Авторизация | Ключ, затем токен на 30 минут, сертификаты Минцифры | Постоянный API-ключ сервисного аккаунта |
| Совместимость с OpenAI | Частичная | Есть OpenAI-совместимый API |
| Подключение внешних инструментов | Через GigaChain и адаптеры | MCP Hub в Yandex AI Studio |
| Открытые веса для своего контура | GigaChat 3 Lightning и GigaChat 3.5, лицензия MIT | Старшие модели работают только в облаке Яндекса |
На большом потоке простых задач GigaChat Lite заметно дешевле. YandexGPT проще в подключении и удобнее, если компания уже работает в Yandex Cloud. Качество ответов зависит от задачи, поэтому перед выбором стоит прогнать обе модели на 30-50 реальных примерах. Сравнение с другими моделями, доступными в России, есть в обзоре нейросетей для бизнеса.
GigaChat в своем контуре: открытые модели
Если данные нельзя отправлять даже в российское облако, GigaChat можно запустить на своих серверах. Сбер опубликовал веса моделей на Hugging Face с лицензией MIT, которая разрешает коммерческое использование. GigaChat 3 Lightning - модель на 10 млрд параметров, из которых при ответе работают 1,8 млрд, поэтому она запускается на одной видеокарте. GigaChat 3.5 на 432 млрд параметров с контекстом 262 тысячи токенов требует уже сервера с несколькими видеокартами.
Своя модель избавляет от оплаты токенов, но требует железа и людей, которые его обслуживают. Когда это выгоднее облака, мы посчитали в статье про локальную нейросеть. А если модель нужно подключить к данным 1С, пригодится разбор MCP-сервера для 1С.
Как Unistory подключает GigaChat к процессам компании
Подключить API - полдня работы программиста. Сделать так, чтобы модель полезно отвечала сотрудникам по документам компании и данным 1С и не нарушала требования к данным, - отдельный проект. Мы в Unistory берем его целиком: от выбора модели до запуска в отделе.
Какие задачи с GigaChat мы решаем:
- ассистенты, которые отвечают сотрудникам по регламентам, базе знаний и данным 1С со ссылкой на источник;
- агенты, которые выполняют задачи в 1С, CRM и почте с подтверждением сотрудника;
- выбор модели и режима оплаты: GigaChat, YandexGPT или открытая модель на ваших серверах, расчет стоимости на вашем потоке;
- обезличивание персональных данных перед отправкой в облако и запуск в закрытом контуре, когда облако не подходит.
Как устроен проект:
- На бесплатной диагностике на 30-60 минут разбираем задачу, данные и требования безопасности.
- До договора собираем прототип на ваших данных и сравниваем модели на реальных вопросах сотрудников.
- Настраиваем доступы, интеграции и журнал, подключаем мессенджер или портал.
- Запускаем на одном отделе и расширяем, когда результат подтвержден.
Unistory - технологический партнер Yandex AI Studio и участник ассоциации АЛРИИ. Один из наших проектов с ответами по данным компании - чат-бот для инженеров по ремонту банкоматов: его запустили за месяц, а нагрузка на операторов колл-центра снизилась на 80%.
Покажем GigaChat на ваших данных
Оставьте заявку - разберем задачу, сравним модели на ваших примерах и посчитаем, сколько будет стоить решение в месяц.
Заключение
Подключить GigaChat API несложно: проект в Studio, ключ, токен на 30 минут, сертификаты Минцифры и первый запрос на новый адрес api.giga.chat. Сложнее выбрать модель и посчитать бюджет: Lite в десять раз дешевле Max, асинхронный режим вдвое дешевле синхронного, а у новых клиентов оплата идет через cloud.ru. Перед выбором между GigaChat, YandexGPT и своей моделью проверьте их на реальных задачах.
Частые вопросы
Как получить ключ GigaChat API?
Войдите в Studio на developers.sber.ru, создайте проект GigaChat API (для компании - GigaChat API Business или Enterprise), в настройках API нажмите «Получить ключ» и сохраните ключ авторизации, Client ID и Client Secret. Ключ показывается один раз.
Можно ли пользоваться GigaChat API бесплатно?
Да, физлицам. Тариф Freemium дает 365 млн токенов на 12 месяцев, запросы обрабатываются в один поток. Для компаний бесплатный лимит на странице тарифов не указан.
Сколько стоит GigaChat API для юрлиц?
При оплате по факту 1000 токенов стоят 0,065 рубля на Lite, 0,5 рубля на Pro и 0,65 рубля на Max с НДС, асинхронные запросы вдвое дешевле. Минимальный платеж - 600 рублей в месяц, если сервисом пользовались. Есть и пакеты, например 30 млн токенов Max за 19 500 рублей.
Где найти документацию GigaChat API?
Официальная документация находится на developers.sber.ru в разделе GigaChat API: авторизация, справочник методов, тарифы, ошибки и примеры. С июня 2026 года ее можно подключить к среде разработки через MCP-сервер документации.
Как подключить GigaChat API на Python?
Установите официальную библиотеку командой pip install gigachat, передайте ей ключ авторизации, область доступа и путь к сертификату Минцифры. Библиотека сама получает и обновляет токен.
Почему GigaChat API возвращает ошибку 401?
Чаще всего истек токен доступа: он живет 30 минут. Получите новый токен или используйте библиотеку, которая обновляет его автоматически. Вторая причина - неверный ключ авторизации или область доступа.
Как исправить ошибку SSL CERTIFICATE_VERIFY_FAILED в GigaChat?
Установите корневой сертификат Национального удостоверяющего центра Минцифры с портала Госуслуг и укажите путь к нему в библиотеке или установите его в систему. Отключать проверку сертификатов небезопасно.
Какие лимиты у GigaChat API?
Лимит считается по одновременным потокам: у физлиц один, у компаний по умолчанию 10, больше можно запросить через поддержку. При превышении API возвращает ошибку 429.
Совместим ли GigaChat API с OpenAI?
Частично. Можно использовать формат запросов OpenAI с адресом api.giga.chat, но авторизация остается через токен на 30 минут, а часть параметров не поддерживается. Для старого кода есть прокси gpt2giga.
Что выбрать для бизнеса: GigaChat API или YandexGPT API?
GigaChat дешевле, особенно младшая модель, и имеет открытые веса для своего контура. YandexGPT проще подключить и удобнее в экосистеме Yandex Cloud. Выбирать стоит по результатам проверки обеих моделей на ваших реальных задачах.
