2.2 Как получить доступ к API и начать работать
Чтобы получить доступ к GigaChat API, заходите по ссылке или отсканируйте QR-код:
Сайт открывается на всех устройствах и браузерах. Авторизуйтесь по номеру телефона любого мобильного оператора России, Беларуси, Казахстана или Киргизии — для этого не нужно быть клиентом Сбера. На номер придет СМС с кодом авторизации. Это бесплатно и не подписывает вас на какие-либо сервисы.
- Вы в личном кабинете разработчика. В левом меню найдите раздел AI-модели, добавьте проект GigaChat API и примите условия пользовательского соглашения.
2. В правом нижнем углу вы увидите ссылку на Postman, это популярный бесплатный веб-клиент для работы с API, в нём мы будем изучать продвинутые метода работы с GigaChat.
Авторизуйтесь в Postman: введите адрес вашей почты, придумайте пароль, дождитесь подтверждающего письма и перейдите по ссылке из него. Или авторизуйтесь с помощью аккаунта Google.
После авторизации вы попадёте на страницу, здесь выберите коллекцию «GigaChat API» (справа):
Чтобы написать первый промпт, нужно создать Fork (ответвление) — тестовое пространство продвинутой версии GigaChat, а также получить токен доступа к GigaChat API.
3. Для создания Fork в левом меню нажмите на три точки напротив коллекции «GigaChat API», в раскрывшемся списке выберите «Create a fork», придумайте название и нажмите «Fork collection» — и ваше пространство отобразится в левом меню, рядом с коллекцией «GigaChat API».
3. Для создания Fork в левом меню нажмите на три точки напротив коллекции «GigaChat API», в раскрывшемся списке выберите «Create a fork», придумайте название и нажмите «Fork collection» — и ваше пространство отобразится в левом меню, рядом с коллекцией «GigaChat API».
4. Почти готово! Осталось получить токен доступа — для этого сначала вернитесь в личный кабинет на сайте developers.sber.ru, перейдите на страницу проекта «Мой GigaChat API» и в правом меню нажмите кнопку «Сгенерировать новый Client Secret».
В открывшемся окне скопируйте код из поля «Авторизационные данные».
Храните API-ключ в секрете и не передавайте третьим лицам.
Храните API-ключ в секрете и не передавайте третьим лицам.
Теперь снова перейдите на страницу коллекции «GigaChat API» в Postman, откройте вкладку «Variables» и вставьте скопированный код в пустую строку напротив параметра «Credentials» в графе «Current value» и нажмите «Сохранить» в правом верхнем углу.
В левом меню откройте страницу «POST get access_token» и нажмите справа кнопку «Send». Сделано! Токен доступа действителен 30 минут. Когда они истекут, снова откройте страницу «POST get access_token» и нажмите «Send», чтобы получить новый токен.
В левом меню откройте страницу «POST chat/completions (text)» и перейдите во вкладку «Body».
В левом меню откройте страницу «POST chat/completions (text)» и перейдите во вкладку «Body».
Здесь вы сможете написать первый системный промпт и настраивать параметры ответов GigaChat API – но об этом немного позже.
На сайте developers.sber.ru в разделе документации для разработчиков тоже есть инструкции, как начать работать с GigaChat API: быстрый старт, получение токена и многие другие.
Подробнее узнать, как устроена платформа Postman и какие инструменты в ней есть, можно здесь (в основных чертах на русском) и здесь (полноценная база знаний на английском).
Проверьте, что у вас всё правильно получилось, по этой видеоинструкции.
На сайте developers.sber.ru в разделе документации для разработчиков тоже есть инструкции, как начать работать с GigaChat API: быстрый старт, получение токена и многие другие.
Подробнее узнать, как устроена платформа Postman и какие инструменты в ней есть, можно здесь (в основных чертах на русском) и здесь (полноценная база знаний на английском).
Проверьте, что у вас всё правильно получилось, по этой видеоинструкции.