Как подключить YandexGPT: инструкция для чата и API

Подключить YandexGPT можно двумя совершенно разными способами. Если вам нужно просто поговорить с моделью, достаточно открыть Алису AI и написать запрос. Если модель должна отвечать внутри вашего сайта, бота или скрипта, потребуется Yandex AI Studio, каталог Yandex Cloud, платёжный аккаунт и API-ключ.

Главная путаница здесь возникает из-за одного названия. Чат Алисы — готовый пользовательский интерфейс. API — способ отправлять запросы из программы. Открытый чат не превращает Алису в подключённую к вашему приложению модель, а созданный ключ не нужен для обычного диалога в Поиске.

Как начать пользоваться YandexGPT без программирования

Для личного использования откройте Алису AI в Поиске или чат Алисы в приложении Яндекса. При необходимости войдите в Яндекс ID, выберите доступный интерфейс Алисы и отправьте сообщение. Расположение кнопок и их названия могут меняться, поэтому ориентироваться лучше на сам актуальный интерфейс, а не на старую инструкцию со скриншотом.

Первый запрос можно сделать таким:

Составь план поездки в Казань на два дня с бюджетом 20 000 рублей.

Ответ не обязан быть окончательным. Уточните ограничения следующим сообщением: например, попросите оставить только поезд и общественный транспорт, добавить места для прогулок под дождём или разделить расходы по дням. В этом и состоит практический смысл чата: не угадывать идеальную формулировку с первой попытки, а постепенно сужать задачу.

Как подключить YandexGPT к приложению

Программный маршрут начинается в Yandex AI Studio. В общих чертах последовательность такая:

1. Войдите в Yandex Cloud и выберите или создайте каталог, в котором будет работать приложение.
2. Проверьте, что к каталогу подключён активный платёжный аккаунт.
3. Создайте API-ключ по инструкции Yandex AI Studio.
4. Запомните идентификатор каталога: он понадобится в имени модели.
5. Отправьте первый запрос к API и проверьте ответ.

Для API не стоит заранее считать доступ постоянным или бесплатным. Квоты, тарифы и доступные лимиты меняются, поэтому их нужно проверить в актуальной консоли AI Studio перед запуском приложения.

В совместимом с OpenAI варианте из быстрого старта используется базовый URL https://ai.api.cloud.yandex.net/v1. Модель записывается в виде gpt://<идентификатор_каталога>/aliceai-llm. Ниже — сокращённый пример через cURL. Значения в угловых скобках замените своими, а настоящий секрет не вставляйте в файл проекта.

curl https://ai.api.cloud.yandex.net/v1/responses \
  -H "Authorization: Api-Key <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt://<CATALOG_ID>/aliceai-llm",
    "input": "Придумай три идеи для стартапа в сфере путешествий"
  }'

В официальном quickstart AI Studio есть аналогичные примеры для Python, Node.js, cURL и других вариантов. Меняться могут формат отдельных параметров и доступные методы, поэтому перед переносом примера в рабочий код сверьтесь с текущей документацией быстрого старта.

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

API-ключ — это секрет, а не идентификатор приложения. Не публикуйте его в Git-репозитории, клиентском JavaScript, скриншотах, сообщениях и открытых примерах. Для локальной разработки храните значение в переменной окружения или другом хранилище секретов, а сервер пусть подставляет его при выполнении запроса.

Если ключ уже попал в код или переписку, считайте его скомпрометированным: удалите старый и создайте новый. Восстановить прежний секрет нельзя. Подробнее о создании и замене ключей описано в инструкции Yandex AI Studio и разделе «API-ключ».

Что выбрать в вашем случае

Если задача звучит как «хочу задать вопрос YandexGPT», начинайте с чата Алисы. Вам не нужны каталог, платёжный аккаунт и программный ключ.

Если задача звучит как «пусть модель отвечает пользователю в моём приложении», открывайте AI Studio и настраивайте API. Проверьте каталог и платёжный аккаунт, создайте ключ, сохраните его вне исходного кода и выполните тестовый запрос к aliceai-llm.

Так проще не перепутать два похожих входа. Алиса отвечает вам в готовом интерфейсе, а API даёт приложению возможность делать запросы самостоятельно. Подключение одного маршрута не означает, что второй уже настроен.

Если вам нужен другой AI-сервис для похожей задачи, можно посмотреть каталог Amber Market. Это дополнительный посреднический маршрут для пользователей из России, а не способ подключить именно YandexGPT и не замена официальному API Яндекса. Доступность, условия и итоговую стоимость конкретного предложения проверьте в карточке перед оформлением.