Интеграция GigaChat API

Что можно подключить

• Ответы Telegram- или MAX-бота на свободные вопросы
• Поиск и ответы по базе знаний через эмбеддинги GigaChat
• Генерацию текстов в админке сайта: описания, письма, объявления
• Классификацию и пересказ заявок перед передачей в CRM
• Извлечение данных из текста обращений и документов в JSON
• Разбор отзывов и черновики ответов на них
• Перевод проекта с OpenAI-совместимого кода на GigaChat
• Выбор модели под задачу: лёгкая для массовых запросов, старшая для сложных

Какие задачи бизнеса решает

• Использовать нейросеть с договором и оплатой в России
• Добавить ИИ-функцию в существующий продукт без переделки архитектуры
• Уйти с зарубежной модели на российскую из-за оплаты или персональных данных
• Автоматизировать рутинную обработку текстов и обращений

Как устроена интеграция

Доступ к GigaChat API оформляется в личном кабинете на портале developers.sber.ru: там создаётся проект и выдаётся ключ авторизации. По этому ключу сервер получает токен доступа, который действует ограниченное время (около 30 минут), и с ним отправляет запросы к модели. Я делаю модуль, который хранит ключ в переменных окружения сервера, сам обновляет токен до истечения и повторяет запрос при временной ошибке.

Сертификаты и типичная ошибка

Для обращения к GigaChat API нужен корневой сертификат НУЦ Минцифры. В инструкциях в интернете часто советуют просто отключить проверку TLS — так делать нельзя: это открывает соединение для подмены. Я подключаю сертификат в доверенные корневые сертификаты на сервере или в самом HTTP-клиенте приложения.

Какую модель выбрать

У GigaChat есть несколько моделей: лёгкая и быстрая для массовых простых запросов и более мощные для сложных задач. Они отличаются качеством и ценой, поэтому часто выгодно использовать разные модели для разных функций: классификацию обращений — на лёгкой, развёрнутые ответы — на старшей. Подбираю на ваших реальных примерах.

Переход с OpenAI на GigaChat

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

Что нужно от вас

Доступ к GigaChat API на ваше юрлицо или ИП — ключ и оплата должны быть у вас. Описание задачи и 10–30 реальных примеров входных данных с ожидаемым результатом. Доступ к коду или серверу, куда нужно встроить интеграцию.

Сроки и от чего зависит цена

Одна функция в готовом проекте — самый быстрый вариант. Дольше, если нужен поиск по базе знаний, обработка файлов, несколько сценариев или перевод большого проекта с другой модели. Использование модели оплачивается Сберу по тарифу выбранной схемы отдельно от разработки.

Примеры функционала

• Ключ авторизации только на сервере, токен доступа обновляется автоматически
• Корректная работа с сертификатами НУЦ Минцифры без отключения проверки TLS
• Лимиты на длину запросов и число обращений от пользователя
• Повтор запроса при временных ошибках и запасной сценарий при сбое
• Журнал запросов и расхода токенов
• Проверка структурированных ответов перед записью в базу

Как проходит разработка

1. 1.Разбираю задачу и данные, которые будут уходить в модель
2. 2.Помогаю создать проект в личном кабинете Сбера для разработчиков и получить ключ
3. 3.Подбираю модель и инструкции, тестирую на ваших примерах
4. 4.Встраиваю вызов в backend, бота или админку, добавляю лимиты и журнал
5. 5.Запускаю, показываю, где смотреть расход, и передаю доступы

Используемые технологии

FAQ