YandexGPT API без Yandex Cloud
Модели Яндекса в Polza.ai работают по общему ключу каталога: без организации в облаке, каталога, сервисного аккаунта и folder_id в каждом запросе. В каталоге Polza.ai — 7 моделей Яндекса, у всех данные хранятся в России.
- Alice AI LLM и YandexGPT Pro 5.1
- Без folder_id и ролей
- Данные хранятся в РФ
- Карта РФ, СБП и счёт для юрлиц
# один запрос, чтобы убедиться, что всё работает
curl https://polza.ai/api/v1/chat/completions \
-H "Authorization: Bearer $POLZA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "yandex/aliceai-llm",
"messages": [{"role": "user", "content": "Привет"}]}'
- моделей YandexGPT
- 7
- типа задач
- 3
- токенов контекста
- 32 000
- за 1M токенов входа
- 284 ₽
Что доступно по ключу
Текстовые модели Alice AI и YandexGPT, генерация картинок YandexArt и пара эмбеддингов для поиска — отдельно для запросов и для документов.
Чат-модели
4YandexGPT Lite 5, YandexGPT Pro 5.1, YandexGPT Pro 5
/chat/completions
Генерация изображений
1YandexArt
/images/generations
Эмбеддинги
2YandexGPT Embeddings — Query, YandexGPT Embeddings — Doc
/embeddings
Почему напрямую не выходит
Яндекс — российский вендор, и оплата здесь не главное. Упирается всё в облако, которое приходится заводить ради одного API.
Облако ради одного API
Напрямую нужны организация и облако в Yandex Cloud, каталог и платёжный аккаунт с привязанной картой — до первого запроса.
Сервисный аккаунт и роли
Права выдаются через сервисный аккаунт: роль на использование моделей и ключ с нужной областью действия. Ошибка в роли — отказ в доступе.
folder_id в каждом запросе
Каталог передаётся и в настройках клиента, и в имени модели: gpt://<folder_id>/aliceai-llm. Перенос на другой каталог — правка во всех вызовах.
Модели выводят из API
YandexGPT Lite 5 Яндекс отключает 15 ноября 2026 года. Идентификаторы приходится отслеживать и менять.
Как получить ключ
Аккаунт в Yandex Cloud для этого не нужен: ключ выпускается в кабинете Polza и работает сразу со всеми вендорами каталога.
- 1
Зарегистрируйтесь
Почта и пароль. Телефон другой страны и зарубежная карта не нужны.
- 2
Создайте ключ
Раздел «API-ключи» в кабинете. Ключ начинается с
pza_— скопируйте его сразу, второй раз он не показывается. Ключей можно завести несколько: по одному на сервис или на сотрудника. - 3
Пополните баланс
Карта РФ, СБП или счёт для юрлица. Минимальное пополнение — 100 ₽, этого хватает на 140 запросов к самой дешёвой модели YandexGPT.
- Получить API-ключДокументация
# ключ из кабинета начинается с pza_
export POLZA_API_KEY=pza_...
# один запрос — и видно, что ключ живой
curl https://polza.ai/api/v1/models \
-H "Authorization: Bearer $POLZA_API_KEY"Адреса API
Слева то, что вы прописали бы при прямом доступе к YandexGPT, справа — что поставить вместо этого.
| YandexGPT напрямую | Через Polza.AI | |
|---|---|---|
| Базовый адрес | https://ai.api.cloud.yandex.net/v1 | https://polza.ai/api/v1 |
| Переменная с ключом | $YANDEX_CLOUD_API_KEY | $POLZA_API_KEY |
| Идентификатор модели | gpt://<folder_id>/aliceai-llm | yandex/aliceai-llm |
Пути после базового адреса стандартные. У моделей YandexGPT задействованы: /chat/completions, /embeddings, /images/generations, /media.
Что меняется в коде
Уходят каталог и folder_id в имени модели. Клиент тот же OpenAI SDK, меняются адрес, ключ и идентификатор.
import os
from openai import OpenAI
FOLDER = os.environ["YANDEX_CLOUD_FOLDER"]
client = OpenAI(
api_key=os.environ["YANDEX_CLOUD_API_KEY"],
base_url="https://ai.api.cloud.yandex.net/v1",
project=FOLDER,
)
resp = client.chat.completions.create(
model=f"gpt://{FOLDER}/aliceai-llm",
messages=[{"role": "user", "content": "Привет"}],
)import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["POLZA_API_KEY"],
base_url="https://polza.ai/api/v1",
)
resp = client.chat.completions.create(
model="yandex/aliceai-llm",
messages=[{"role": "user", "content": "Привет"}],
)Ключ берётся в кабинете Polza. Облако, каталог и сервисный аккаунт для него не нужны.
Что умеет API
Цифры — сколько моделей Яндекса в каталоге поддерживают эту возможность. Считается по самому каталогу, а не заявлено на словах.
Вызов функций
Модель сама решает, когда дёрнуть вашу функцию, и передаёт аргументы.
tools
Строгий JSON
Ответ приходит по заданной схеме — без парсинга текста регулярками.
response_format
Рассуждение
Промежуточные шаги считаются отдельно и приходят отдельным полем.
reasoning
Картинка на входе
В сообщение можно положить изображение вместе с текстом.
vision
Есть ли бесплатный доступ
Бесплатного тарифа в Polza.ai нет — вы платите за токены. Но порог низкий: минимальное пополнение 100 ₽. Ниже видно, во что это выходит на практике.
| Модель | Один запрос | 1 000 запросов | Запросов на 100 ₽ |
|---|---|---|---|
yandex/aliceai-llm | 2,27 ₽ | 2 272 ₽ | 44 |
yandex/yandexgpt-5.1-pro | 2,84 ₽ | 2 840 ₽ | 35 |
yandex/yandexgpt-5-pro | 4,26 ₽ | 4 260 ₽ | 23 |
За запрос считаем 2 000 токенов на входе и 500 на выходе — это примерно страница текста в вопросе и абзац в ответе.
Отдельно про «бесплатные ключи», которые раздают в каналах и на форумах: это либо чужой ключ, либо прокси поверх чужого. Работает до первой блокировки, а промпты при этом уходят неизвестно куда. Для рабочего проекта не годится.
Модели и цены
Polza.ai показывает цены за миллион токенов в рублях и обновляет их каждый час. Подписки в Polza.ai нет: вы платите за то, что израсходовали, остаток не сгорает.
| Модель | Тип | Контекст | Вход · 1M | Выход · 1M |
|---|---|---|---|---|
| yandex/aliceai-llmAlice AI LLM — флагман Яндекса для диалогов | Чат-модели | 32 000 | 710 ₽ | 1 704 ₽ |
| yandex/yandexgpt-5.1-proYandexGPT Pro 5.1 — рабочие задачи и документы | Чат-модели | 32 000 | 1 136 ₽ | 1 136 ₽ |
| yandex/yandexgpt-5-proYandexGPT Pro 5 — анализ и извлечение данных | Чат-модели | 32 000 | 1 704 ₽ | 1 704 ₽ |
| yandex/yandex-artYandexArt — генерация изображений | Генерация изображений | — | — | — |
| yandex/text-search-docЭмбеддинги документов для поиска | Эмбеддинги | — | 14,44 ₽ | — |
| yandex/text-search-queryЭмбеддинги поисковых запросов | Эмбеддинги | — | 14,44 ₽ | — |
Это выборка. Полный список — 7 моделей YandexGPT и ещё 390 моделей у других вендоров — в каталоге.
Прямой доступ и доступ через Polza
| YandexGPT напрямую | Через Polza.AI | |
|---|---|---|
| Оплата | Платёжный аккаунт в Yandex Cloud | Карта РФ, СБП, счёт для юрлица |
| Доступ | Облако, каталог, сервисный аккаунт | Ключ из кабинета |
| Документы | Свои договор и УПД у каждого вендора | Один договор и одни УПД на все модели |
| Цены | По тарифам Yandex Cloud | За токены, баланс не сгорает |
| Модели других вендоров | Отдельный договор и ключ | Тот же ключ, 397 моделей |
| Если модель отвалилась | Ждать | Поменять строку с моделью |
| Код | OpenAI SDK с folder_id | Тот же SDK, другой Base URL |
Если не работает
6 причин, на которые приходится почти вся переписка с поддержкой: сначала коды ответов, потом то, что встречается именно с моделями Яндекса.
401 Unauthorized или Invalid API key
Ключ скопирован не целиком или взят из другого проекта. Рабочий ключ начинается с pza_ и передаётся заголовком Authorization: Bearer pza_.... Ключ Yandex Cloud здесь не подойдёт.
402 или «недостаточно средств»
Кончился баланс. Он общий на все модели и не сгорает — пополните в кабинете картой, через СБП или по счёту, ключ менять не нужно.
404 на модели
Забыт префикс вендора. Не aliceai-llm, а yandex/aliceai-llm — идентификатор целиком, как в каталоге. Проверить написание можно запросом к /api/v1/models.
429 Too Many Requests
Слишком много запросов в секунду к конкретной модели. Это ограничение вендора, а не баланса: помогает повтор с задержкой или переключение на соседнюю модель в той же линейке.
Модель с gpt:// не находится
Формат gpt://<folder_id>/... — только для облака Яндекса. Здесь идентификатор короткий: yandex/aliceai-llm.
Поиск по эмбеддингам находит не то
У Яндекса две модели эмбеддингов: документы векторизуются yandex/text-search-doc, запросы — yandex/text-search-query. Если перепутать, точность падает.
Для команд и юрлиц
Счёт, УПД и НДС
Оплата по счёту для ООО и ИП, договор с российским юрлицом, закрывающие документы каждый месяц.
Ключ на сотрудника
Отдельные ключи с общим балансом организации: видно, кто и сколько потратил.
Контроль бюджета
Статистика расходов по ключам и моделям в кабинете, без сюрпризов в конце месяца.
Помощь с переездом
Поможем перевести команду с зарубежных подписок на API: настройка окружений и правила расходования.
Вопросы и ответы
Зачем через Polza.ai, если Яндекс и так российский?
Не из-за оплаты, а из-за подключения. Напрямую нужны облако, каталог, платёжный аккаунт и сервисный аккаунт с ролями, а folder_id попадает в каждый запрос. Polza.ai выдаёт один ключ на все модели каталога.
Что брать на новый проект?
Alice AI LLM или YandexGPT Pro 5.1. YandexGPT Lite 5 Яндекс отключает 15 ноября 2026 года, начинать на ней не стоит.
Где хранятся данные?
У всех моделей Яндекса в каталоге Polza.ai стоит отметка о хранении данных в России.
Есть ли генерация картинок?
Да, YandexArt. Она идёт через эндпоинт изображений `/images/generations`, а не через чат.
Можно оплатить по счёту?
Да. Polza.ai выставляет счёт для ООО и ИП, заключает договор с российским юрлицом и каждый месяц присылает закрывающие документы. Ключи выдаются на сотрудников, баланс общий.
А другие вендоры?
Тот же ключ Polza.ai открывает 397 моделей. Чтобы уйти с YandexGPT на другого вендора, достаточно поменять строку с идентификатором модели.
Работает там, где вы уже работаете
Редакторы, десктоп-клиенты, чаты для команды, конструкторы сценариев и фреймворки. Ключ и баланс везде одни и те же, меняется только адрес API. На каждый инструмент есть разбор по шагам.
Редакторы и агенты в коде
Ставятся в редактор или запускаются в терминале. Читают проект, правят файлы, гоняют тесты.
Десктоп-клиенты
Обычные приложения с окном чата: поставили, вписали ключ и работаете.
Свой чат для команды
Веб-интерфейс на своём сервере: общий доступ для коллег, история, документы. Рядом с локальными моделями работают облачные через тот же ключ.
Автоматизация и фреймворки
Сценарии, боты и собственные сервисы — там, где модель вызывается из кода или из ноды.
Подсвечены те, для которых эта страница подходит лучше всего. Остальные работают с тем же ключом.
Другие вендоры по тому же ключу
Менять договор и заводить второй ключ не нужно: вендор переключается строкой с идентификатором модели.
Кто проверял эту инструкцию

Руководитель техподдержки · редакция Polza.AI
Собрал и проверил подключение моделей Яндекса на актуальной версии: прошёл все шаги заново, сверил идентификаторы моделей с каталогом и перепроверил адреса API. Если API обновится и инструкция разойдётся с реальностью — правим страницу.
Обновлено · Как работает редакция · Нашли неточность? Напишите нам
7 моделей Яндекса без облака
Alice AI, YandexGPT, YandexArt и эмбеддинги по одному ключу. Данные хранятся в России, а Polza.ai принимает оплату в рублях.
Остались вопросы? Документация Polza.AI, поддержка в Telegram или support@polza.ai
Страницу проверила редакция Polza.AI, обновлено . Цены и состав каталога меняются — Polza.ai берёт их из каталога и обновляет каждый час.