Провайдер · YandexGPT

YandexGPT API без Yandex Cloud

Модели Яндекса в Polza.ai работают по общему ключу каталога: без организации в облаке, каталога, сервисного аккаунта и folder_id в каждом запросе. В каталоге Polza.ai — 7 моделей Яндекса, у всех данные хранятся в России.

  • Alice AI LLM и YandexGPT Pro 5.1
  • Без folder_id и ролей
  • Данные хранятся в РФ
  • Карта РФ, СБП и счёт для юрлиц
curl · проверка ключа

# один запрос, чтобы убедиться, что всё работает

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": "Привет"}]}'

Адрес и префикс модели — всё, что отличается от прямого обращения к вендору.

Что доступно по ключу

Текстовые модели Alice AI и YandexGPT, генерация картинок YandexArt и пара эмбеддингов для поиска — отдельно для запросов и для документов.

Чат-модели

4

YandexGPT Lite 5, YandexGPT Pro 5.1, YandexGPT Pro 5

/chat/completions

Генерация изображений

1

YandexArt

/images/generations

Эмбеддинги

2

YandexGPT 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. 1

    Зарегистрируйтесь

    Почта и пароль. Телефон другой страны и зарубежная карта не нужны.

  2. 2

    Создайте ключ

    Раздел «API-ключи» в кабинете. Ключ начинается с pza_ — скопируйте его сразу, второй раз он не показывается. Ключей можно завести несколько: по одному на сервис или на сотрудника.

  3. 3

    Пополните баланс

    Карта РФ, СБП или счёт для юрлица. Минимальное пополнение — 100 ₽, этого хватает на 140 запросов к самой дешёвой модели YandexGPT.

  4. Получить 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/v1https://polza.ai/api/v1
Переменная с ключом$YANDEX_CLOUD_API_KEY$POLZA_API_KEY
Идентификатор моделиgpt://<folder_id>/aliceai-llmyandex/aliceai-llm

Пути после базового адреса стандартные. У моделей YandexGPT задействованы: /chat/completions, /embeddings, /images/generations, /media.

Что меняется в коде

Уходят каталог и folder_id в имени модели. Клиент тот же OpenAI SDK, меняются адрес, ключ и идентификатор.

было · ai.api.cloud.yandex.net
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": "Привет"}],
)
стало · polza.ai
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

Цифры — сколько моделей Яндекса в каталоге поддерживают эту возможность. Считается по самому каталогу, а не заявлено на словах.

0

Вызов функций

Модель сама решает, когда дёрнуть вашу функцию, и передаёт аргументы.

tools

0

Строгий JSON

Ответ приходит по заданной схеме — без парсинга текста регулярками.

response_format

0

Рассуждение

Промежуточные шаги считаются отдельно и приходят отдельным полем.

reasoning

0

Картинка на входе

В сообщение можно положить изображение вместе с текстом.

vision

Есть ли бесплатный доступ

Бесплатного тарифа в Polza.ai нет — вы платите за токены. Но порог низкий: минимальное пополнение 100 ₽. Ниже видно, во что это выходит на практике.

МодельОдин запрос1 000 запросовЗапросов на 100 ₽
yandex/aliceai-llm2,27 ₽2 272 ₽44
yandex/yandexgpt-5.1-pro2,84 ₽2 840 ₽35
yandex/yandexgpt-5-pro4,26 ₽4 260 ₽23

За запрос считаем 2 000 токенов на входе и 500 на выходе — это примерно страница текста в вопросе и абзац в ответе.

Отдельно про «бесплатные ключи», которые раздают в каналах и на форумах: это либо чужой ключ, либо прокси поверх чужого. Работает до первой блокировки, а промпты при этом уходят неизвестно куда. Для рабочего проекта не годится.

Модели и цены

Polza.ai показывает цены за миллион токенов в рублях и обновляет их каждый час. Подписки в Polza.ai нет: вы платите за то, что израсходовали, остаток не сгорает.

МодельТипКонтекстВход · 1MВыход · 1M
yandex/aliceai-llmAlice AI LLM — флагман Яндекса для диалоговЧат-модели32 000710 ₽1 704 ₽
yandex/yandexgpt-5.1-proYandexGPT Pro 5.1 — рабочие задачи и документыЧат-модели32 0001 136 ₽1 136 ₽
yandex/yandexgpt-5-proYandexGPT Pro 5 — анализ и извлечение данныхЧат-модели32 0001 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 берёт их из каталога и обновляет каждый час.

Сайт использует cookie.