YandexGPT API (Yandex AI Studio): POST /v1/responses — Responses API (OpenAI-совместимый)

Текст ответа — в элементах с "type": "output_text" (поле text).

Параметр	Где	Тип	Обяз.	Описание
model	body	string	да	URI модели gpt://<идентификатор_каталога>/<модель>
input	body	string	да	Запрос к модели
temperature	body	number	нет	Температура генерации
max_output_tokens	body	integer	нет	Лимит токенов в ответе

Пример запроса:

curl \
--request POST https://ai.api.cloud.yandex.net/v1/responses \
--header "Authorization: Api-Key ${YANDEX_API_KEY}" \
--header "Content-Type: application/json" \
--max-time 60 \
--data '{
    "model": "gpt://'"${YANDEX_FOLDER_ID}"'/'"${YANDEX_MODEL}"'",
    "temperature": 0.8,
    "max_output_tokens": 1500,
    "input": "Придумай 3 необычные идеи для стартапа в сфере путешествий."
}'

Базовые 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@<суффикс>.

Сценарии с этим методом

• Подключиться через OpenAI-совместимый Responses API

---

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