API-ключ YandexGPT получаете в консоли Yandex Cloud за 10–15 минут: регистрируете аккаунт, создаёте сервисный аккаунт с нужной ролью, выпускаете ключ и привязываете его к каталогу для оплаты. Дальше ключ подставляется в любой сценарий — от формулы в Excel до чат-бота на сайте.
Регистрация в облаке
Весь путь от регистрации в Yandex Cloud до рабочего API-ключа занимает 10–15 минут, по нашему опыту внедрений: аккаунт, каталог, сервисный аккаунт и ключ — четыре коротких шага подряд.
Yandex Cloud — облачная платформа Яндекса, через которую идёт доступ к YandexGPT по API. Регистрация начинается с обычного аккаунта Яндекса, дальше сервис создаёт для вас первый каталог — рабочее пространство, где живут все ресурсы проекта.
- Зарегистрируйтесь или войдите в Yandex Cloud через аккаунт Яндекса
- Привяжите способ оплаты — карту или счёт для юрлица
- Создайте или откройте каталог проекта, где будет жить сервисный аккаунт
- Проверьте, что в каталоге включён нужный сервис — Foundation Models
Готовый обзор того, что можно собрать поверх этого API без глубокого программирования, — в статье про сервис настройки YandexGPT для бизнеса.
Каталог в Yandex Cloud — изолированное пространство с собственным биллингом и правами доступа: удобно завести отдельный каталог под каждый проект или продукт компании, чтобы расходы на токены оставались разделены между несвязанными задачами.
Наличие и размер стартового гранта в баллах на сервисы зависят от текущих условий Yandex Cloud на момент регистрации — точную сумму и срок действия стоит смотреть в разделе «Биллинг» сразу после создания аккаунта, ещё до привязки карты. Грант удобно потратить именно на тестовый запрос из следующего раздела, прежде чем переходить к боевому сценарию.
Создание сервисного аккаунта
Ключ выдаётся специальному сервисному аккаунту вместо личного — это отдельная техническая учётная запись именно для программного доступа, без пароля и личного входа в консоль.
- В разделе «Сервисные аккаунты» каталога создайте новый аккаунт с понятным именем
- Назначьте роль ai.languageModels.user — она даёт доступ именно к языковым моделям
- Откройте вкладку «Ключи API» у созданного сервисного аккаунта
- Нажмите «Создать ключ API» и сразу сохраните значение — второй раз оно остаётся недоступным нигде
| Способ доступа | Срок жизни | Когда удобен |
|---|---|---|
| API-ключ | Живёт до ручного отзыва | Простые сценарии, формулы, боты без сложной инфраструктуры |
| IAM-токен | Истекает через несколько часов | Серверные приложения с автоматическим обновлением токена |
Для большинства задач малого и среднего бизнеса — формулы в таблицах, простой чат-бот, разовый скрипт — хватает обычного API-ключа. IAM-токен усложняет сценарий постоянным обновлением и оправдан только на серьёзной production-нагрузке.
Имя сервисного аккаунта стоит выбирать так, чтобы через полгода было понятно, для какого именно сценария он создан — «bot-support», «excel-formulas» или «crm-integration» вместо безликого «service1». На практике в одном каталоге со временем накапливается несколько таких аккаунтов под разные задачи, и понятные имена экономят время при следующем аудите доступов.
Тариф и оплата
Оплата идёт по факту использования — за токены на входе и выходе запроса, отдельного фиксированного тарифа на подписку нет. Счёт выставляется на привязанный способ оплаты в конце расчётного периода.
Какой сценарий будет первым дёргать этот API-ключ?
Цена токена отличается между моделями линейки YandexGPT — облегчённая версия Lite стоит заметно дешевле полной модели Pro, и для простых задач вроде классификации коротких обращений разумно начинать именно с Lite. Переход на более тяжёлую модель имеет смысл только тогда, когда качества ответа Lite объективно недостаточно на конкретном сценарии.
Отдельная статья расхода, которую легко упустить на старте, — стоимость эмбеддингов или дополнительных функций вроде векторного поиска, если сценарий выходит за рамки простого текстового ответа. Эти операции тарифицируются отдельно от основной генерации текста, и в консоли каталога они видны отдельной строкой расходов.
Для юрлица оплата обычно идёт через счёт и договор вместо карты физлица — детали привязки счёта, НДС и закрывающих документов разобраны в статье про оплату Yandex Cloud для нейросети из России. Там же — где в расходах прячутся неочевидные траты.
Как проверить ключ
Перед тем как встраивать ключ в боевой сценарий, стоит отправить один тестовый запрос и убедиться, что модель возвращает текстовый ответ вместо ошибки доступа.
- Откройте терминал или консоль с установленным curl
- Соберите запрос с заголовком Authorization и вашим ключом
- Укажите модель и короткий тестовый текст в теле запроса
- Отправьте запрос и проверьте, что в ответе пришёл текст модели вместо кода ошибки
Частая первая ошибка — модель отвечает кодом доступа вместо текста, потому что сервисному аккаунту забыли назначить роль ai.languageModels.user на предыдущем шаге. Вторая по частоте — ключ скопирован с лишним пробелом на конце строки.
Полезно сохранить рабочий тестовый запрос в отдельном файле рядом с проектом — при следующем обновлении ключа или смене сервисного аккаунта его можно быстро прогнать заново и сразу увидеть, отвечает ли новая связка так же, как прежняя. Это особенно выручает, если ключ обновляет один человек, а пользуется им вся команда.
Если тестовый запрос уходит через curl, полезно сохранить и код ответа, и время выполнения — резкий рост времени ответа на одном и том же коротком тексте часто сигнализирует о проблемах на стороне сервиса раньше, чем это заметят конечные пользователи бота или скрипта.
Частые ошибки
- Ключ создан на личном аккаунте вместо сервисного — доступ нестабилен и рискует прерваться
- Роль назначена слишком широкая — сервисный аккаунт получает больше прав, чем реально нужно
- Ключ хранится открытым текстом в общем файле, доступном всей команде
- Забыт лимит бюджета в каталоге — расход по токенам замечают только по счёту в конце месяца
Сразу после создания ключа поставьте лимит расходов в консоли каталога — так резкий скачок трафика на новом сценарии остаётся предсказуемым расходом вместо сюрприза в конце месяца.
Как считается итоговая цена запроса и где расход растёт незаметно на реальном потоке — подробный разбор в статье про стоимость запросов YandexGPT API. Смежная задача — подключение того же ключа к рабочим таблицам компании — разобрана в статье про автоматизацию бизнес-процессов в разделе про автоматизацию бизнес-процессов.
Полезная привычка — раз в квартал заглядывать в список сервисных аккаунтов каталога и проверять, какие ключи реально используются, а какие остались от давно закрытых экспериментов. Неиспользуемый ключ с рабочими правами — лишняя точка риска, которую проще отозвать заранее, чем объяснять постфактум, откуда взялся чужой запрос в логах.