раздел 04
Шпаргалка
Всё главное на одной странице.
Модели и что для чего
| Модель | Для чего |
|---|---|
| GigaChat (Lite) | Простые и массовые задачи: короткие ответы, классификация. Быстро и экономно. |
| GigaChat-Pro | Рабочие тексты, диалог, инструкции посложнее, длинный контекст. |
| GigaChat-Max | Сложные рассуждения, аккуратная работа с кодом и большими документами. |
Чек-лист старта
- Для чата - открыл giga.chat или помощника в приложении Сбера.
- Для API - зашёл в кабинет на developers.sber.ru (Сбер ID).
- Создал проект GigaChat API (персональный доступ).
- Получил и сохранил Authorization key.
- Положил ключ в
.env, не в код и не в git. - Обменял ключ на access_token (scope
GIGACHAT_API_PERS). - При ошибке TLS - подключил сертификат НУЦ Минцифры.
- Сделал первый запрос к
/chat/completionsс Bearer-токеном.
Словарь терминов
| Термин | Что это |
|---|---|
| Authorization key | Постоянный ключ авторизации из кабинета. Хранится у вас, на него обменивают токен. |
| access_token | Временный токен для запросов к API (Bearer). Живёт около 30 минут, потом обновлять. |
| scope | Область доступа при запросе токена. Для персонального доступа - GIGACHAT_API_PERS. |
| /chat/completions | Основной эндпоинт диалога в стиле OpenAI: модель и массив messages. |
| /embeddings | Эндпоинт векторных представлений текста для поиска по смыслу и RAG. |
| Kandinsky | Модель генерации изображений, вызывается из GigaChat как функция. |
| Сертификат Минцифры | Корневой сертификат НУЦ Минцифры, может понадобиться для TLS-соединения с API. |
Куда дальше
- Нейронки по API - общий обзор работы с LLM через API.
- Yandex AI Studio - второй крупный российский провайдер моделей.
- Выбор модели - как подбирать модель под задачу.