Яндекс GPT на первый взгляд выглядит просто. На деле подключение к нему через официальный API заставляет понервничать. Я прошёл этот путь, наступил на пару граблей и теперь показываю по шагам, как завести YandexGPT в свой проект без лишней боли.
YandexGPT живёт внутри Yandex Cloud. Отдельного сервиса нет, поэтому подключение идёт через облако. Нужно завести платёжный аккаунт, создать каталог, получить API-ключ и держать под рукой идентификатор каталога. Дальше модель вызывается по строке вида gpt://идентификатор-каталога/yandexgpt/latest.
Для подключения нужны четыре вещи
Официальный способ требует четырёх вещей. Без них никуда.
- Яндекс ID, подойдёт аккаунт от почты или номер телефона.
- Платёжный аккаунт в Yandex Cloud с привязанной картой.
- API-ключ или IAM-токен для авторизации.
- Идентификатор каталога, в котором будет работать модель.
Если у вас нет хотя бы одной позиции из списка, придётся начинать с неё. Самое муторное: платёжный аккаунт, потому что без него YandexGPT API не даст даже попробовать.
Регистрация Yandex ID и создание облака
Регистрация Яндекса проходит по номеру телефона. Переходите на главную страницу, вводите номер, получаете код, готово. Пять минут, и аккаунт у вас.
Дальше отправляетесь в консоль Yandex Cloud и нажимаете «Подключиться». Система предложит создать организацию и подтвердить название облака. Соглашайтесь. При создании организации автоматически появится облако с каталогом. Этот каталог станет вашим рабочим пространством для YandexGPT.
В консоли слева вы увидите список каталогов. А ещё левее кнопка меню «Все сервисы». Она пригодится, когда пойдёте настраивать биллинг.
Платёжный аккаунт без сюрпризов
YandexGPT API платный: не подписка, а биллинг по факту использования. Тарифы указаны на сайте Yandex Cloud, но главное: сначала нужно привязать карту.
В меню «Все сервисы» выберите Yandex Cloud Billing. Нажмите «Создать». Процесс простой, но потребует пластиковую карту. Совет от практика: перед привязкой карты выключите VPN, иначе проверка может не пройти. На Reddit в обсуждениях про YandexGPT этот совет всплывает постоянно. После создания аккаунта баланс можно пополнить, а можно и не пополнять: деньги начнут списываться только после первого запроса.
API-ключ и идентификатор каталога
Теперь возвращаемся в консоль управления. В списке каталогов выберите нужный, нажмите на иконку «Действия» и создайте сервисный аккаунт. Дайте ему имя и роль. Для работы с YandexGPT достаточно роли ai.languageModels.user, но если планируете использовать и другие сервисы облака, можно взять editor.
После создания сервисного аккаунта откройте его и создайте API-ключ. Скопируйте ключ и идентификатор каталога. Идентификатор лежит в свойствах каталога, он выглядит как короткая строка из букв и цифр. Эти два значения понадобятся для запроса.
Кстати, вместо API-ключа можно использовать IAM-токен, но для разовых экспериментов ключ проще. Он не протухает так быстро и его удобно хранить в переменной окружения.
Первый запрос на Python
Теперь самое интересное. Откройте Python-файл и реализуйте вызов API. Я покажу на requests, потому что это нагляднее всего.
import requests
catalog_id = "ваш-каталог"
api_key = "ваш-ключ"
body = {
"modelUri": f"gpt://{catalog_id}/yandexgpt/latest",
"messages": [
{"role": "system", "text": "Ты полезный ассистент."},
{"role": "user", "text": "Привет! Расскажи анекдот."}
]
}
resp = requests.post(
"https://llm.api.cloud.yandex.net/foundationModels/v1/completion",
headers={"Authorization": f"Api-Key {api_key}"},
json=body
)
print(resp.json())Если всё сделано правильно, в ответе будет текст от модели. На этом этапе многие начинают радоваться, а потом упираются в ограничение: у YandexGPT небольшое окно контекста. Для разовых запросов хватает, а для длинных диалогов придётся резать историю или выбирать другую модель.
У YandexGPT есть и OpenAI-совместимый эндпоинт, так что если вы привыкли к библиотеке openai, можно использовать её. Но суть та же: нужен каталог и ключ.
Интеграция с Test IT
Если ваша команда работает в Test IT, подключить YandexGPT можно прямо в интерфейсе. Нужен аккаунт администратора. Переходите в раздел «Администрирование», выбираете вкладку «Интеграции», жмёте «Создать». В списке сервисов выбираете YandexGPT, заполняете имя интеграции и API-ключ, сохраняете.
После этого интеграцию нужно добавить в проект, и тогда появится возможность генерировать тестовые сценарии с помощью ИИ. Удобно, но и здесь API-ключ нужен свой, а значит, всё вышеописанное остаётся в силе.
Когда YandexGPT подходит, а когда нет
YandexGPT отлично справляется с русским языком. На типовых задачах: суммаризация, генерация текста, ответы на вопросы. Плюс оплата в рублях с расчётного счёта и обработка данных внутри РФ. Для компаний, которым важен 152-ФЗ, это серьёзный аргумент.
Но есть и потолок. Небольшое окно контекста ограничивает работу с длинными документами и сложными диалогами. Для мультимодальных задач: картинки, видео, голос. YandexGPT не подходит. Тут нужны другие модели.
Куда проще: 3GPT для повседневных задач
Честно говоря, вся эта возня с консолью, сервисными аккаунтами и биллингом оправдана, только если вы разработчик и встраиваете модель в свой продукт. Для обычных задач, будь то написать текст, сгенерировать картинку или собрать код, проще взять готовый сервис, где уже всё настроено и работает из коробки.
Здесь на помощь приходит 3GPT от 3SELLER. Сервис работает как ИИ-роутер и даёт доступ ко всем флагманским нейросетям из России. Цена: 149 рублей. Оплата российской картой, СБП или криптой. Никаких иностранных платежей и зарубежных карт.
Внутри есть Chat GPT 6 Astra, Claude Fable 5, Claude Fable 5.1, Claude Opus 5.5, Chat GPT 5.5 и Chat GPT 6.1 Sol. Для изображений: Nano Banana. Для видео: генерация роликов. Плюс готовые ИИ-агенты под конкретные задачи.
Выбираете модель, пишете запрос, получаете результат. Например, Nano Banana отрисует логотип для сайта за пару минут, а Claude Fable 5 соберёт структуру продающего письма. Никаких каталогов, API-ключей и платёжных аккаунтов. Для человека, которому нужен результат, а не процесс, это спасение.
Получить доступ можно на официальном сайте 3GPT: https://3seller.com/3gpt. Там же можно пополнить баланс картой любого российского банка, через СБП или криптовалютой.
Отдельная фишка: ИИ-агенты. Они представляют собой готовые сценарии для ваших задач: продающий текст, сайт, обработка изображений. Вы просто выбираете агента и общаетесь с ним, а модель внутри можно менять прямо в чате. Посмотреть список агентов можно здесь: https://3seller.com/ai/agents.
Что выбрать: официальный API или 3GPT
Если вы подключаете Яндекс GPT как API внутри собственного приложения, используйте официальную инструкцию выше. Создайте Yandex ID, привяжите карту, получите ключ и вызывайте модель. Путь рабочий, просто требует времени.
Если же нужна нейросеть для текстов, картинок и видео без головной боли, 3GPT решает задачу за пять минут. Вы платите 149 рублей, выбираете модель из списка и работаете. Ссылка на сервис: https://3seller.com/3gpt.