GigaChat API: как подключить и использовать в России

GigaChat — это большая языковая модель от Сбера, доступная через удобный API. Главное преимущество — работает в России без VPN, принимает оплату российскими картами и отлично понимает русский язык. В этом гайде разберём всё: от регистрации до рабочих примеров кода.

Что такое GigaChat API

GigaChat API — это программный интерфейс для доступа к семейству моделей GigaChat от Сбера. Через API вы можете:

Генерировать текст — ответы на вопросы, статьи, переводы, рерайт
Анализировать документы — суммаризация, извлечение данных
Генерировать изображения — через встроенную модель Kandinsky
Работать с кодом — генерация, рефакторинг, объяснение
Создавать эмбеддинги — для поиска и RAG-систем

API совместим с форматом OpenAI, что упрощает миграцию с ChatGPT.

Модели GigaChat

Модель	Контекст	Назначение	Скорость
GigaChat Lite	8 192 токена	Простые задачи, чат-боты	Очень быстрая
GigaChat Pro	32 768 токенов	Сложные задачи, анализ документов	Быстрая
GigaChat Max	32 768 токенов	Максимальное качество, рассуждения	Средняя
GigaChat Lite (с функциями)	8 192 токена	Function calling, инструменты	Быстрая

Регистрация и получение ключа

Шаг 1: Создайте аккаунт разработчика

Перейдите на developers.sber.ru
Нажмите «Регистрация» и создайте аккаунт (по Сбер ID или email)
Подтвердите email

Шаг 2: Создайте проект

В личном кабинете перейдите в раздел «Проекты»
Нажмите «Создать проект»
Дайте имя проекту и выберите «GigaChat API»

Шаг 3: Получите Client ID и Client Secret

В настройках проекта найдите раздел «Авторизационные данные». Скопируйте Client ID и Client Secret — они понадобятся для получения токена доступа.

Шаг 4: Получите Authorization Key

Сформируйте строку Client ID:Client Secret и закодируйте её в Base64. Это и будет ваш Authorization Key для запроса токена.

Тарифы и оплата

Тариф	Стоимость	Включено	Для кого
Freemium	Бесплатно	1 млн токенов/мес (Lite)	Тестирование, личные проекты
Базовый	от 500 ₽/мес	5 млн токенов/мес	Небольшие проекты
Бизнес	от 5 000 ₽/мес	50 млн токенов/мес, Pro и Max	Коммерческие проекты
Корпоративный	Индивидуально	Безлимит, SLA, on-premise	Крупный бизнес

Оплата: российские банковские карты (Visa, MasterCard, МИР), счёт для юрлиц. Никаких проблем с оплатой из России — это ключевое преимущество перед OpenAI.

Пример: получение токена (curl)

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: $(uuidgen)" \
  -H "Authorization: Basic YOUR_AUTH_KEY" \
  -d "scope=GIGACHAT_API_PERS"

В ответ вы получите JSON с полем access_token — его нужно передавать в заголовке при каждом запросе. Токен действует 30 минут.

Пример: отправка запроса (Python)

import requests

# Получаем токен
auth_response = requests.post(
    "https://ngw.devices.sberbank.ru:9443/api/v2/oauth",
    headers={
        "Authorization": "Basic YOUR_AUTH_KEY",
        "RqUID": "unique-request-id",
        "Content-Type": "application/x-www-form-urlencoded"
    },
    data={"scope": "GIGACHAT_API_PERS"},
    verify=False  # сертификат Минцифры
)
token = auth_response.json()["access_token"]

# Отправляем запрос к модели
response = requests.post(
    "https://gigachat.devices.sberbank.ru/api/v1/chat/completions",
    headers={
        "Authorization": f"Bearer {token}",
        "Content-Type": "application/json"
    },
    json={
        "model": "GigaChat",
        "messages": [
            {"role": "user", "content": "Напиши 5 идей для стартапа в EdTech"}
        ],
        "temperature": 0.7
    },
    verify=False
)
print(response.json()["choices"][0]["message"]["content"])

Важно: GigaChat использует сертификат Минцифры. Для production-решений установите корневой сертификат вместо verify=False.

Пример: использование SDK

У GigaChat есть официальный Python SDK, который упрощает работу:

pip install gigachat

from gigachat import GigaChat

with GigaChat(credentials="YOUR_AUTH_KEY", verify_ssl_certs=False) as giga:
    response = giga.chat("Объясни квантовые вычисления простыми словами")
    print(response.choices[0].message.content)

Сравнение с другими API

Параметр	GigaChat API	YandexGPT API	ChatGPT API
Работает в РФ	Да, без VPN	Да, без VPN	Нужен VPN
Оплата из РФ	Да (рубли)	Да (рубли)	Нет (нужна зарубежная карта)
Русский язык	Отлично	Отлично	Хорошо
Формат API	OpenAI-совместимый	Собственный (gRPC/REST)	OpenAI
Бесплатный тариф	Да (1 млн токенов)	Да (ограниченный)	Нет
Генерация изображений	Да (Kandinsky)	Да (YandexART)	Да (DALL-E)
Function calling	Да	Нет	Да
SDK	Python	Python, Node.js	Python, Node.js и др.
Качество ответов	Хорошее	Хорошее	Отличное (GPT-4)

Use cases для бизнеса

1. Чат-бот для поддержки клиентов

GigaChat Lite отлично подходит для первой линии поддержки: быстрые ответы, понимание русского языка, низкая стоимость. Интеграция через API занимает 1-2 дня.

2. Анализ и суммаризация документов

GigaChat Pro с контекстом 32K токенов может обрабатывать длинные документы: договоры, отчёты, протоколы. Экономия времени — до 80%.

3. Генерация контента

Статьи, описания товаров, посты в соцсети. GigaChat хорошо справляется с русскоязычным контентом и понимает российские реалии.

4. RAG-системы (поиск по базе знаний)

Используйте эмбеддинги GigaChat для создания корпоративного поиска: загрузите документы, создайте индекс и позвольте сотрудникам задавать вопросы на естественном языке.

5. Автоматизация рутины

Классификация обращений, извлечение данных из писем, генерация отчётов — задачи, которые GigaChat решает быстрее и дешевле человека.

Ограничения GigaChat API

Контекст — максимум 32K токенов (против 128K у GPT-4)
Качество кода — уступает GPT-4 и Claude в сложных задачах программирования
Скорость на Max — модель Max заметно медленнее конкурентов
Сертификат — нужен сертификат Минцифры для production
Документация — менее подробная, чем у OpenAI

Советы по работе с API

Кэширование токена

Токен живёт 30 минут. Не запрашивайте новый при каждом вызове — сохраняйте и переиспользуйте.

Выбор модели

Начните с GigaChat Lite для прототипа. Переключайтесь на Pro/Max только если качество недостаточно. Lite стоит значительно дешевле.

Температура

Для фактических задач (извлечение данных, классификация) — temperature: 0.1. Для творческих (генерация текста, идеи) — temperature: 0.7-0.9.

Системные промпты

Используйте системное сообщение для задания роли и контекста. GigaChat хорошо следует системным инструкциям.

Итог

GigaChat API — лучший выбор для российских разработчиков, которым нужен LLM без проблем с VPN и оплатой. Бесплатный тариф позволяет протестировать всё без финансовых вложений, а OpenAI-совместимый формат упрощает миграцию. Качество уступает GPT-4, но для большинства бизнес-задач его более чем достаточно.

Попробовать GigaChat: Карточка инструмента →

Другие LLM: Каталог нейросетей →