Запрос «GigaChat официальный сайт» в поисковике выдает два разных адреса: обычный чат для работы в браузере и портал для разработчиков с личным кабинетом Studio. Для подключения по API подходит только второй, и путаница на этом шаге стоит времени: ключ авторизации для кода выдается не в приложении Сбербанк Онлайн и не в самом чат-боте, а именно в кабинете разработчика на developers.sber.ru. Открыв не ту страницу, разработчик теряет время на поиск кнопки входа там, где ее просто нет.
Дальше начинается вторая путаница: ключ авторизации и access token, это не одно и то же. Ключ создается один раз в кабинете и показывается там же единожды, его меняют на токен отдельным запросом, и токен живет всего 30 минут. Без этой механики первый тестовый запрос почти гарантированно вернет ошибку авторизации, даже если ключ скопирован верно.
С 1 сентября 2026 года тарифы на токены GigaChat API пересчитаны, а часть новых пользователей оплачивает пакеты не напрямую в кабинете, а через отдельную облачную площадку. Ниже, по порядку: где регистрироваться, как получить ключ и токен, и сколько стоит генерация текста после бесплатного лимита.
GigaChat официальный сайт: Studio и документация для разработчиков
Официальный сайт GigaChat для API-доступа состоит из двух частей. Первая, developers.sber.ru, это документация: описание моделей, эндпоинтов, тарифов и примеров кода на Python, Java и JS. Вторая, личный кабинет Studio, это рабочий инструмент: там создают проекты, получают ключи и следят за расходом токенов. Обычный чат-интерфейс GigaChat, которым пользуются через браузер или приложение Сбербанк Онлайн, для разработки не нужен: у него нет ни ключей, ни статистики запросов.
Если вы ищете вход именно для кода, а не чат для переписки, открывайте кабинет Studio и входите через Сбер ID. Все дальнейшие шаги, от регистрации до получения токена, происходят в этом кабинете, а не на сайте документации. Документацию на developers.sber.ru стоит держать открытой отдельной вкладкой: там описаны параметры запросов и коды ошибок, которые пригодятся при первой отладке.
Как зарегистрироваться в личном кабинете Studio
Для физического лица доступны два способа входа: по Сбер ID и по электронной почте. Для ИП и юридических лиц дополнительно нужен СберБизнес ID, без него проект с корпоративными лимитами не создать.
- Откройте личный кабинет Studio и нажмите кнопку входа по номеру телефона.
- Введите номер телефона российского оператора и подтвердите вход push-уведомлением в приложении Сбербанк Онлайн или кодом из SMS.
- При первом входе примите условия использования Studio и политику обработки персональных данных.
- Для входа через email задайте пароль и подтвердите адрес письмом; для юрлица на этом шаге потребуется СберБизнес ID.
Регистрация занимает несколько минут, а Сбер ID после этого можно использовать повторно для других сервисов Сбера, не только для GigaChat. Если вход через телефон не подходит, например у корпоративного устройства ограничен прием SMS, используйте вариант с почтой: процесс займет чуть больше времени, но итоговый доступ к кабинету не отличается.
Создание проекта GigaChat API и получение ключа
Доступ к моделям дает не сам аккаунт, а отдельный проект внутри кабинета. Один аккаунт может держать несколько проектов, например для теста и для продакшена, с разными ключами и раздельной статистикой расхода токенов.
- В левом меню кабинета нажмите «Создать проект» и выберите раздел AI-моделей GigaChat API.
- Укажите название проекта и примите пользовательское соглашение.
- В настройках проекта откройте «Настройки API» и нажмите «Получить ключ».
- Сохраните ключ авторизации, Client ID и Client Secret: они показываются один раз и не хранятся в кабинете в открытом виде.
Ключ авторизации, это строка в формате Base64, собранная из Client ID и Client Secret. Создавать и пересоздавать его может только пользователь с ролью владельца или администратора проекта: это защита от того, что любой сотрудник с доступом к кабинету сможет выписать себе ключ без согласования. Для каждого проекта можно выпустить несколько ключей, если нужно развести доступ между тестовым и продуктовым окружением, но хранить их стоит в менеджере секретов, а не в коде репозитория.
Как обменять ключ на access token и сделать первый запрос
Ключ авторизации сам по себе запросы к модели не подписывает. Его меняют на access token через отдельный OAuth-эндпоинт, и уже этот токен передают в заголовке запроса к модели.
- Запрос POST на /api/v2/oauth отправляется по адресу ngw.devices.sberbank.ru:9443, ключ передается в заголовке Authorization по схеме Basic.
- В заголовке запроса обязателен RqUID, уникальный идентификатор в формате uuid4: без него сервер вернет ошибку авторизации.
- Токен действует 30 минут, после этого его нужно запросить заново; отправлять запросы на получение токена разрешено не чаще 10 раз в секунду.
- Сам запрос к модели уходит на api.giga.chat с токеном в заголовке Authorization по схеме Bearer.
На практике токен удобно запрашивать не перед каждым вызовом модели, а по таймеру: обновлять его с запасом до истечения срока действия и хранить в переменной окружения, чтобы не упереться в лимит обращений к эндпоинту авторизации.
Для физического лица в ответе от сервера в поле scope будет значение GIGACHAT_API_PERS: это признак того, что проект подключен к персональному тарифу, а не к корпоративному. Похожий принцип разделения ключа и токена действует и у других поставщиков моделей, например в процессе получения ключа в Google AI Studio, где ключ тоже отдельная сущность, а не пароль от личного кабинета.
Тарифы GigaChat API: freemium и платные пакеты
С 1 сентября 2026 года действует обновленная сетка тарифов для физических лиц. Freemium-режим подключается каждому новому проекту по умолчанию и дает 365 млн бесплатных токенов на 12 месяцев, но лимит разбит по моделям, а не общий.
| Модель | Бесплатный лимит на 12 месяцев |
|---|---|
| GigaChat / GigaChat 2 Lite | 250 млн токенов |
| GigaChat Pro / GigaChat 2 Pro | 40 млн токенов |
| GigaChat Max / GigaChat 2 Max | 25 млн токенов |
| GigaChat 3 Ultra | 50 млн токенов |
После исчерпания бесплатного лимита по конкретной модели подключаются платные пакеты на месяц, цены указаны с НДС.
| Пакет | Объем | Цена в месяц |
|---|---|---|
| GigaChat 2 Lite | 20 млн токенов | 1300 рублей |
| GigaChat 2 Pro | 3 млн токенов | 1500 рублей |
| GigaChat 2 Max | 3 млн токенов | 1950 рублей |
| Embeddings | 50 млн токенов | 700 рублей |
Важный нюанс: эти пакеты рассчитаны на действующих клиентов, которые уже покупали токены раньше. Новым пользователям с 1 сентября 2026 года оплата доступна через облачную площадку cloud.ru, а не напрямую в кабинете Studio: перед тем как планировать бюджет, стоит свериться с актуальным каталогом моделей именно там. Это разделение по сути меняет сам процесс покупки, а не только адрес страницы оплаты, поэтому перед запуском проекта стоит заранее выяснить, какой вариант оплаты актуален именно для вашего аккаунта.
Чем отличается доступ для физлица, ИП и юрлица
Тариф и способ оплаты, это не единственная разница. Физическому лицу по умолчанию доступен один поток запросов к модели, то есть запросы выполняются по очереди. ИП и юридическому лицу по умолчанию открыто десять потоков, что критично для бота с несколькими одновременными диалогами или для интеграции в CRM с пачками запросов. На практике это означает, что бот на одном потоке обрабатывает сообщения пользователей строго по очереди, и при одновременном наплыве запросов часть ответов будет приходить с задержкой.
Регистрация проекта для ИП и юрлица проходит по тому же сценарию через Studio, но входить нужно через СберБизнес ID, а не через личный Сбер ID. Это два разных аккаунта у Сбера, и один не заменяет другой.
Если на этом этапе непонятно, какая модель и какой тариф закроют задачу бизнеса, полезно заранее посмотреть, какие задачи закрывает GigaChat на практике, и сравнить его с YandexGPT, прежде чем покупать пакеты токенов.
Частые ошибки при подключении GigaChat API
Большая часть проблем на старте повторяется у разных пользователей.
- Путают ключ авторизации и access token, и пытаются отправить запрос к модели с ключом вместо токена.
- Не обновляют токен каждые 30 минут и получают ошибку авторизации в середине рабочей сессии.
- Создают ключ, но не сохраняют Client Secret, а потом не могут его восстановить, потому что кабинет показывает секрет только один раз.
- Регистрируются как физлицо, а потом пытаются получить корпоративные лимиты на том же аккаунте вместо отдельного входа через СберБизнес ID.
- Забывают заголовок RqUID в запросе на токен и получают ошибку авторизации вместо токена.
- Не проверяют код ответа сервера на этапе получения токена и считают, что токен выдан, хотя сервер вернул ошибку.
Частые вопросы
Сколько бесплатных токенов дает GigaChat API?
По тарифу, действующему с 1 сентября 2026 года, freemium-режим дает 365 млн бесплатных токенов на 12 месяцев суммарно по всем моделям: 250 млн для Lite, 40 млн для Pro, 25 млн для Max и 50 млн для Ultra. Лимит привязан к конкретной модели, поэтому если закончились бесплатные токены Pro, модель Lite в это время может оставаться бесплатной.
Сколько живет access token GigaChat?
Access token действует 30 минут с момента выдачи, после этого запрос к модели вернет ошибку авторизации. Получить новый токен можно тем же запросом к эндпоинту /api/v2/oauth, повторно передав ключ авторизации. Отправлять запросы на получение токена разрешено не чаще 10 раз в секунду, поэтому обновлять его стоит по таймеру, а не на каждый вызов модели.
Можно ли получить ключ GigaChat без привязки к Сбербанку?
Нет, вход в личный кабинет Studio проходит только через Сбер ID по номеру телефона, через email с подтверждением или через СберБизнес ID для юридических лиц и ИП. Отдельной регистрации без привязки к экосистеме Сбера официальный сайт не предусматривает, это требование платформы, а не временное ограничение.
Платно ли подключение GigaChat API для нового пользователя?
Для новых пользователей с 1 сентября 2026 года оплата пакетов токенов после окончания freemium-лимита проходит через облачную площадку cloud.ru, а не напрямую в кабинете Studio. Сам freemium-доступ и создание проекта остаются бесплатными и доступны сразу после регистрации, платить нужно только за объем токенов сверх бесплатного лимита.
Сколько потоков запросов доступно по умолчанию?
Физическому лицу по умолчанию доступен один поток запросов к модели, запросы обрабатываются последовательно. Индивидуальному предпринимателю и юридическому лицу по умолчанию открыто десять потоков, что позволяет обрабатывать несколько диалогов параллельно без очереди. Увеличение числа потоков для физлица официальный сайт не описывает как самостоятельную опцию.
С чего начать
- Зарегистрируйтесь в Studio по Сбер ID: физлицу достаточно номера телефона и SMS-кода.
- Создайте проект GigaChat API, примите соглашение и сгенерируйте ключ авторизации, сразу сохранив Client ID и Client Secret.
- Обменяйте ключ на access token через эндпоинт /api/v2/oauth и отправьте тестовый запрос к модели, не превышая бесплатный лимит.
- Для бизнеса сверьте тариф и число потоков с реальной нагрузкой, прежде чем переводить на GigaChat продуктовый чат-бот или обработку обращений.
Если разбираться с ключами, токенами и лимитами самостоятельно нет времени, подключение нейросетей к сайту, CRM и мессенджерам берут на себя специалисты по автоматизации в Neurounit. Такой подход экономит время на этапе отладки и снижает риск простоя бота из-за просроченного токена.
