{"name":"Yandex Translate API","vendor":"Яндекс","industry":"ai","summary":"API машинного перевода Yandex Translate (Yandex Cloud / AI Studio): перевод текста и HTML с автоматическим определением исходного языка, глоссарии и пользовательские модели, проверка орфографии, определение языка текста и список поддерживаемых языков. Запросы и ответы — JSON.","docsUrl":"https://aistudio.yandex.ru/ru/docs/translate/","coverage":{"included":[],"excluded":[]},"scenarios":[{"id":"perevesti-teksty-na-nuzhnyy-yazyk","title":"Перевести тексты на нужный язык","summary":"Перевод описаний товаров, сообщений поддержки, интерфейса — пачкой строк за один запрос.","steps":["Создай сервисный аккаунт и API-ключ; передавай его в заголовке Authorization: Api-Key <ключ>. С пользовательским IAM-токеном нужно ещё передавать folderId в теле.","Отправь тексты: POST /translate/v2/translate с targetLanguageCode (например, en) и texts — массивом строк, суммарно до 10 000 символов.","Исходный язык определится автоматически; в ответе для каждой строки — text (перевод) и detectedLanguageCode.","Лимит — 20 вызовов в секунду и 1 млн символов в час: большие объёмы разбивай на пачки."],"code":"curl -X POST https://translate.api.cloud.yandex.net/translate/v2/translate \\\n  -H \"Authorization: Api-Key $YANDEX_API_KEY\" \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"targetLanguageCode\": \"en\", \"texts\": [\"Кружка керамическая, 330 мл\", \"Можно мыть в посудомоечной машине\"]}'","language":"bash","methods":["POST /translate/v2/translate"]},{"id":"perevesti-html-s-terminami-iz-glossariya","title":"Перевести HTML с терминами из глоссария","summary":"Перевод страниц и писем с разметкой, где названия продуктов и термины должны переводиться одинаково.","steps":["Отправь запрос: POST /translate/v2/translate с format = HTML — разметка сохранится, переведётся только текст.","Для глоссария обязательно укажи sourceLanguageCode и передай glossaryConfig.glossaryData.glossaryPairs — до 50 пар sourceText и translatedText (до 20 000 символов).","Чтобы термин переводился ровно как в глоссарии, поставь exact = true."],"code":"curl -X POST https://translate.api.cloud.yandex.net/translate/v2/translate \\\n  -H \"Authorization: Api-Key $YANDEX_API_KEY\" -H 'Content-Type: application/json' \\\n  -d '{\n        \"sourceLanguageCode\": \"ru\",\n        \"targetLanguageCode\": \"en\",\n        \"format\": \"HTML\",\n        \"texts\": [\"<p>Оформите <b>Подписку Плюс</b> и получайте бесплатную доставку.</p>\"],\n        \"glossaryConfig\": {\"glossaryData\": {\"glossaryPairs\": [{\"sourceText\": \"Подписка Плюс\", \"translatedText\": \"Plus Membership\", \"exact\": true}]}}\n      }'","language":"bash","methods":["POST /translate/v2/translate"]},{"id":"opredelit-yazyk-teksta","title":"Определить язык текста","summary":"Направить обращение нужной команде поддержки или выбрать язык ответа бота.","steps":["Отправь текст: POST /translate/v2/detect с text (до 1000 символов). Если знаешь вероятные языки, передай их в languageCodeHints — определение станет точнее.","В ответе languageCode — код языка, в основном ISO 639-1.","Список всех поддерживаемых языков — POST /translate/v2/languages; названия языков в нём на английском."],"code":"curl -X POST https://translate.api.cloud.yandex.net/translate/v2/detect \\\n  -H \"Authorization: Api-Key $YANDEX_API_KEY\" -H 'Content-Type: application/json' \\\n  -d '{\"text\": \"Сәлеметсіз бе, тапсырысым қайда?\", \"languageCodeHints\": [\"kk\", \"ru\"]}'","language":"bash","methods":["POST /translate/v2/detect","POST /translate/v2/languages"]}],"baseUrls":[{"label":"Боевой","url":"https://translate.api.cloud.yandex.net"}],"auth":{"type":"bearer","description":"- IAM-токен (пользовательский или сервисный аккаунт): `Authorization: Bearer <IAM-токен>`\n- API-ключ (сервисный аккаунт): `Authorization: Api-Key <API-ключ>`\n\nПользовательский аккаунт авторизуется только IAM-токеном и обязательно передаёт `folderId` в теле запроса; для сервисного аккаунта `folderId` не указывается.","example":""},"methods":[{"id":"POST /translate/v2/translate","title":"Перевод текста","httpMethod":"POST","path":"/translate/v2/translate","description":"Пример тела:\n\nВ ответе — массив `translations`: `text` (перевод) и `detectedLanguageCode` (язык исходного текста).","params":[{"name":"targetLanguageCode","in":"body","type":"string","required":true,"description":"Язык перевода, до 3 символов (обычно ISO 639-1)"},{"name":"texts","in":"body","type":"array","required":true,"description":"Строки для перевода, суммарно до 10 000 символов"},{"name":"sourceLanguageCode","in":"body","type":"string","required":false,"description":"Язык исходного текста; нужен для перевода с глоссарием"},{"name":"format","in":"body","type":"string","required":false,"description":"PLAIN_TEXT (по умолчанию) или HTML"},{"name":"folderId","in":"body","type":"string","required":false,"description":"ID каталога; обязателен для пользовательского аккаунта"},{"name":"model","in":"body","type":"string","required":false,"description":"ID пользовательской модели"},{"name":"glossaryConfig.glossaryData.glossaryPairs","in":"body","type":"array","required":false,"description":"Пары глоссария: от 1 до 50"},{"name":"glossaryConfig.glossaryData.glossaryPairs[].sourceText","in":"body","type":"string","required":true,"description":"Текст на исходном языке"},{"name":"glossaryConfig.glossaryData.glossaryPairs[].translatedText","in":"body","type":"string","required":true,"description":"Текст на целевом языке"},{"name":"glossaryConfig.glossaryData.glossaryPairs[].exact","in":"body","type":"boolean","required":false,"description":"Точный перевод термина (нейроглоссарий)"},{"name":"speller","in":"body","type":"boolean","required":false,"description":"Проверка орфографии"}],"requestExample":"{\n    \"folderId\": \"<идентификатор_каталога>\",\n    \"texts\": [\"Hello\", \"World\"],\n    \"targetLanguageCode\": \"ru\"\n}","responseExample":"export API_KEY=<API-ключ>\ncurl \\\n  --request POST \\\n  --header \"Content-Type: application/json\" \\\n  --header \"Authorization: Api-Key ${API_KEY}\" \\\n  --data '@body.json' \\\n  \"https://translate.api.cloud.yandex.net/translate/v2/translate\"","docsUrl":""},{"id":"POST /translate/v2/detect","title":"Определение языка","httpMethod":"POST","path":"/translate/v2/detect","description":"В ответе — `languageCode`.","params":[{"name":"text","in":"body","type":"string","required":true,"description":"Текст, до 1000 символов"},{"name":"languageCodeHints","in":"body","type":"array","required":false,"description":"Наиболее вероятные языки, до 10 кодов"},{"name":"folderId","in":"body","type":"string","required":false,"description":"ID каталога (для пользовательского аккаунта)"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /translate/v2/languages","title":"Список поддерживаемых языков","httpMethod":"POST","path":"/translate/v2/languages","description":"","params":[{"name":"folderId","in":"body","type":"string","required":false,"description":"ID каталога (для пользовательского аккаунта)"}],"requestExample":"","responseExample":"{\"languages\": [{\"code\": \"string\", \"name\": \"string\"}]}","docsUrl":""}],"codeExamples":[],"errors":[{"code":"400","description":"Некорректные параметры запроса"},{"code":"401","description":"Нужна аутентификация"},{"code":"403","description":"Недостаточно прав"},{"code":"429","description":"Превышена квота запросов"},{"code":"500","description":"Внутренняя ошибка"},{"code":"503","description":"Сервис временно недоступен"}],"limits":"- 20 вызовов одного метода API в секунду.\n- 1 млн символов на перевод или определение языка в час.\n- Глоссарий: до 50 пар, до 20 000 символов.","gotchas":["Если `sourceLanguageCode` не передан, исходный язык определяется автоматически.","Глоссарий передаётся только в теле запроса (`glossaryData`): до 50 пар и до 20 000 символов Unicode.","Коды языков в основном ISO 639-1, но формат этим не ограничен; названия языков — на английском."],"slug":"yandex-translate","version":2,"updatedAt":"2026-10-24T17:05:42.001Z","sources":[{"title":"Translate — метод translate","url":"https://aistudio.yandex.ru/ru/docs/translate/api-ref/Translation/translate","kind":"research","addedAt":"2026-10-14T14:55:54.877Z"},{"title":"Translate — метод detectLanguage","url":"https://aistudio.yandex.ru/ru/docs/translate/api-ref/Translation/detectLanguage","kind":"research","addedAt":"2026-10-14T14:55:54.877Z"},{"title":"Translate — метод listLanguages","url":"https://aistudio.yandex.ru/ru/docs/translate/api-ref/Translation/listLanguages","kind":"research","addedAt":"2026-10-14T14:55:54.877Z"},{"title":"Перевод текста","url":"https://aistudio.yandex.ru/ru/docs/translate/operations/translate","kind":"research","addedAt":"2026-10-14T14:55:54.877Z"},{"title":"Квоты и лимиты","url":"https://aistudio.yandex.ru/ru/docs/ai-studio/concepts/limits","kind":"research","addedAt":"2026-10-14T14:55:54.877Z"},{"title":"Обработка ошибок в API Yandex Cloud","url":"https://yandex.cloud/ru/docs/api-design-guide/concepts/errors","kind":"research","addedAt":"2026-10-14T14:55:54.877Z"},{"title":"Вставленный текст","url":"","kind":"import","addedAt":"2026-10-14T14:55:54.877Z"},{"title":"scenarios-yandex-translate.md","url":"","kind":"import","addedAt":"2026-10-24T17:05:30.940Z"}],"logoUrl":null}