раздел 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. |

Куда дальше