В интернете тысячи статей про YandexGPT, но нормальной инструкции, как получить API и сделать первый запрос, почти нет. Документация размазана по консоли, квикстартам и хабру. Собирал по кускам, спотыкался о платежи и роли. Сейчас покажу весь путь, от создания Яндекс ID до рабочего кода.
Что нужно для доступа к YandexGPT API
YandexGPT API - это не бесплатный публичный эндпоинт. За ним стоит Яндекс Облако, а значит: аккаунт, платёжный аккаунт, каталог, сервисный аккаунт и ключ. Без этого ничего не получится.
Список такой:
- Яндекс ID (лучше на номер телефона)
- Платёжный аккаунт в Yandex Cloud
- Облако и каталог
- Сервисный аккаунт с ролью playground.user
- API-ключ и folder_id
Звучит громоздко, но на деле это 15 минут внимательной работы. По шагам.
Создаём Яндекс ID
Зарегистрируйтесь, перейдя по ссылке на Яндекс.Почту или просто введите номер телефона. Регистрация по номеру самая быстрая - вам придёт код, и аккаунт готов. Не надо придумывать почту заранее, всё сделает система.
Дальше открываем консоль Yandex Cloud. При первом входе консоль сама предложит создать облако: нужно выбрать организацию или создать новую, подтвердить название облака. Жмите «Создать».
Подключаем оплату в Yandex Cloud
Без платёжного аккаунта доступ к YandexGPT не дадут. В консоли слева нажмите кнопку «Все сервисы» и выберите Yandex Cloud Billing. Там вас попросят привязать карту. Подходит любая карта, включая российские Visa и Mastercard - у Яндекса своя процессинговая система, санкции ей не мешают. Иногда нужно пополнить баланс, но обычно стартового гранта хватает, чтобы поиграться и сделать первые запросы. На Reddit практикующие разработчики советуют сразу настроить уведомления о расходе средств, иначе можно случайно потратить грант за вечер.
После активации биллинга вернитесь в консоль и создайте каталог, если он ещё не создан.
Создаём сервисный аккаунт и получаем ключ
Теперь самое интересное. В консоли слева выберите нужный каталог, затем откройте раздел «Сервисные аккаунты» внутри Identity and Access Management. Нажмите «Создать сервисный аккаунт», дайте ему имя и назначьте роль playground.user. Эта роль даёт право использовать YandexGPT.
После создания аккаунта в его карточке нажмите «Создать новый ключ» и выберите «Создать API-ключ». Система покажет ключ один раз - скопируйте его сразу, потом он будет скрыт. Где-то там же, в реквизитах, будет идентификатор каталога (folder_id). Эти две вещи - всё, что нужно для первого запроса.
Многие путаются, зачем нужен сервисный аккаунт, если есть личный. Сервисный - это техническая учётка для доступа к ресурсам. Через неё безопасно работать в коде, не светя основным аккаунтом.
Первый запрос к API через curl
Эндпоинт берём из квикстарта AI Studio - aistudio.yandex.ru. Либо используем стандартный https://llm.api.cloud.yandex.net/foundationModels/v1/completion. Авторизация идёт через Api-Key, каталог передаётся в заголовке x-folder-id.
curl -s \
-H "Authorization: Api-Key ${YANDEX_API_KEY}" \
-H "x-folder-id: ${FOLDER_ID}" \
-H "Content-Type: application/json" \
-d '{
"modelUri": "gpt://'"${FOLDER_ID}"'/yandexgpt",
"completionOptions": {"temperature": 0.3, "maxTokens": 200},
"messages": [{"role": "user", "text": "Проверка контрольного запроса"}]
}' \
"${YC_ENDPOINT}"Подставьте свои переменные окружения или замените их на реальные значения. Если всё сделано правильно, ответ вернёт JSON с текстом от модели.
Пример на Python для тех, кто не любит curl
В питоне всё то же самое, но через библиотеку requests. Установите её, если ещё нет - pip install requests. Код будет выглядеть примерно так:
import requests
API_KEY = "ваш_api_ключ"
FOLDER_ID = "ваш_folder_id"
body = {
"modelUri": f"gpt://{FOLDER_ID}/yandexgpt",
"completionOptions": {"temperature": 0.3, "maxTokens": 200},
"messages": [{"role": "user", "text": "Привет, расскажи анекдот"}]
}
response = requests.post(
"https://llm.api.cloud.yandex.net/foundationModels/v1/completion",
headers={
"Authorization": f"Api-Key {API_KEY}",
"x-folder-id": FOLDER_ID,
"Content-Type": "application/json"
},
json=body
)
print(response.json())Учтите, что модель yandexgpt в этом примере - базовая. В Яндекс есть и другие - YandexGPT Pro, Lite. Для более серьёзных задач меняйте modelUri, например на gpt://{folder_id}/yandexgpt/latest. Детали по моделям и тарифам ищите в документации облака.
Сколько стоит и как не прогореть
YandexGPT API - платный сервис. Цены зависят от модели и объёма токенов. На старте дают пробный грант, но потом деньги списываются с баланса. Следите за расходами в биллинге, иначе можно удивиться счёту. Для личных проектов токенов расходуется немного, для продакшена - уже ощутимо.
Если вы планируете работать не только с YandexGPT, но и с другими моделями - GPT, Claude, Gemini, DeepSeek - придётся регистрироваться в каждом сервисе отдельно, привязывать карты и разбираться с разными API. Это боль.
Обходной путь: все нейросети из России одним API
Есть способ проще. Запущен сервис 3GPT от 3SELLER - это ИИ-роутер, который даёт прямой доступ из России к флагманским моделям без иностранных карт и VPN. Chat GPT 6 Astra, Claude Fable 5, Claude Opus 5.5, Chat GPT 5.5, Chat GPT 6.1 Sol, Nano Banana для изображений и генерация видео. Всё это стоит от 149 ₽ и работает через российскую карту, СБП или крипту.
Подключаетесь на официальном сайте 3GPT, пополняете баланс, и получаете доступ ко всем моделям в одном месте. Никаких паспортов и путаницы с folder_id.
Используйте для повседневных задач в бизнесе и в работе. Создавайте продающие тексты, сайты, обрабатывайте реалистичные изображения, генерируйте видео и голос. Всё это - прямо из браузера.
Отдельная фишка - готовые ИИ-агенты под ваши задачи. Смотрите список на странице агентов, выбирайте нужного и общайтесь в чате. Модель агента можно менять прямо по ходу разговора.
Если хочется стабильности и одной точки входа для всех нейросетей - 3GPT решает эту задачу лучше, чем самостоятельный сбор API.
Теперь у вас есть рабочий рецепт: Яндекс ID, платёжный аккаунт, сервисный аккаунт, ключ, folder_id, первый запрос. Если возиться с каждым API по отдельности не хочется, попробуйте 3GPT - все флагманские модели в одном окне за 149 ₽. Выбор за вами.