YandexGPT (Yandex AI Studio): ключ и каталог

Где взять ключ

Ключ выдаёт консоль Yandex Cloud. Порядок такой:

1. Создайте сервисный аккаунт.

   Ему нужна роль на AI Studio — через неё аккаунт получает доступ к моделям.

2. Создайте для него API-ключ.

   В консоли это кнопка «Создать API-ключ». Область действия ключа — yandex.cloud.ai.foundation-models.execute: именно она открывает доступ к моделям.

3. Скопируйте готовый ключ.

   Он вставляется в поле «API-ключ» редактора провайдера и хранится на вашем компьютере — наружу приложение его не отдаёт.

Авторизацию приложение подбирает само: отдельно настраивать здесь нечего.

Подключение по шагам

1. В «Настройки» → «Провайдеры» нажмите шаблон «YandexGPT (Yandex AI Studio)».

   Адрес сервера, тип API и три модели подставятся сами.

2. Вставьте API-ключ.

   Больше ничего заполнять не обязательно.

3. Нажмите «Проверить связь».

   Приложение заберёт у шлюза список моделей и заодно попробует определить каталог.

4. Проверьте «Модель по умолчанию» и нажмите «Сохранить».

   Подключение появится в списке сверху с типом API, числом моделей и пометкой о ключе.

5. Включите «Использовать этого провайдера сейчас», если хотите отвечать через YandexGPT.

   То же делает кнопка «Сделать активным» в списке подключений.

В шаблоне три модели: YandexGPT 5.1 Pro, YandexGPT и YandexGPT Lite. В чате показывается название из правой колонки, а в запрос уходит имя модели из левой. Модели можно добавлять, переименовывать и удалять построчно — как у любого провайдера, об этом рассказано в статье Провайдеры и модели.

Каталог: обычно его определять не нужно

Модель у Яндекса задаётся полным адресом вида gpt://<каталог>/<модель>/<версия>, поэтому к каждому запросу прикладывается идентификатор каталога — тот самый b1g… из консоли. По нему Яндекс понимает, на какой каталог отнести расходы.

Поле «Каталог (Folder ID)» можно оставить пустым. Когда вы нажмёте «Проверить связь» или «Обновить список моделей», приложение само попробует выяснить каталог: шлюз отдаёт список моделей уже с каталогом внутри, и он подставляется в поле. Если шлюз без каталога список не отдаёт, приложение прямо об этом скажет — тогда скопируйте b1g… из консоли рядом с ключом и впишите руками.

Короткие имена моделей превращаются в полный адрес автоматически: yandexgpt и yandexgpt-5.1 из левой колонки уходят как URI. Полный URI тоже можно вписать руками — он уйдёт как есть, без переделки.

Что видно в списке подключений

Отсюда подключением можно управлять: «Изменить» снова открывает редактор, переключатель выключает провайдера на время (настройки и ключ остаются), повторное нажатие возвращает модели в меню чата. Если выключить активного провайдера, активным станет первый включённый с моделями, а когда выключены все — приложение подскажет об этом внизу.

Чего у YandexGPT нет

• Генерации изображений. Картинки рисует отдельный сервис Яндекса, YandexART, — в «Овации» он не подключён. В чате об этом есть честное предупреждение, а не молчаливый пропуск.
• Уровней мышления в интерфейсе. У моделей Яндекса свой параметр рассуждений, и он пока не подключён: пилюли с уровнями у этих моделей вы не увидите.

Инструменты агента, наоборот, работают: поиск в интернете и чтение библиотеки описаны у Яндекса так же, как у OpenAI, поэтому агенты ведут книгу по этапам и здесь.

Дальше по теме: Провайдеры и модели, GigaChat, Локальные модели.