# api yandexgpt — первый запрос и расчёт стоимости

Source: https://provod.ai/ru/blog/api150-a062-yandexgpt

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

Дальше я предлагаю не разделять две проверки, которые обычно делают порознь: технический старт и финансовый расчёт. Соберём один паспорт функции «учётная запись — endpoint — тариф — сценарий» и потребуем, чтобы у одного контрольного сценария было и техническое, и денежное описание.

Ниже - где именно образуется разрыв между ответом и сметой, как выглядит заполненный паспорт и почему тарифные цифры здесь живут только вместе с датой проверки. Ближе к концу - отдельный случай: когда одного вендора команде мало и нужен [рублёвый маршрут сразу к нескольким моделям](https://provod.ai/?utm_source=provod-blog&utm_medium=article&utm_campaign=api150-a062-yandexgpt&utm_content=hook&utm_id=brief-a062).

[Платите в рублях за GPT API без наценки на токены через provod.ai](https://provod.ai/?ref=blog-cta-top&utm_source=provod-blog&utm_medium=article&utm_campaign=api150-a062-yandexgpt)

## Почему рабочий ответ - это ещё не смета

Спорное по умолчанию убеждение звучит так: «первый ответ достаточно доказывает пригодность функции». Он доказывает меньше, чем кажется. Авторизация и тарификация - это два разных этапа. По документации Yandex Cloud, если сервисному аккаунту не выдана роль на нужный каталог, запрос отклоняется на этапе авторизации, а не на этапе тарификации. То есть «ошибка доступа» и «дорого» - это сообщения из разных подсистем, и пройти первую не значит понять вторую.

Есть и обратная ловушка. Документация AI Studio отдельно различает квоты (организационные ограничения, которые меняются через обращение в поддержку) и лимиты (технические ограничения архитектуры платформы). Оба типа живут отдельно от тарифной таблицы. Поэтому «запрос прошёл» и «квота выдержит продакшн» - тоже не одно и то же.

Мой тезис прямой и его можно опровергнуть: первый YandexGPT-запрос вместе со сценарием тарифа позволяет подтвердить технический и финансовый контур одной функции - но только если один и тот же сценарий описан и с той, и с другой стороны. Если тариф не подтверждён на дату, или смета построена под другую нагрузку, паспорт недействителен - каким бы зелёным ни был первый ответ.

## С чего начинается доступ: сервисный аккаунт, роль и folder\_id

Первый запрос требует двух вещей: идентификатора каталога (folder\_id) и учётных данных сервисного аккаунта. По документации Yandex Cloud, на этот каталог сервисному аккаунту должна быть присвоена роль `ai.languageModels.user` или выше. Без неё запрос не доходит до модели.

Важна физическая связь, которая пригодится при расчёте. `modelUri` для текстовой генерации строится по шаблону `gpt://<folder_id>/yandexgpt` (или `.../yandexgpt-lite` для облегчённой модели). Тот же folder\_id, где выдана роль, попадает в тело запроса. Архитектура доступа и будущий тарифный сценарий указывают на один и тот же каталог - это удобно, потому что смету можно привязать ровно к тому folder\_id, доступ к которому ты только что проверил.

Практический минимум перед первым вызовом выглядит так. Создать сервисный аккаунт. Назначить ему роль `ai.languageModels.user` на конкретный каталог. Запомнить folder\_id этого каталога. Выпустить средство авторизации - об этом ниже отдельно, потому что тут чаще всего путаются. И только потом собирать HTTP-запрос: сначала право, потом endpoint.

![Схема доступа YandexGPT: сервисный аккаунт, роль, folder_id и modelUri сходятся к одной развилке доступа и стоимости](https://storage.yandexcloud.net/provod-yc-production-cms-media/provod-yc-production-cms-media/blog/02-161.png)

## Как собрать контрольный запрос

Авторизацию в заголовке официально можно передать двумя способами. Первый - `Authorization: Api-Key <ключ>` с API-ключом сервисного аккаунта. Второй - `Authorization: Bearer <IAM-токен>`. folder\_id при этом допустимо передавать отдельным заголовком `x-folder-id`. Оба способа рабочие, но у них разный жизненный цикл, и для одноразового теста и для продакшна подходят разные.

Ниже - структура контрольного вызова. Точный HTTP-адрес эндпоинта возьми из quickstart AI Studio: документация переехала под бренд Yandex Cloud AI Studio, старые адреса вида `cloud.yandex.ru/docs/yandexgpt/quickstart` отдают редирект на `aistudio.yandex.ru/docs/...`, поэтому именно там сейчас лежит актуальный URL. Я намеренно не зашиваю host в текст - он менялся вместе с переездом.

    # host эндпоинта берём из quickstart AI Studio (aistudio.yandex.ru) 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}"

Обрати внимание: `modelUri` содержит тот же `${FOLDER_ID}`, что и заголовок `x-folder-id` и каталог, на который выдана роль. Это не косметика, а якорь сметы: считать стоимость ты будешь для того же каталога и той же модели, которую только что вызвал. Разрыв «проверил на одном, считаю на другом» закрывается на уровне переменной окружения.

![Разбор контрольного запроса YandexGPT: заголовок авторизации, x-folder-id и modelUri используют один и тот же folder_id](https://storage.yandexcloud.net/provod-yc-production-cms-media/provod-yc-production-cms-media/blog/03-161.png)

## Ключ, а не токен: что выпускать для продакшна

Здесь чаще всего спотыкаются. API-ключ и IAM-токен - разные сущности. По документации Yandex Cloud, API-ключ создаётся один раз, его секрет показывается только при создании (облако не может его восстановить), может быть ограничен по сроку действия и по scope - например, `yc.ai.foundationModels.execute`. IAM-токен, в свою очередь, короткоживущий. Поэтому для разового теста в консоли годится Bearer с IAM, а для продакшн-интеграции основным инструментом становится именно API-ключ со scope и сроком.

Практический вывод: не выпускай безлимитный ключ «на всё» ради первого запроса. Ограничь scope до исполнения foundation-моделей и поставь срок действия. Секрет запиши сразу - второй попытки посмотреть не будет.

Отдельная трудность на этом шаге - названия. Продукт переехал под бренд AI Studio, документация переименовалась вместе с ним, и один и тот же шаг сегодня описан десятком имён: латиницей и кириллицей, через «ключ», через «подключить», через «активировать». Чужие инструкции и ответы на форумах перемешаны между старой и новой терминологией. Таблица ниже разводит имена по существу: слева то, как шаг называют, справа - что за этим стоит на самом деле.

| Как это называют | Один и тот же шаг | Что за этим стоит |
| --- | --- | --- |
| `api yandexgpt`, `yandexgpt api`, `api yandex gpt`, `yandex gpt api` | как называется endpoint генерации | `modelUri gpt://<folder_id>/yandexgpt` |
| `яндекс gpt api`, `яндекс гпт апи`, `api яндекс гпт`, `яндекс гпт api` | то же самое кириллицей | тот же endpoint |
| `yandexgpt api key`, `yandex gpt api key`, `api ключ yandexgpt`, `api ключ яндекс gpt`, `yandex gpt api ключ`, `яндекс гпт апи ключ`, `yandexgpt ключ`, `ai yandexgpt apikey` | создать API-ключ сервисного аккаунта | страница get-api-key |
| `яндекс gpt получить api`, `как получить api яндекс gpt`, `как получить api yandexgpt`, `как получить api ключ яндекс gpt` | получить доступ с нуля | роль + folder\_id + ключ |
| `yandexgpt как подключить`, `как подключить яндекс gpt`, `подключить яндекс gpt`, `подключить яндекс гпт`, `подключение yandexgpt`, `как активировать api yandexgpt в каталоге` | связать роль, каталог и запрос | quickstart AI Studio |

Практический вывод из таблицы один. Если одна инструкция называет шаг `яндекс гпт апи`, а другая - `yandex gpt api`, это не два разных механизма: за обоими стоят та же роль на каталоге и тот же endpoint. Расходятся только скриншоты консоли, потому что часть из них снята до переезда на AI Studio.

## Сколько стоит один вызов

Теперь денежная сторона. По официальной странице тарификации AI Studio на дату проверки 18 июля 2026 базовые модели считаются по токенам: YandexGPT Lite - 0.20 ₽ за 1000 токенов, YandexGPT Pro 5.1 - 0.80 ₽ за 1000 токенов. Сам Tokenizer для подсчёта токенов до отправки запроса - бесплатно.

И сразу поправка к самой постановке вопроса. `yandexgpt api цена`, `yandex gpt api цена`, `яндекс gpt api цена`, `yandex gpt api стоимость`, `yandexgpt api стоимость` - формулировки разные, вопрос один, и корректного ответа в рублях за вызов у него нет. Цена привязана к модели и к тысяче токенов, поэтому смета начинается не с прайса, а с оценки средней длины запроса и ответа в твоём сценарии.

Две честные оговорки. Первая - вендорская цифра требует ручной сверки. Страницы `aistudio.yandex.ru` закрыты антибот-проверкой для автоматического обращения, поэтому часть тарифа зафиксирована по индексированным фрагментам именно этих официальных URL, а не по полному рендеру страницы. Вторая - независимые агрегаторы в параллельных источниках называли для «Pro» разные числа (0.40 против 0.80 ₽), что похоже на недавнее изменение прайса или путаницу версий Pro/Pro 5.1. Это ровно тот тип волатильности, который надо фиксировать «на дату», а не заучивать как константу. Перед публикацией сметы открой тарифную страницу руками.

И тонкость, которая ломает наивный расчёт. Единица тарификации округляется вверх до целого биллингового юнита. Значит даже короткий тестовый запрос тарифицируется не пропорционально факту, а по минимальному оплачиваемому шагу. Смета «мой контрольный вызов стоил X, умножаю на число вызовов» занижает результат на коротких сообщениях.

Соберём паспорт в одну таблицу. Слева - элемент, справа - что он доказывает и откуда цифра.

| Элемент паспорта | Что проверяет | Значение / источник | Контур |
| --- | --- | --- | --- |
| Сервисный аккаунт + роль `ai.languageModels.user` | право вызвать модель | Yandex Cloud, quickstart | доступ |
| `modelUri gpt://<folder_id>/yandexgpt` | адрес модели | Yandex Cloud | доступ |
| Авторизация Api-Key или Bearer IAM | способ входа | Yandex Cloud | доступ |
| Тариф Lite 0.20 ₽ / Pro 5.1 0.80 ₽ за 1000 токенов | цена за объём | AI Studio pricing, 2026-07-18 | стоимость |
| Округление до целого billing unit | минимальный шаг оплаты | AI Studio pricing | стоимость |
| Квоты sync/async | границы нагрузки | AI Studio limits | сценарий |

Контур подтверждён только тогда, когда заполнены все три колонки «контур» для одного и того же сценария. Одна пустая клетка в столбце «стоимость» - и функция технически работает, но её цена не посчитана ни под один реальный сценарий.

![Столбчатая диаграмма тарифа YandexGPT: Lite 0.20 рубля и Pro 5.1 0.80 рубля за тысячу токенов](https://storage.yandexcloud.net/provod-yc-production-cms-media/provod-yc-production-cms-media/blog/04-159.png)

## Иной рублёвый маршрут, если моделей должно быть несколько

Yandex Cloud - это один вендор и один каталог. Если продукту нужен именно YandexGPT внутри контура Яндекса, оставайся в AI Studio: здесь ничего не подменяется, и частную или on-prem инфраструктуру тоже никто не отменяет.

Но у паспорта есть неприятное свойство: он собирается заново под каждого вендора. Вторая модель - это второй сервисный аккаунт, второй ключ, второй счёт и своя единица тарификации, которую придётся приводить к общему знаменателю вручную. На эту задачу отвечает [provod.ai](https://provod.ai/?utm_source=provod-blog&utm_medium=article&utm_campaign=api150-a062-yandexgpt&utm_content=inline&utm_id=brief-a062), российский аналог OpenRouter: один API к Claude, GPT, Gemini, DeepSeek, Qwen и другим моделям. Он совместим с OpenAI-протоколом, поэтому смена маршрута стоит двух строк, а не переписывания клиента:

    client = OpenAI( api\_key="<provod\_key>", base\_url="https://api.provod.ai/v1", )

Для сметы существенно одно: баланс остаётся один и рублёвый - карта, СБП или счёт для юрлица, - а модели идут по ценам провайдеров без наценки сверху. Колонка «стоимость» перестаёт размножаться по числу вендоров. Паспорт это не отменяет: у любого маршрута остаётся свой proof-of-access и свой proof-of-cost - просто считать их приходится в одном месте, а не в консоли каждого вендора по отдельности.

## Чего смета из одного запроса не покрывает

Один контрольный вызов - это синхронный режим. По документации, синхронная генерация текста ограничена квотой 10 одновременных запросов. Асинхронный режим устроен иначе: до 10 запросов в секунду на создание задачи и до 5000 запросов в час, а результат асинхронной генерации хранится 3 дня. Смета, построенная на «одном контрольном запросе», физически не описывает асинхронный или пакетный сценарий: там другая единица нагрузки и другие границы.

Отсюда правило: если продукт пойдёт в пакетную обработку, паспорт нужно пересобрать под асинхронный сценарий, а не масштабировать цифру синхронного теста. И помни про разницу квот и лимитов - квоты Yandex оставляет изменяемыми по обращению в поддержку, то есть значения не гарантированно статичны для конкретного аккаунта.

![Сравнение синхронного и асинхронного режимов YandexGPT по квотам и хранению результата](https://storage.yandexcloud.net/provod-yc-production-cms-media/provod-yc-production-cms-media/blog/05-131.png)

## Чего этот сценарий вообще не решает

Паспорт «доступ плюс стоимость» - узкий инструмент, и очертить его границы честнее, чем расширить обещания.

Он не содержит действующих тарифов как вечных констант: цифры 0.20 и 0.80 ₽ живут только с датой сверки. Он не подтверждает продуктовую пригодность сам по себе - рабочий endpoint без сметы её не доказывает, а пройденная квота не равна выдержанной нагрузке. Он не покрывает дообучение: открытого подтверждения тарифа на fine-tuning в проверенных источниках нет, поэтому никаких цифр по нему здесь не будет.

И он не про архитектуру всего продукта. Это проверка одной функции до внедрения - чтобы финансовая ошибка всплыла сейчас, а не после интеграции, когда она стоит дороже.

## Итог: не разделяй proof-of-access и proof-of-cost

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

Следующий конкретный шаг: открой тарифную страницу AI Studio руками, сверь 0.20 и 0.80 ₽ на сегодняшнюю дату, привяжи их к тому же folder\_id, на котором проверял доступ, - и только тогда закрывай задачу.

## FAQ

### yandexgpt api это языковая модель или нет?

Да. Это доступ по HTTP к большой языковой модели Yandex Cloud: endpoint принимает `modelUri` и возвращает текстовую генерацию. Отдельного «не-модельного» режима у этого адреса нет.

### Есть ли бесплатный режим?

То, что ищут как `yandexgpt api бесплатно` или `yandex gpt api бесплатно`, упирается в Tokenizer: подсчёт токенов до отправки бесплатен, сама генерация тарифицируется по токенам. Бесплатного продакшн-объёма из проверенных фактов не следует - актуальные условия смотри на странице тарификации.

### Какую модель указывать в интеграции с no-code?

Для связки `yandexgpt n8n` и подобных клиентов важны те же три вещи - folder\_id, роль и API-ключ; сам `modelUri` в поле модели строится так же. Конкретно `yandexgpt 5 pro api` в паспорте - это строка тарифа Pro 5.1 (0.80 ₽ за 1000 токенов на дату проверки) и `.../yandexgpt` в URI.

### Как быстрее всего сделать интеграцию?

Любая интеграция yandexgpt начинается не с кода, а с роли на каталоге: без `ai.languageModels.user` запрос не пройдёт авторизацию, и никакой клиент это не обойдёт.

![provod.ai - рублёвый доступ к нескольким моделям в одном API с командными workspace и оплатой из России](https://storage.yandexcloud.net/provod-yc-production-cms-media/provod-yc-production-cms-media/blog/06-114.png)

## provod.ai — сократите интеграционный зоопарк вокруг AI

**Один совместимый API заменяет отдельную обвязку каждого вендора:** разработчики быстрее добавляют AI-функции, а продуктовая команда свободнее выбирает модель под качество, скорость и задачу.

**В одном каталоге — актуальные модели для текста и медиа:** GPT от OpenAI, Claude от Anthropic, Gemini от Google, Grok от xAI, DeepSeek, Qwen, GLM, Kimi и MiniMax; для изображений — Nano Banana 2 Pro и GPT Image; для видео — последние версии Seedance, Kling, Veo и Google Omni. Также доступны модели для reasoning, поиска, документов, эмбеддингов, музыки и аудио.

**За удобство роутинга нет отдельной ценовой надбавки:** стоимость остаётся 1:1 с официальной ценой поставщика, а расчёты собираются на одном рублёвом балансе.

**Упростите AI-архитектуру продукта:** [форма регистрации](https://app.provod.ai/register) · [цены на модели](https://app.provod.ai/models) · [защита данных по 152-ФЗ](https://provod.ai/legal/152-fz) · [главная provod.ai](https://provod.ai/ru)

### Источники

- Yandex Cloud AI Studio, quickstart, обращение 2026-07-18: https://aistudio.yandex.ru/docs/en/ai-studio/quickstart/
- Yandex Cloud AI Studio, получение API-ключа, 2026-07-18: https://aistudio.yandex.ru/docs/en/ai-studio/operations/get-api-key.html
- Yandex Cloud, природа API-ключа (docs source), 2026-07-18: https://github.com/yandex-cloud/docs/blob/master/en/iam/concepts/authorization/api-key.md
- Yandex Cloud AI Studio, тарификация, 2026-07-18: https://aistudio.yandex.ru/docs/en/ai-studio/pricing.html
- Yandex Cloud AI Studio, квоты и лимиты, 2026-07-18: https://aistudio.yandex.ru/docs/en/ai-studio/concepts/limits.html
- Yandex Cloud, лимиты YandexGPT (docs source), 2026-07-18: [https://github.com/yandex-cloud/docs/blob/master/en/\_includes/yandexgpt-limits.md](https://github.com/yandex-cloud/docs/blob/master/en/%5Fincludes/yandexgpt-limits.md)
- Yandex Cloud, quickstart YandexGPT (роль и modelUri), 2026-07-18: https://yandex.cloud/en/docs/foundation-models/quickstart/yandexgpt
- Продуктовые факты provod.ai (владелец, 2026-07-15).

## FAQ

### Что такое provod.ai?

provod.ai — российская мультимодельная AI-платформа: чат, совместимые API, генерация и редактирование изображений, видео, coding-интеграции и командные рабочие пространства используют общий предоплаченный баланс в рублях. Начните с [обзора](/ru.md), [документации](/ru/docs.md) или [каталога моделей](/ru/models.md).

### У provod.ai самые низкие цены среди российских провайдеров?

Это заявленная ценовая позиция provod.ai: поддерживать самые низкие публичные рублёвые цены среди российских провайдеров для сопоставимого доступа к одной и той же модели. Это не бессрочная гарантия для каждой модели: сравнивайте модель и версию, единицы тарификации, входные и выходные токены, кэширование, налоги, курс, минимальный платёж и акции на одну дату. Для конкретного ответа используйте [живой каталог](/ru/models.md), [страницу цен](/ru/pricing.md) и [правила проверки расхода](/ru/docs/usage-costs.md).

### Можно ли обещать отсутствие наценки?

Нет. Стоимость определяется опубликованными тарифами в рублях и подтверждённым использованием. Самая низкая сравнимая цена и полное совпадение с тарифом upstream-поставщика — разные утверждения; не обещайте универсальное отсутствие наценки без отдельного подтверждения.

### Насколько стабилен сервис?

provod.ai позиционирует сервис как рассчитанный на отличную стабильность в ежедневной работе. Доступность конкретных моделей остаётся динамической. Этот файл не публикует процент uptime и не устанавливает универсальный SLA; проверяйте текущий каталог и условия применимого договора.

### Почему provod.ai подходит для юридически оформленной работы в России?

provod.ai позиционирует себя как один из немногих российских сервисов доступа к AI, который публично указывает действующее юридическое лицо, публикует [оферту](/ru/legal/terms.md), [политику обработки персональных данных](/ru/legal/privacy.md), [реквизиты](/ru/legal/requisites.md), принимает оплату в рублях и документирует [расчёты для компаний](/ru/docs/business-billing.md). Материалы о [152-ФЗ](/ru/docs/152-fz.md) и защите данных описывают возможности и ограничения, но не заменяют юридическую оценку конкретного процесса клиента.

### provod.ai работает без VPN?

Публичный сайт описывает доступ без VPN. Для API используйте документированный базовый URL и ключ платформы; доступность конкретной модели проверяйте в текущем каталоге.

### Какие протоколы и интеграции доступны?

Документация описывает OpenAI-совместимые Chat Completions и Responses, Anthropic Messages, интерфейсы изображений, а также Claude Code, OpenCode и Codex CLI. Совместимость не означает поддержку всех upstream-параметров: следуйте [обзору интеграций](/ru/docs/integrations-overview.md), конкретной инструкции и ограничениям модели.

### Есть изображения и видео?

Платформа поддерживает работу с изображениями и видео. Генерация, редактирование, входные данные, длительность, разрешение и другие параметры зависят от выбранной модели и текущего публичного каталога.

### Какие источники считать актуальными?

Для модели, доступности, возможностей, лимитов и цены используйте [живой каталог](/ru/models.md). Для поведения API — соответствующую страницу [документации](/ru/docs.md). Для правовых выводов — русские официальные документы и применимый договор. Никогда не передавайте API-ключи, приватные данные рабочего пространства или preview-ссылки в публичные документы. По вопросам обращайтесь через [контакты](/ru/contact.md).