Подключение Яндекса за 10 минут

На тарифе «Про» Домовой работает на вашем ключе Яндекса: модели и голос оплачиваются напрямую Яндексу по его тарифам, мы не видим суммы в ваших счетах. Ключ создаётся один раз — дальше всё работает само.

Это дешевле, чем кажется. Новым аккаунтам Яндекс даёт стартовый грант 4 000 ₽ на 60 дней — его хватает на месяцы обычного использования. Понадобится только аккаунт Яндекса (тот же, что для Почты/Диска).

1 Войдите в консоль Yandex Cloud

Откройте console.yandex.cloud и войдите своим аккаунтом Яндекса. При первом входе консоль сама создаст облако и каталог default — ничего настраивать не нужно, подойдёт любой каталог.

Справа вверху видно и стартовый грант — он списывается раньше ваших денег:

Стартовый грант 4 000 ₽ на 60 дней в консоли Yandex Cloud

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

На главной странице консоли нажмите «⋯» рядом с каталогом → «Создать сервисный аккаунт».

Меню каталога: пункт «Создать сервисный аккаунт»

В форме укажите любое имя (например, domovoy) и добавьте три роли:

ai.languageModels.user — модели (текст);
ai.speechkit-stt.user — распознавание речи (микрофон);
ai.speechkit-tts.user — озвучка ответов.

Форма создания сервисного аккаунта с тремя ролями

Нажмите «Создать» — появится подтверждение «Сервисный аккаунт успешно создан».

3 Откройте созданный аккаунт

На главной странице консоли найдите карточку Identity and Access Management и нажмите «Сервисный аккаунт», либо откройте сервис IAM из меню слева.

Карточка Identity and Access Management с сервисным аккаунтом

В списке кликните по имени своего аккаунта:

4 Создайте API-ключ

На странице аккаунта нажмите «+ Создать новый ключ» (кнопка сверху) и выберите средний пункт — «Создать API-ключ».

Страница сервисного аккаунта с кнопкой «Создать новый ключ»

В поле «Область действия» отметьте разрешения (можно выбрать все yc.ai.* — лишними не будут):

yc.ai.languageModels.execute — модели;
yc.ai.speechkitStt.execute и yc.ai.speechkitTts.execute — голос;
остальные yc.ai.* (foundationModels, imageGeneration, translate, vision) — по желанию.

Выбор областей действия yc.ai.* для API-ключа

Описание — любое, срок действия можно оставить пустым или поставить год-два вперёд:

Форма нового ключа: описание, область действия, срок

5 Скопируйте секретный ключ

После нажатия «Создать» появится окно с ключом. Скопируйте «Ваш секретный ключ» (строка, начинающаяся с AQVN…) — он показывается только один раз.

Окно с созданным API-ключом: секретный ключ показывается один раз

Если окно закрылось раньше, чем вы скопировали ключ, — не страшно: создайте новый API-ключ тем же способом (шаг 4), старый можно удалить.

6 Скопируйте Folder ID (id каталога)

Вернитесь на главную страницу консоли. В шапке видны два идентификатора: слева — облако, справа — каталог (обычно default). Оба начинаются с b1g — нужен именно правый, id каталога. Нажмите «⋯» рядом с каталогом → «Скопировать идентификатор».

Folder ID обязателен: именно по нему модели, голос и картинки оплачиваются с вашего кошелька Яндекса (грант расходуется у вас, а не у нас).

7 Вставьте ключ и Folder ID в Домового

Откройте страницу подключения ключей, вставьте секретный ключ в поле «API-ключ» карточки Yandex Cloud, а id каталога — в поле «Folder ID», и нажмите «Проверить и сохранить». Мы сразу проверим пару «ключ + каталог» живым запросом к Яндексу и покажем результат.

Ключ хранится в зашифрованном виде (AES-256-GCM), его можно удалить в любой момент на той же странице.

Открыть страницу ключей