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

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

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

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

```bash
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 каталога (для пользовательского аккаунта) |

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

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

## Нюансы

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

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

- [Перевести тексты на нужный язык](https://mcp-everything.ru/integrations/yandex-translate/scenarios/perevesti-teksty-na-nuzhnyy-yazyk.md)
- [Перевести HTML с терминами из глоссария](https://mcp-everything.ru/integrations/yandex-translate/scenarios/perevesti-html-s-terminami-iz-glossariya.md)

---

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