YandexGPT API (Yandex AI Studio): Обработать много запросов в асинхронном режиме

Сценарий из mcp-everything. Актуально на 2026-10-24.

Ночная обработка тысяч карточек товаров или обращений — без упора в лимит одновременных генераций.

Отправляй запросы: POST /foundationModels/v1/completionAsync с теми же параметрами, что и синхронная генерация. В ответе — объект Operation с id.
Забирай результат: GET /operations/{operationId} на хосте operation.api.cloud.yandex.net. Пока done = false — повторяй позже; когда true, заполнено ровно одно из полей response или error.
Лимиты асинхронного режима — 10 запросов в секунду на генерацию, 50 в секунду на получение ответа и 5 000 в час. Квоты увеличиваются через поддержку.

OP=$(curl -s -X POST https://ai.api.cloud.yandex.net/foundationModels/v1/completionAsync \
  -H "Authorization: Api-Key $YANDEX_API_KEY" -H 'Content-Type: application/json' \
  -d '{"modelUri": "gpt://'"$YANDEX_FOLDER_ID"'/yandexgpt-5-lite", "messages": [{"role": "user", "text": "Кратко перескажи: ..."}]}' | jq -r .id)

curl https://operation.api.cloud.yandex.net/operations/$OP -H "Authorization: Api-Key $YANDEX_API_KEY"

Базовые URL

Боевой (Foundation Models API): https://ai.api.cloud.yandex.net
Операции (результат асинхронных запросов): https://operation.api.cloud.yandex.net

Авторизация

Тип: Bearer-токен

IAM-токен (аккаунт на Яндексе, федеративный, локальный или сервисный аккаунт): Authorization: Bearer <IAM-токен>
API-ключ (только сервисный аккаунт): Authorization: Api-Key <API-ключ>

Для генерации текста нужна роль ai.languageModels.user или выше; для Responses API — ai.assistants.editor и ai.languageModels.user.

Методы сценария

POST /foundationModels/v1/completionAsync — Асинхронная генерация текста

Принимает те же параметры, что completion. Возвращает объект Operation (id, done, response или error); результат забирают по id операции.

GET /operations/{operationId} — Результат асинхронной операции

Хост operation.api.cloud.yandex.net. Когда done равно true, заполнено ровно одно из полей response или error.

Параметр	Где	Тип	Обяз.	Описание
`operationId`	path	string	да	ID операции из ответа completionAsync

Нюансы

Старые URI .../yandexgpt/latest и .../yandexgpt/rc работают до окончания поддержки; после этого запросы по устаревшему URI возвращают 400 Bad Request — автоматического переключения на новую версию нет.
Часть открытых моделей доступна ограниченное время (gpt-oss-120b и gpt-oss-20b — до 30 октября 2026 года); список проверяйте перед интеграцией.
maxTokens, dim и счётчики токенов в ответах передаются строками (int64).
Дообученные модели: gpt://<идентификатор_каталога>/yandexgpt-lite/latest@<суффикс>.

Другие сценарии

Если этого недостаточно — официальная документация: https://aistudio.yandex.ru/ru/docs/ai-studio/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/yandexgpt.md