YandexGPT API (Yandex AI Studio): POST /foundationModels/v1/completionAsync — Асинхронная генерация текста

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

Базовые 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.

Старые 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