Для подключения YandexGPT к своему проекту сначала придется пройти квест под названием "получи API-ключ". Спойлер: ничего сложного, но есть пара подводных камней. Зато потом открывается доступ к одной из лучших отечественных нейросетей. Давай разберем по шагам, без лишней воды.
Шаг первый: заводим сервисный аккаунт в Yandex Cloud
API-ключ не висит в воздухе. Он привязан к сервисному аккаунту - это такой технический пользователь, от имени которого приложение стучится в Яндекс. Заходишь в консоль управления Yandex Cloud, выбираешь облако и каталог (или создаешь новой. Внутри каталога идешь в раздел "Сервисные аккаунты" (он же Identity and Access Management, IAM. Жмешь "Создать сервисный аккаунт", имя можешь дать любое, хоть "my-gpt-bot".
Теперь главное: этому аккаунту надо выдать роль. В документации Яндекс советуют роль playground.user. Именно она разрешает доступ к YandexGPT. В видеоуроках часто мелькает другая: ai.languageModels.user. По сути обе рабочие, но если хочешь точно по инструкции - бери playground.user. Назначение роли делается при создании аккаунта, либо потом через редактирование.
Шаг второй: создаем API-ключ
Когда сервисный аккаунт готов, открываешь его карточку. В верхней панели жмешь "Создать новый ключ", затем "Создать API-ключ". Описание можно не заполнять, но если у тебя несколько ключей - лучше подписать, чтобы потом не гадать.
Яндекс покажет тебе два значения: сам ключ и его идентификатор. Ключ отображается только один раз! Сразу копируй его в надежное место, иначе придется пересоздавать. Этот ключ будет использоваться для авторизации в каждом запросе к API.
Шаг третий: не забудь про folder_id и платежный аккаунт
Для вызова YandexGPT одного ключа мало. Нужен еще идентификатор каталога - тот самый folder_id. Его видно в консоли, в свойствах каталога. Без него запрос просто не пройдет: в modelUri надо подставлять gpt://твой_folder_id/yandexgpt.
И да, Яндекс не работает бесплатно. Придется создать платежный аккаунт и привязать карту. Потом тарификация за токены. Если хочешь сэкономить нервы и деньги - проще не мучиться с облаком, а взять готовый доступ через 3GPT. Он открывает все флагманские нейросети из России за 149 рублей в месяц. Никаких иностранных карт не нужно.
Шаг четвертый: делаем тестовый запрос
Когда все ключи на руках, проверяем связку. Пишем curl-запрос, как в документации:
curl -s \n -H "Authorization: Api-Key ${YANDEX_API_KEY}" \n -H "x-folder-id: ${FOLDER_ID}" \n -H "Content-Type: application/json" \n -d '{ "modelUri": "gpt://'"${FOLDER_ID}'"'/yandexgpt", "completionOptions": {"temperature": 0.3, "maxTokens":2 00}, "messages": [{"role": "user", "text": "Привет"}] }' \n "${YC_ENDPOINT}"Эндпоинт берешь из Quickstart AI Studio (обычно https://llm.api.cloud.yandex.net/foundationModels/v1/completion). Если в ответ получаешь осмысленный текст - поздравляю, ты справился. Если ошибка - проверь, что роль назначена, folder_id правильный, а ключ скопирован целиком.
Альтернатива без боли: 3GPT
Возня с API ключами и платежками - это не то, чем хочется заниматься, когда надо просто сделать продукт. Я часто рекомендую 3GPT.3GPT - это ИИ-роутер, который дает из России прямой доступ к последним моделям: Chat GPT 6, Claude Fable 5.1, Claude Opus 5.5, Chat GPT 6.1 Sol, Nano Banana для изображений, генерация видео и многое другое.
Пополняешь баланс российской картой, через СБП или криптой - без всяких иностранных платежных систем. Запустили недавно 3GPT от 3SELLER, так что сервис свежий и шустрый. Вот ссылка: https://3seller.com/3gpt.
Бонус: ИИ-агенты для типовых задач
Даже если ты не программист и не хочешь дергать API напрямую, у 3GPT есть готовая библиотека ИИ-агентов. Просто выбираешь нужного, начинаешь общаться - и модель можно менять прямо в чате. Удобно для бизнеса: создавать продающие тексты, генерировать изображения, монтировать видео, озвучку - все в одном окне.
Если все же хочешь именно YandexGPT API ради кастомной интеграции - действуй по шагам выше: сервисный аккаунт, роль playground.user, API-ключ, folder_id, платежный аккаунт. Это реально работает. А если задача просто пользоваться нейросетями из России и не париться - -3GPT уже все настроил за тебя.