YandexGPT API: как подключить нейросеть Яндекса к сайту и CRM и сколько это стоит

Что такое YandexGPT API и кому он нужен

API (программный интерфейс) — это «розетка», через которую одна программа обращается к другой. Подробнее о самом понятии — в статье API: что это. В случае YandexGPT ваша программа отправляет текст на сервер Яндекса и получает ответ модели.

Чат на сайте Алисы и API — разные продукты. В чате человек пишет сам. Через API нейросеть работает внутри ваших процессов без участия человека:

Если вы ещё выбираете между российскими и зарубежными моделями, сравнение по оплате и данным — в материале YandexGPT, GigaChat или ChatGPT для бизнеса. Здесь — только про подключение и деньги.

Какие модели доступны в Yandex AI Studio

В AI Studio сейчас целая витрина моделей, а не одна YandexGPT. Есть собственные модели Яндекса и открытые модели других разработчиков, развёрнутые на серверах Яндекса. Для типичных задач малого бизнеса выбор обычно сводится к трём вариантам:

• YandexGPT Lite — лёгкая и дешёвая. Подходит для классификации, коротких ответов, извлечения данных из текста.
• YandexGPT Pro 5.1 — точнее на сложных инструкциях и длинных документах.
• Alice AI LLM и Alice AI LLM Flash — более новая линейка Яндекса, у Flash очень низкая цена и скидка на повторяющуюся часть запроса.

Кроме них в каталоге есть DeepSeek, Qwen, gpt-oss и другие открытые модели. Список меняется, поэтому перед проектом смотрите актуальный перечень в документации AI Studio.

Совет из практики: начинайте с самой дешёвой модели, которая проходит ваш тест на реальных вопросах. Переключиться на более сильную можно одной строкой в коде.

Как подключить YandexGPT API: пошагово

Интерфейс консоли периодически меняется, поэтому описываем суть шагов, а не путь по кнопкам.

1. Зарегистрируйтесь в Yandex Cloud через Яндекс ID и создайте платёжный аккаунт. Для компании лучше сразу оформлять его на юрлицо или ИП, чтобы получать закрывающие документы. Новым пользователям дают стартовый грант на 60 дней, условия зависят от страны и способа оплаты.
2. Создайте каталог — папку, в которой будут жить ресурсы проекта. Запомните его идентификатор: он нужен в каждом запросе.
3. Создайте сервисный аккаунт. Это «технический пользователь», от имени которого ваш бот или CRM обращается к модели. Не используйте для этого свой личный аккаунт.
4. Назначьте роль. Для генерации текста нужна роль ai.languageModels.user на каталог. Для генерации картинок и для агентов через Responses API нужны другие роли, они перечислены в справке по аутентификации.
5. Выпустите API-ключ для сервисного аккаунта. Ключ показывается один раз: сохраните его в менеджере паролей или в переменных окружения сервера.
6. Отправьте тестовый запрос. В нём указываются адрес модели (идентификатор каталога плюс название модели), системная инструкция, сообщение пользователя и параметры: температура (насколько «творчески» отвечать) и максимальная длина ответа.
7. Отключите логирование, если в запросах будут персональные или конфиденциальные данные (подробнее ниже).
8. Подключите к своему сервису. Бот, CRM, сайт или платформа автоматизации вроде n8n обращаются к API с вашего сервера. Как устроены такие связки, мы разбирали в статье n8n: что это.

Где хранить ключ

Ключ API работает как пароль к вашему кошельку в облаке. Правила простые:

• ключ хранится только на сервере, никогда в коде страницы, который видит посетитель;
• у каждого проекта свой сервисный аккаунт и свой ключ;
• сотрудник ушёл или ключ попал в переписку — удаляете старый и выпускаете новый.

Если ключ утечёт, им может пользоваться кто угодно, а счёт придёт вам.

Совместимость с библиотеками OpenAI

AI Studio поддерживает формат запросов, совместимый с OpenAI. Это значит, что готовые библиотеки и многие конструкторы ботов, рассчитанные на ChatGPT, можно направить на модели Яндекса, поменяв адрес и ключ. Перед выбором платформы проверьте, умеет ли она указывать свой адрес API. Если нет — понадобится прослойка на вашем сервере.

Сколько стоит YandexGPT API в 2026 году

Платите за токены — кусочки текста, на которые модель режет слова. В русском одно слово часто занимает несколько токенов. Точно посчитать длину своего текста можно бесплатным методом токенизатора в самом API.

Цены из правил тарификации AI Studio на октябрь 2026 года, в рублях с НДС за 1 000 токенов:

Что важно в правилах тарификации:

• Синхронный режим — ответ приходит сразу, нужен для ботов и чатов. Асинхронный — запрос ставится в очередь, ответ забираете позже. Подходит для ночной обработки отзывов, описаний товаров, разметки заявок.
• Пакетный режим для больших объёмов дешевле, но у каждого запуска есть минимум — 200 000 токенов.
• Кэширование. Если начало запроса повторяется (одна и та же инструкция), часть моделей считает его по сниженной цене. Яндекс предупреждает, что кэширование срабатывает автоматически, но не гарантировано.
• Ошибки на стороне сервера не тарифицируются, вызовы токенизатора бесплатны.

Цены меняются. Перед расчётом бюджета открывайте актуальную страницу тарифов и проверяйте свою модель и режим.

Пример расчёта: сколько стоит бот на YandexGPT

Пример условный, не кейс студии. Клининговая компания в Казани хочет бота на сайте и в мессенджере: ответы про цены, зоны выезда и запись. Допустим, 2 000 диалогов в месяц.

Из чего складывается один диалог:

• системная инструкция и выдержка из базы знаний: около 3 000 токенов, уходит с каждым сообщением;
• в среднем 5 сообщений клиента, история диалога растёт;
• итого на входе примерно 20 000 токенов за диалог, на выходе — около 1 000.

Разница между верхней и нижней строкой — в 15 раз при одинаковом количестве клиентов. Отсюда три вывода:

1. Модель выбирают тестом: если дешёвая отвечает правильно на 50 реальных вопросов, дорогая не нужна.
2. Инструкцию и базу знаний стоит сокращать. Лишние 2 000 токенов в каждом сообщении — это половина бюджета.
3. Историю диалога не нужно хранить целиком: достаточно последних сообщений и короткой выжимки.

Подробнее о том, из чего складывается цена бота целиком (разработка, база знаний, поддержка), — в статье сколько стоит чат-бот. Токены там — самая маленькая статья расходов.

Если хочется понять, какие задачи в вашей компании вообще имеет смысл отдавать модели, и посчитать бюджет до разработки, это удобно разобрать на созвоне.

Как подключить YandexGPT к сайту и CRM

Схема почти всегда одна: посетитель или менеджер → ваш сервер → API Яндекса → ваш сервер → ответ в нужное место. Сайт напрямую к API не обращается, иначе ключ окажется в открытом коде.

Сайт и чат-бот

• Виджет чата на сайте отправляет сообщение на ваш сервер.
• Сервер добавляет инструкцию, выдержку из базы знаний и историю, отправляет в модель.
• Ответ возвращается в виджет. Если бот не уверен или клиент просит человека, диалог передаётся менеджеру.

Для мессенджеров схема та же, только вместо виджета — бот в Телеграм или MAX. Варианты от конструктора до своего агента разобраны в материале AI-бот в Telegram для бизнеса.

CRM: amoCRM, Битрикс24 и другие

Типовые сценарии:

• при новой заявке модель вытаскивает из текста услугу, адрес, бюджет и заполняет поля;
• после звонка в карточке появляется резюме разговора и следующий шаг;
• раз в день модель проверяет зависшие сделки и пишет менеджеру, кому перезвонить.

Технически это делается через вебхуки CRM, свой сервер или платформу автоматизации. Подробнее — в статье нейросеть в CRM.

Без программиста

Если разработчика нет, возможны два пути: конструкторы ботов с поддержкой YandexGPT или своего адреса API и платформы автоматизации. Простые сценарии там собираются за день. Сложная логика, работа с базой знаний и передача в CRM обычно требуют разработчика.

Персональные данные и логирование

По умолчанию API сохраняет данные запросов. В документации Яндекса прямо сказано: если в запросах есть персональные, конфиденциальные или иные чувствительные данные, логирование нужно отключить. Для этого в каждый запрос добавляют заголовок x-data-logging-enabled: false, в официальном SDK есть соответствующий параметр.

Что ещё сделать до запуска:

1. Отправляйте в модель только нужное. Для ответа о цене уборки ФИО и телефон клиента не нужны.
2. Обезличивайте, где можно. «Клиент, квартира 60 м², Советский район» вместо полного адреса.
3. Обновите политику обработки персональных данных на сайте: укажите, что данные передаются обработчику (облачному провайдеру). Что должно быть в политике — в статье политика конфиденциальности для сайта.
4. Проверьте договор с облаком на условия поручения обработки данных.

Серверы Яндекса находятся в России, поэтому требование хранить базы персональных данных граждан РФ в России при работе через AI Studio выполнить проще, чем с зарубежными сервисами. Остальные обязанности по 152-ФЗ остаются на вас. Что можно и нельзя загружать в нейросети, подробно разобрано в материале нейросети и персональные данные.

Ограничения и подводные камни

Как проверить качество до запуска

1. Соберите 50 реальных вопросов клиентов из переписок и звонков, включая неудобные.
2. Для каждого запишите правильный ответ или правильное действие («передать менеджеру»).
3. Прогоните вопросы через две-три модели с одной и той же инструкцией.
4. Отметьте: верно, неточно, выдумал. Отдельно — где бот не передал диалог человеку, хотя должен был.
5. Посчитайте средний расход токенов на вопрос — это основа для бюджета.
6. Выберите самую дешёвую модель, у которой нет выдуманных ответов в критичных темах: цены, сроки, гарантии.
7. Через месяц работы повторите тест на новых вопросах.

Такой тест занимает полдня и экономит месяцы споров о том, «умный бот или нет».

Мы собираем ботов и интеграции на YandexGPT и других моделях, подключаем к сайтам и CRM. Если хотите оценить задачу и бюджет до разработки, оставьте контакты.