Провайдер · GigaChat

GigaChat API по обычному ключу

Модели Сбера в Polza.ai работают в том же формате, что OpenAI: постоянный ключ вместо токена, который живёт 30 минут, и без корневого сертификата Минцифры. В каталоге — 8 моделей GigaChat, от 92,3 ₽ за миллион токенов входа.

Получить API-ключ Модели и цены Как подключить

GigaChat 2 Max, Pro, Lite и 3 Pro
Постоянный ключ без OAuth
У моделей sber/ данные хранятся в РФ
Карта РФ, СБП и счёт для юрлиц

curl · проверка ключа

# один запрос, чтобы убедиться, что всё работает

curl https://polza.ai/api/v1/chat/completions \

-H "Authorization: Bearer $POLZA_API_KEY" \

-H "Content-Type: application/json" \

-d '{"model": "sber/gigachat-2-max",

"messages": [{"role": "user", "content": "Привет"}]}'

Адрес и префикс модели — всё, что отличается от прямого обращения к вендору.

моделей GigaChat: 8
тип задач: 1
токенов контекста: 262 144
за 1M токенов входа: 92,3 ₽

Что доступно по ключу

Основная линейка — второе поколение: Lite на быстрые ответы, Pro на сложные инструкции, Max на тяжёлые задачи с изображениями на входе. Рядом GigaChat 3 Pro с контекстом 262 тысячи токенов и первое поколение для проектов, которые уже на нём.

Чат-модели

GigaChat-3-Pro, GigaChat 2 Max, GigaChat 2 Pro

/chat/completions

Почему напрямую не выходит

Сбер — российский вендор, и оплата здесь не главное. Упирается всё в подключение: авторизацию, сертификаты и договор.

Токен живёт 30 минут

Напрямую ключ авторизации меняют на токен доступа через отдельный OAuth-адрес, и через полчаса его нужно получать снова. Это код обновления токена в каждом сервисе.

Сертификат Минцифры

Для работы с GigaChat API Сбер просит установить корневой сертификат НУЦ Минцифры. Без него запросы падают на проверке TLS — в Docker, на CI и на серверах его ставят отдельно.

Совместимость с OpenAI частичная

Сбер сам пишет, что формат совместим с OpenAI частично, и для перенаправления OpenAI-запросов предлагает утилиту gpt2giga. Готовые OpenAI-ноды и библиотеки без неё работают не везде.

Новых клиентов отправляют на cloud.ru

С 1 сентября 2026 года новые клиенты оплачивают модели GigaChat на платформе cloud.ru — ещё один кабинет и договор.

Как получить ключ

Аккаунт у Сбера для этого не нужен: ключ выпускается в кабинете Polza и работает сразу со всеми вендорами каталога.

1
Зарегистрируйтесь
Почта и пароль. Телефон другой страны и зарубежная карта не нужны.
2
Создайте ключ
Раздел «API-ключи» в кабинете. Ключ начинается с pza_ — скопируйте его сразу, второй раз он не показывается. Ключей можно завести несколько: по одному на сервис или на сотрудника.
3
Пополните баланс
Карта РФ, СБП или счёт для юрлица. Минимальное пополнение — 100 ₽, этого хватает на 433 запроса к самой дешёвой модели GigaChat.
Получить API-ключ Документация

проверка ключа

# ключ из кабинета начинается с pza_
export POLZA_API_KEY=pza_...

# один запрос — и видно, что ключ живой
curl https://polza.ai/api/v1/models \
  -H "Authorization: Bearer $POLZA_API_KEY"

Адреса API

Слева то, что вы прописали бы при прямом доступе к GigaChat через OpenAI SDK, справа — что поставить вместо этого.

	GigaChat напрямую	Через Polza.AI
Базовый адрес	`https://api.giga.chat/v1`	`https://polza.ai/api/v1`
Чем авторизуется запрос	`Токен доступа на 30 минут`	`$POLZA_API_KEY`
Идентификатор модели	`GigaChat-2-Max`	`sber/gigachat-2-max`

Пути после базового адреса стандартные. У моделей GigaChat задействованы: /chat/completions.

Что меняется в коде

Вместо двух шагов авторизации — один постоянный ключ. Клиент — обычный OpenAI SDK, меняются адрес и идентификатор модели.

было · api.giga.chat

# 1. ключ авторизации меняем на токен доступа
POST https://ngw.devices.sberbank.ru:9443/api/v2/oauth
  Authorization: Basic <ключ авторизации>
  RqUID: <uuid4>
  scope=GIGACHAT_API_CORP

# 2. токен живёт 30 минут — потом снова шаг 1
# 3. корневой сертификат Минцифры в системе
POST https://api.giga.chat/v1/chat/completions
  Authorization: Bearer <токен доступа>

стало · polza.ai

import os

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["POLZA_API_KEY"],
    base_url="https://polza.ai/api/v1",
)

resp = client.chat.completions.create(
    model="sber/gigachat-2-max",
    messages=[{"role": "user", "content": "Привет"}],
)

Ключ берётся в кабинете Polza и не истекает. Обновлять токен, хранить scope и ставить сертификат Минцифры не нужно.

Что умеет API

Цифры — сколько моделей GigaChat в каталоге поддерживают эту возможность. Считается по самому каталогу, а не заявлено на словах. Стриминг ответа работает везде.

Вызов функций

Модель сама решает, когда дёрнуть вашу функцию, и передаёт аргументы.

tools

Строгий JSON

Ответ приходит по заданной схеме — без парсинга текста регулярками.

response_format

Рассуждение

Промежуточные шаги считаются отдельно и приходят отдельным полем.

reasoning

Картинка на входе

В сообщение можно положить изображение вместе с текстом.

vision

Есть ли бесплатный доступ

Бесплатного тарифа в Polza.ai нет — вы платите за токены. Но порог низкий: минимальное пополнение 100 ₽. Ниже видно, во что это выходит на практике.

Модель	Один запрос	1 000 запросов	Запросов на 100 ₽
`sber/gigachat-2`	0,23 ₽	231 ₽	433
`sber/gigachat-2-pro`	1,77 ₽	1 775 ₽	56
`sber/gigachat-2-max`	2,31 ₽	2 308 ₽	43

За запрос считаем 2 000 токенов на входе и 500 на выходе — это примерно страница текста в вопросе и абзац в ответе.

Отдельно про «бесплатные ключи», которые раздают в каналах и на форумах: это либо чужой ключ, либо прокси поверх чужого. Работает до первой блокировки, а промпты при этом уходят неизвестно куда. Для рабочего проекта не годится.

Модели и цены

Polza.ai показывает цены за миллион токенов в рублях и обновляет их каждый час. Подписки в Polza.ai нет: вы платите за то, что израсходовали, остаток не сгорает.

Модель	Тип	Контекст	Вход · 1M	Выход · 1M
sber/gigachat-2-maxСтаршая модель: сложные задачи, изображения на вход	Чат-модели	128 000	923 ₽	923 ₽
sber/gigachat-2-proСложные инструкции и составные задачи	Чат-модели	128 000	710 ₽	710 ₽
sber/gigachat-2Lite: быстрые ответы и повседневные задачи	Чат-модели	128 000	92,3 ₽	92,3 ₽
GigaChat/GigaChat-3-ProТретье поколение, контекст 262 144 токена	Чат-модели	262 144	104 ₽	250 ₽
sber/gigachat-maxMax первого поколения, если проект собран под неё	Чат-модели	128 000	923 ₽	923 ₽
sber/gigachat-proPro первого поколения	Чат-модели	32 000	710 ₽	710 ₽

Это выборка. Полный список — 8 моделей GigaChat и ещё 389 моделей у других вендоров — в каталоге.

Получить API-ключ Каталог моделей

Прямой доступ и доступ через Polza

	GigaChat напрямую	Через Polza.AI
Оплата	Пакеты у Сбера или баланс на cloud.ru	Карта РФ, СБП, счёт для юрлица
Авторизация	OAuth-токен на 30 минут и scope	Постоянный ключ
Документы	Свои договор и УПД у каждого вендора	Один договор и одни УПД на все модели
Цены	Пакеты или оплата по факту	За токены, баланс не сгорает
Модели других вендоров	Отдельный договор и ключ	Тот же ключ, 397 моделей
Если модель отвалилась	Ждать	Поменять строку с моделью
Код	SDK gigachat или OpenAI SDK с токеном	Тот же SDK, другой Base URL

Если не работает

6 причин, на которые приходится почти вся переписка с поддержкой: сначала коды ответов, потом то, что встречается именно с GigaChat.

401 Unauthorized или Invalid API key

Ключ скопирован не целиком или взят из другого проекта. Рабочий ключ начинается с pza_ и передаётся заголовком Authorization: Bearer pza_.... Токен доступа Сбера здесь не подойдёт.

402 или «недостаточно средств»

Кончился баланс. Он общий на все модели и не сгорает — пополните в кабинете картой, через СБП или по счёту, ключ менять не нужно.

404 на модели

Забыт префикс вендора. Не gigachat-2-max, а sber/gigachat-2-max — идентификатор целиком, как в каталоге. Проверить написание можно запросом к /api/v1/models.

429 Too Many Requests

Слишком много запросов в секунду к конкретной модели. Это ограничение вендора, а не баланса: помогает повтор с задержкой или переключение на соседнюю модель в той же линейке.

Модель не находится по имени из документации Сбера

У Сбера модель называется GigaChat-2-Max, в каталоге Polza — sber/gigachat-2-max: с префиксом и строчными буквами.

Ответ обрывается на длинном документе

У GigaChat, Plus и Pro первого поколения контекст 32 000 токенов. Для длинных документов берите второе поколение или GigaChat 3 Pro — контекст видно в таблице выше.

Для команд и юрлиц

Счёт, УПД и НДС

Оплата по счёту для ООО и ИП, договор с российским юрлицом, закрывающие документы каждый месяц.

Ключ на сотрудника

Отдельные ключи с общим балансом организации: видно, кто и сколько потратил.

Контроль бюджета

Статистика расходов по ключам и моделям в кабинете, без сюрпризов в конце месяца.

Помощь с переездом

Поможем перевести команду с зарубежных подписок на API: настройка окружений и правила расходования.

Вопросы и ответы

Зачем через Polza.ai, если GigaChat и так российский?

Не из-за оплаты, а из-за подключения. Напрямую нужны OAuth-токен, который обновляется каждые 30 минут, сертификат Минцифры и отдельный договор. Polza.ai выдаёт постоянный ключ в формате OpenAI — тот же, что для остальных моделей.

Это дешевле, чем напрямую у Сбера?

Нет. По прямому тарифу Сбера или на cloud.ru токены GigaChat обходятся дешевле. В Polza.ai вы доплачиваете за то, что не нужно поддерживать авторизацию и отдельный договор, а GigaChat живёт в одном проекте рядом с моделями других вендоров.

Где хранятся данные?

У моделей sber/ в каталоге Polza.ai стоит отметка о хранении данных в России. У GigaChat 3 Pro такой отметки нет — это видно на карточке модели.

Работает ли GigaChat в n8n и LangChain?

Да, через стандартные OpenAI-ноды и ChatOpenAI: адрес https://polza.ai/api/v1, ключ Polza.ai и идентификатор модели. Отдельная библиотека GigaChain не нужна.

Есть ли GigaChat 3 Ultra?

В каталоге Polza.ai её сейчас нет. Состав моделей меняется — актуальный список GigaChat виден в каталоге по запросу «gigachat».

Можно оплатить по счёту?

Да. Polza.ai выставляет счёт для ООО и ИП, заключает договор с российским юрлицом и каждый месяц присылает закрывающие документы. Ключи выдаются на сотрудников, баланс общий.

А другие вендоры?

Тот же ключ Polza.ai открывает 397 моделей. Чтобы уйти с GigaChat на другого вендора, достаточно поменять строку с идентификатором модели.

Работает там, где вы уже работаете

Редакторы, десктоп-клиенты, чаты для команды, конструкторы сценариев и фреймворки. Ключ и баланс везде одни и те же, меняется только адрес API. На каждый инструмент есть разбор по шагам.

Редакторы и агенты в коде

Ставятся в редактор или запускаются в терминале. Читают проект, правят файлы, гоняют тесты.

Zed

Десктоп-клиенты

Обычные приложения с окном чата: поставили, вписали ключ и работаете.

Jan

Свой чат для команды

Веб-интерфейс на своём сервере: общий доступ для коллег, история, документы. Рядом с локальными моделями работают облачные через тот же ключ.

Open WebUI

LibreChat

AnythingLLM

Автоматизация и фреймворки

Сценарии, боты и собственные сервисы — там, где модель вызывается из кода или из ноды.

n8n

Подсвечены те, для которых эта страница подходит лучше всего. Остальные работают с тем же ключом.

Все интеграции

Другие вендоры по тому же ключу

Менять договор и заводить второй ключ не нужно: вендор переключается строкой с идентификатором модели.

OpenAI72 модели Qwen46 моделей Google41 модель Mistral AI22 модели GLM16 моделей Anthropic15 моделей DeepSeek14 моделей xAI10 моделей Kimi8 моделей YandexGPT7 моделей bytedance9 моделей MiniMax8 моделей Meta8 моделей Perplexity7 моделей Tencent6 моделей

Открыть каталог — 397 моделей

Кто проверял эту инструкцию

Евгений Лебедев

Руководитель техподдержки · редакция Polza.AI

Собрал и проверил подключение GigaChat на актуальной версии: прошёл все шаги заново, сверил идентификаторы моделей с каталогом и перепроверил адреса API. Если API обновится и инструкция разойдётся с реальностью — правим страницу.

Обновлено 5 ноября 2026 · Как работает редакция · Нашли неточность? Напишите нам

GigaChat без токенов и сертификатов

В Polza.ai — один постоянный ключ, формат OpenAI и счёт для юрлица. Модели Сбера подключаются так же, как любые другие.

Получить API-ключ

Остались вопросы? Документация Polza.AI, поддержка в Telegram или support@polza.ai

Страницу проверила редакция Polza.AI, обновлено 5 ноября 2026. Цены и состав каталога меняются — Polza.ai берёт их из каталога и обновляет каждый час.