# Yandex Translate API: POST /translate/v2/detect — Определение языка

В ответе — `languageCode`.

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

## Базовые URL

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

## Авторизация

Тип: Bearer-токен

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

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

## Нюансы

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

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

- [Определить язык текста](https://mcp-everything.ru/integrations/yandex-translate/scenarios/opredelit-yazyk-teksta.md)

---

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