Yandex Translate API: Определить язык текста

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

Направить обращение нужной команде поддержки или выбрать язык ответа бота.

Отправь текст: POST /translate/v2/detect с text (до 1000 символов). Если знаешь вероятные языки, передай их в languageCodeHints — определение станет точнее.
В ответе languageCode — код языка, в основном ISO 639-1.
Список всех поддерживаемых языков — POST /translate/v2/languages; названия языков в нём на английском.

curl -X POST https://translate.api.cloud.yandex.net/translate/v2/detect \
  -H "Authorization: Api-Key $YANDEX_API_KEY" -H 'Content-Type: application/json' \
  -d '{"text": "Сәлеметсіз бе, тапсырысым қайда?", "languageCodeHints": ["kk", "ru"]}'

Базовые URL

Боевой: https://translate.api.cloud.yandex.net

Авторизация

Тип: Bearer-токен

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

Пользовательский аккаунт авторизуется только IAM-токеном и обязательно передаёт folderId в теле запроса; для сервисного аккаунта folderId не указывается.

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

POST /translate/v2/detect — Определение языка

В ответе — languageCode.

Параметр	Где	Тип	Обяз.	Описание
`text`	body	string	да	Текст, до 1000 символов
`languageCodeHints`	body	array	нет	Наиболее вероятные языки, до 10 кодов
`folderId`	body	string	нет	ID каталога (для пользовательского аккаунта)

POST /translate/v2/languages — Список поддерживаемых языков

Параметр	Где	Тип	Обяз.	Описание
`folderId`	body	string	нет	ID каталога (для пользовательского аккаунта)

Пример ответа:

{"languages": [{"code": "string", "name": "string"}]}

Нюансы

Если sourceLanguageCode не передан, исходный язык определяется автоматически.
Глоссарий передаётся только в теле запроса (glossaryData): до 50 пар и до 20 000 символов Unicode.
Коды языков в основном ISO 639-1, но формат этим не ограничен; названия языков — на английском.

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

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