Как работать с API-ключами YandexGPT и GigaChat и использовать их на своих проектах
API-ключи GigaChat и YandexGPT можно оплатить российской картой, в отличие от ChatGPT. В этой статье показываем, как получить API-ключ для обеих нейросетей и подключить их к Google Таблицам. Для YandexGPT даем готовый скрипт, для GigaChat — ссылки на документацию и бесплатный курс с примерами. Также разбираем тарифы: сколько стоят токены и какие модели выбрать.
Мы написали уже несколько гайдов о том, как работать с API-ключами ChatGPT:
Главная проблема API-ключей ChatGPT — их сложно оплатить. Для этого нужно пользоваться сервисами-посредниками или искать иностранные карты.
Выход есть — пользоваться отечественными нейросетями YandexGPT и GigaChat и их API-ключами.
Как получить API-ключи YandexGPT
Перейдите в сервис Yandex Cloud Billing.
Войдите в свой Яндекс ID или аккаунт в Яндекс 360. Если у вас еще нет аккаунта, зарегистрируйтесь и в сервисе Yandex Cloud Organization создайте организацию, в которой вы будете работать. Если для входа на Яндекс вы используете профиль в социальной сети, заведите логин и пароль.
На странице «Платёжные аккаунты» нажмите кнопку «Создать платёжный аккаунт».
Заполните данные:
- Укажите имя платежного аккаунта. Имя будет отображаться в списке ваших платежных аккаунтов и поможет выбрать нужный.
- В поле Организация выберите организацию, для которой будет создан платежный аккаунт.
- Выберите страну, резидентом которой является плательщик. В рамках одного пользовательского аккаунта все плательщики должны осуществлять оплату в одной и той же валюте.
Добавьте платежные данные. Принимаются банковские карты Мир, Visa и MasterCard.
- Резиденты Российской Федерации ведут расчеты в RUB и могут использовать для оплаты карты, выпущенные только российскими банками.
- Резиденты Республики Казахстан ведут расчеты в KZT и могут использовать для оплаты карты, выпущенные только нероссийскими банками.
Совет. Привязывайте карту сразу, потому что в этом случае вам дадут грант 4000 рублей на 60 дней. Этих денег хватит на активное использование сервиса для разных задач.
После создания платежного аккаунта перейдите в консоль Yandex в раздел «Сервисные аккаунты» → «Перейти в Identity and Access Management».
В правом верхнем углу кликните «Создать сервисный аккаунт».
Если до этого аккаунтов не создавали, кнопка создания будет по центру.
В открывшемся окне придумайте имя аккаунта, описание можете не заполнять. В разделе «Роли в каталоге» выберите “ai.languageModels.user”.
После создания кликните по названию аккаунта и в правом верхнем углу выберите «Создать новый ключ» → «Создать API-ключ».
В открывшемся окне можно ничего не заполнять и просто кликнуть на «Создать».
Затем вам покажут ваш API-ключ — обязательно скопируйте его и сохраните, потому что после закрытия окна вы не сможете посмотреть его вновь.
Готово, вы получили API-ключ и можете использовать YandexGPT в своих проектах.
Как подключить YandexGPT API к Google Таблицам
Готовых скриптов для работы с YandexGPT в таблицах пока немного, но написать свой несложно. Я сделал это с помощью ChatGPT и документации Яндекса — ушло около часа с учетом отладки.
- Я открыл документацию Яндекса и скопировал нужные разделы про API в блокнот, сохранил файл.
- Пришел в ChatGPT и объяснил, что мне нужно написать скрипт для Google таблиц с интегрированным YandexGPT. Показал пример рабочего скрипта с интегрированным ChatGPT и приложил нужную информацию из документации Яндекса.
- Потратил около 4 часов в попытках сделать рабочий код и через десятки правок у меня получилось сделать рабочий скрипт.
Вот, как он выглядит:
// Основная функция для вызова YandexGPT
function yandexgpt(prompt, temperature = 0.7, max_tokens = 1000) {
const apiKey = "ВАШ API_КЛЮЧ"; // Замените на ваш API-ключ
const folderId = "ВАШ FODER_ID"; // Замените на ваш идентификатор каталога
const endpoint = "https://llm.api.cloud.yandex.net/foundationModels/v1/completion";
const headers = {
"Authorization": `Api-Key ${apiKey}`,
"x-folder-id": folderId,
"Content-Type": "application/json"
};
const payload = {
"modelUri": `gpt://${folderId}/yandexgpt/latest`,
"completionOptions": {
"stream": false,
"temperature": temperature,
"maxTokens": max_tokens
},
"messages": [
{ "role": "user", "text": prompt }
]
};
const options = {
"method": "post",
"headers": headers,
"payload": JSON.stringify(payload),
"muteHttpExceptions": true
};
try {
const response = UrlFetchApp.fetch(endpoint, options);
const jsonResponse = JSON.parse(response.getContentText());
if (response.getResponseCode() !== 200) {
throw new Error(`Ошибка ${response.getResponseCode()}: ${jsonResponse.error.message}`);
}
// Возврат текста ответа
return jsonResponse.result.alternatives[0].message.text.trim();
} catch (error) {
Logger.log("Ошибка: " + error.message);
throw new Error("Не удалось получить ответ от YandexGPT API.");
}
}
// Пользовательская функция для Google Таблицы
function CHAT(prompt) {
try {
return yandexgpt(prompt); // Вызов основного метода
} catch (error) {
return `Ошибка: ${error.message}`;
}
}Как с ним работать:
- В строку const apiKey подставьте свой API-ключ.
- В строку const folderId добавьте ваш идентификатор каталога: он будет в URL консоли и справа от названия папки «default».
Теперь добавим скрипт в Google Таблицы. Для этого откройте гугл-таблицы → «Расширения» → «Apps Script» → на открывшейся странице добавьте скрипт вместо того, что там написан.
После этого кликните на значок дискеты и на «Выполнить».
Разрешите запуск скрипта, авторизуйтесь через Google аккаунт.
Скрипт запустится. После этого можете возвращаться в созданную таблицу.
Чтобы вызвать нейронку, напишите в любой ячейке =chat(“Запрос”).
Стоимость токенов YandexGPT
Стоимость YandexGPT зависит от модели и режима работы. В синхронном режиме за 1000 токенов вы заплатите: YandexGPT Lite — 0,20 ₽, YandexGPT Pro 5 — 1,22 ₽, YandexGPT Pro 5.1 — 0,41 ₽ (действует скидка 50%). В асинхронном режиме цены вдвое ниже, но ответ приходит не сразу.
Для ориентира: миллион токенов на YandexGPT Lite обойдётся примерно в 200 ₽, на Pro 5.1 — около 410 ₽. Актуальные цены можно проверить в документации Yandex AI Studio.
Как получить API-ключ GigaChat
Для этого перейдите по ссылке и нажмите «Попробовать».
Нужно будет авторизоваться через Сбер ID. Для этого понадобится российский номер.
После регистрации вам дадут бесплатный тариф на год — всего 1 000 000 токенов: 900 000 на GigaChat 2 Lite, по 50 000 на GigaChat 2 Pro и GigaChat 2 Max.
Модели отличаются по возможностям.
Lite — самая быстрая, подходит для простых задач.
Pro — баланс между скоростью и качеством, лучше справляется со сложными инструкциями.
Max — самая мощная, для задач, требующих креативности и точности.
Бесплатных токенов хватит, чтобы полноценно протестировать сервис и понять, какая модель подходит под ваши задачи.
Чтобы получить API-ключи, на главной странице кликните «Получить доступ».
На открывшейся странице будет 3 графы с данными, которые нужны для работы:
- Client ID
- Scope
- Ключ авторизации
В случае с GigaChat в сети есть больше инструкций по работе с API и готовых кодов. Например, сам Сбер сделал репозиторий с готовыми примерами использования.
А еще я нашел бесплатный курс от агентства MKF.digital на Stepik. Там преподаватели показали готовый скрипт GigaChat для Google Таблиц, который позволяет генерировать изображения и работать с текстом.
В гайде показывать скрипт не буду, потому что он большой и принадлежит не нам. Но в курсе есть подробная инструкция по работе с ним. Работает он также, как и YandexGPT. Отличаются только функции для вызова:
=MKF_SBER(“ваш запрос”)
Внутри скрипта есть и другие функции, но они работают менее стабильно, поэтому их можно не использовать.
Для работы с API GigaChat нужен сертификат НУЦ Минцифры — без него запросы не пройдут. Это ограничивает использование в зарубежных сервисах автоматизации, но с отечественными инструментами проблем не возникнет.
Упростить интеграцию поможет официальная Python-библиотека gigachat — она сама устанавливает нужные сертификаты. Для более сложных сценариев есть GigaChain — аналог LangChain для работы с GigaChat.
Стоимость токенов GigaChat
Стоимость генерации зависит от модели. Физические лица могут докупать пакеты токенов, которые действуют 12 месяцев. Актуальные цены:
| 5 000 000 токенов GigaChat 2 Lite | 1 000 ₽ |
| 30 000 000 токенов GigaChat 2 Lite | 5 820 ₽ |
| 1 000 000 токенов GigaChat 2 Pro | 1 500 ₽ |
| 5 000 000 токенов GigaChat 2 Pro | 7 275 ₽ |
| 1 000 000 токенов GigaChat 2 Max | 1 950 ₽ |
| 4 000 000 токенов GigaChat 2 Max | 7 566 ₽ |
Подробнее о тарифах — в документации GigaChat.
Читайте также:
Разберитесь в мире нейросетей и научитесь основам: от выбора подходящей модели, доступной в России, до практических способов оплаты подписок на ведущие мировые ИИ-платформы.
- Миникурс
- Учеба