# YandexGPT API без Yandex Cloud

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

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

- Моделей YandexGPT в каталоге: 7
- Типов задач: 3
- Максимальный контекст: 32 000 токенов
- Вход от 284 ₽ за 1M токенов

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

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

- **Чат-модели** — 4, эндпоинт `/chat/completions`: YandexGPT Lite 5, YandexGPT Pro 5.1, YandexGPT Pro 5
- **Генерация изображений** — 1, эндпоинт `/images/generations`: YandexArt
- **Эмбеддинги** — 2, эндпоинт `/embeddings`: YandexGPT Embeddings — Query, YandexGPT Embeddings — Doc

## Почему напрямую не выходит

Яндекс — российский вендор, и оплата здесь не главное. Упирается всё в облако, которое приходится заводить ради одного API.

- **Облако ради одного API.** Напрямую нужны организация и облако в Yandex Cloud, каталог и платёжный аккаунт с привязанной картой — до первого запроса.
- **Сервисный аккаунт и роли.** Права выдаются через сервисный аккаунт: роль на использование моделей и ключ с нужной областью действия. Ошибка в роли — отказ в доступе.
- **folder_id в каждом запросе.** Каталог передаётся и в настройках клиента, и в имени модели: `gpt://<folder_id>/aliceai-llm`. Перенос на другой каталог — правка во всех вызовах.
- **Модели выводят из API.** YandexGPT Lite 5 Яндекс отключает 15 ноября 2026 года. Идентификаторы приходится отслеживать и менять.

## Адреса 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 |

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

Уходят каталог и 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

- Вызов функций (tools): 0
- Строгий JSON (response_format): 0
- Рассуждение (reasoning): 0
- Картинка на входе (vision): 0

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

Бесплатного тарифа в 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-llm](https://polza.ai/models/yandex/aliceai-llm.md) — Alice AI LLM — флагман Яндекса для диалогов | Чат-модели | 32 000 | 710 ₽ | 1 704 ₽ |
| [yandex/yandexgpt-5.1-pro](https://polza.ai/models/yandex/yandexgpt-5.1-pro.md) — YandexGPT Pro 5.1 — рабочие задачи и документы | Чат-модели | 32 000 | 1 136 ₽ | 1 136 ₽ |
| [yandex/yandexgpt-5-pro](https://polza.ai/models/yandex/yandexgpt-5-pro.md) — YandexGPT Pro 5 — анализ и извлечение данных | Чат-модели | 32 000 | 1 704 ₽ | 1 704 ₽ |
| [yandex/yandex-art](https://polza.ai/models/yandex/yandex-art.md) — YandexArt — генерация изображений | Генерация изображений | — | — | — |
| [yandex/text-search-doc](https://polza.ai/models/yandex/text-search-doc.md) — Эмбеддинги документов для поиска | Эмбеддинги | — | 14,44 ₽ | — |
| [yandex/text-search-query](https://polza.ai/models/yandex/text-search-query.md) — Эмбеддинги поисковых запросов | Эмбеддинги | — | 14,44 ₽ | — |

## Прямой доступ и доступ через 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`. Если перепутать, точность падает.

## Частые вопросы

### Зачем через 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 на другого вендора, достаточно поменять строку с идентификатором модели.

## Ссылки

- Документация: https://polza.ai/docs
- Каталог моделей: https://polza.ai/models/llms.txt
- Страница: https://polza.ai/providers/yandex
- Обновлено: 2026-11-05