Кому нужен API
Обычному пользователю API не нужен — чат на giga.chat бесплатный. API берут разработчики: чтобы встроить GigaChat в бота, сайт, 1С, свою программу или подключить к инструментам для программирования.
Для физических лиц Сбер даёт бесплатный режим Freemium с годовой квотой токенов и продаёт пакеты токенов на месяц. Размеры квоты и цены пакетов меняются — актуальные цифры смотрите на странице тарифов для физлиц в документации developers.sber.ru.
Как получить ключ
Зарегистрируйтесь на developers.sber.ru
Вход — через Сбер ID. Для физлица работа ведётся в личном пространстве Studio.
Создайте проект GigaChat API
В проекте появятся Client ID и раздел настроек API.
Сгенерируйте ключ авторизации
Скопируйте его сразу и сохраните: ключ показывается один раз и в личном кабинете не хранится.
Проверьте квоту
В проекте видно, сколько токенов осталось в бесплатном режиме и в купленных пакетах.
Как устроена авторизация
Ключом авторизации напрямую чат не вызывают. Сначала им получают токен доступа: запрос к сервису авторизации с указанием области доступа. Для физлиц это GIGACHAT_API_PERS, у бизнеса — GIGACHAT_API_B2B или GIGACHAT_API_CORP.
Токен живёт 30 минут, потом его нужно получить заново. Официальные библиотеки — gigachat для Python и одноимённый пакет в npm — делают это сами: передаёте ключ и область, дальше пишете обычные запросы к модели.
Частые ошибки первого запроса
- ошибка сертификата — серверы GigaChat используют сертификат российского удостоверяющего центра; установите корневой сертификат Минцифры или укажите его в настройках библиотеки
- 401 — истёк токен доступа или перепутаны ключ и Client ID
- неверная область доступа — физлицу нужна GIGACHAT_API_PERS
- 429 или медленные ответы — у физлиц один поток генерации, параллельные запросы встают в очередь
- ключ потерян — сгенерируйте новый в настройках проекта
Первый запрос по шагам
Порядок всегда одинаковый: получаете токен доступа по ключу авторизации, затем отправляете сообщение в метод чата с этим токеном в заголовке, указываете модель и список сообщений. Ответ приходит в JSON — текст модели лежит в поле с сообщением ассистента.
Проще всего начать с официальной библиотеки: установили пакет gigachat, передали ключ, область доступа и путь к сертификату — и вызвали метод чата. Готовый пример кода есть в описании библиотеки на GitHub в организации ai-forever.
Подключение к инструментам для кода
Многие инструменты — редакторы с ИИ, консольные агенты вроде OpenCode — ждут API в формате OpenAI. У GigaChat свой протокол, поэтому напрямую такое подключение обычно не работает. Выход — прокси-адаптер, который переводит запросы OpenAI в формат GigaChat, например открытый проект gpt2giga.
Схема такая: запускаете прокси с вашим ключом, а в инструменте указываете адрес прокси как адрес API. Перед подключением проверьте, поддерживает ли инструмент вызов функций и какой контекст ему нужен — от этого зависит, насколько хорошо заработает связка.
Открытые веса как альтернатива API
С июля 2026 года модель GigaChat 3.5 Ultra доступна с открытыми весами под лицензией MIT. Это вариант для компаний со своими серверами: модель можно развернуть у себя без оплаты токенов. Для домашнего компьютера она слишком велика.
Когда быстрее через ИИ-агента
Если API вам нужен ради одной задачи — обработать пачку текстов, сделать таблицу, собрать отчёт, — быстрее поставить её ИИ-агенту LeanTech: без ключей, токенов и сертификатов, с выбором модели и результатом файлом. Работает из России без VPN.
Чего агент не делает: не встраивается в СберБанк Онлайн, Telegram или колонки «Салют», не работает внутри чужих программ и не ставит софт. Модели GigaChat внутри агента нет — там ChatGPT, Claude, DeepSeek, Gemini и другие. Видео агент делает только на тарифах Pro и Power.