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

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

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

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

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

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

- **Чат-модели** — 8, эндпоинт `/chat/completions`: GigaChat-3-Pro, GigaChat 2 Max, GigaChat 2 Pro

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

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

- **Токен живёт 30 минут.** Напрямую ключ авторизации меняют на токен доступа через отдельный OAuth-адрес, и через полчаса его нужно получать снова. Это код обновления токена в каждом сервисе.
- **Сертификат Минцифры.** Для работы с GigaChat API Сбер просит установить корневой сертификат НУЦ Минцифры. Без него запросы падают на проверке TLS — в Docker, на CI и на серверах его ставят отдельно.
- **Совместимость с OpenAI частичная.** Сбер сам пишет, что формат совместим с OpenAI частично, и для перенаправления OpenAI-запросов предлагает утилиту gpt2giga. Готовые OpenAI-ноды и библиотеки без неё работают не везде.
- **Новых клиентов отправляют на cloud.ru.** С 1 сентября 2026 года новые клиенты оплачивают модели GigaChat на платформе cloud.ru — ещё один кабинет и договор.

## Адреса 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 |

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

Вместо двух шагов авторизации — один постоянный ключ. Клиент — обычный 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

- Вызов функций (tools): 1
- Строгий JSON (response_format): 1
- Рассуждение (reasoning): 0
- Картинка на входе (vision): 4

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

Бесплатного тарифа в 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](https://polza.ai/models/sber/gigachat-2-max.md) — Старшая модель: сложные задачи, изображения на вход | Чат-модели | 128 000 | 923 ₽ | 923 ₽ |
| [sber/gigachat-2-pro](https://polza.ai/models/sber/gigachat-2-pro.md) — Сложные инструкции и составные задачи | Чат-модели | 128 000 | 710 ₽ | 710 ₽ |
| [sber/gigachat-2](https://polza.ai/models/sber/gigachat-2.md) — Lite: быстрые ответы и повседневные задачи | Чат-модели | 128 000 | 92,3 ₽ | 92,3 ₽ |
| [GigaChat/GigaChat-3-Pro](https://polza.ai/models/GigaChat/GigaChat-3-Pro.md) — Третье поколение, контекст 262 144 токена | Чат-модели | 262 144 | 104 ₽ | 250 ₽ |
| [sber/gigachat-max](https://polza.ai/models/sber/gigachat-max.md) — Max первого поколения, если проект собран под неё | Чат-модели | 128 000 | 923 ₽ | 923 ₽ |
| [sber/gigachat-pro](https://polza.ai/models/sber/gigachat-pro.md) — Pro первого поколения | Чат-модели | 32 000 | 710 ₽ | 710 ₽ |

## Прямой доступ и доступ через 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 — контекст видно в таблице выше.

## Частые вопросы

### Зачем через 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 на другого вендора, достаточно поменять строку с идентификатором модели.

## Ссылки

- Документация: https://polza.ai/docs
- Каталог моделей: https://polza.ai/models/llms.txt
- Страница: https://polza.ai/providers/gigachat
- Обновлено: 2026-11-05