---
metadata:
  - name: generator
    content: Diplodoc Platform v5.57.4
alternate:
  - https://3y3.dev/en/tools/docs/translate-yandex.md
  - https://3y3.dev/ru/tools/docs/translate-yandex.md
  - href: https://3y3.dev/ru/tools/docs/translate-yandex.md
    type: text/markdown
    title: Markdown version
  - href: https://3y3.dev/ru/llms.txt
    rel: describedby
keywords:
  - translate
  - yandex translate
  - машинный перевод
  - i18n
  - l10n
  - перевод
updatedAt: '2026-09-01T09:43:34.000Z'
tags:
  - локализация
---
> **Documentation Index:** Fetch the complete configuration index at https://3y3.dev/ru/llms.txt

# Машинный перевод

Без опции `--provider` команда `yfm translate` переводит документацию через [Yandex Translate](https://yandex.cloud/ru/services/translate). Это самый быстрый способ перевода: он подходит для черновых версий и регулярной синхронизации языков, но результат обычно требует вычитки. Для более качественного перевода используйте [AI-перевод](https://3y3.dev/ru/tools/docs/translate-ai.md) или [CAT-системы](https://3y3.dev/ru/tools/docs/translate-xliff.md).

## Использование {#usage}

1. Получите токен авторизации: [OAuth-токен](https://yandex.cloud/ru/docs/iam/concepts/authorization/oauth-token), [IAM-токен](https://yandex.cloud/ru/docs/iam/concepts/authorization/iam-token) или [API-ключ](https://yandex.cloud/ru/docs/iam/operations/api-key/create) сервисного аккаунта.
2. Узнайте [идентификатор каталога](https://yandex.cloud/ru/docs/resource-manager/operations/folder/get-id), для которого у аккаунта есть роль `ai.translate.user` или выше.
3. Оцените объем перевода без запросов к API:

   ```bash
   yfm translate -i ./docs --source ru --target en --auth <токен> --folder <идентификатор> --dry-run
   ```

4. Запустите перевод:

   ```bash
   yfm translate -i ./docs --source ru --target en --auth <токен> --folder <идентификатор>
   ```

Переведенные файлы появятся в папке целевого языка - в примере выше это `docs/en`.

## Параметры {#options}

Общие параметры (`--source`, `--target`, `--files`, `--include`, `--exclude`, `--dry-run` и другие) описаны на странице [Локализация](https://3y3.dev/ru/tools/docs/translate.md#options). Ниже - параметры провайдера `yandex`.

#|
|| **Параметр** | **Описание** ||
|| `--auth` |
Токен авторизации: значение или путь к файлу с токеном. Тип определяется по префиксу: `y0_` - OAuth-токен, `t1.` - IAM-токен, `AQVN` - API-ключ сервисного аккаунта. Обязательный
||
|| `--folder` |
[Идентификатор каталога](https://yandex.cloud/ru/docs/resource-manager/operations/folder/get-id), для которого у аккаунта есть роль `ai.translate.user` или выше. Обязательный
||
|| `--glossary` |
Путь к YAML-файлу с [глоссарием](https://yandex.cloud/ru/docs/translate/concepts/glossary) - парами терминов, которые нужно переводить фиксированно
||
|#

## Лимиты {#limits}

У Yandex Translate есть [ограничения](https://yandex.cloud/ru/docs/translate/concepts/limits) на объем переводимого текста. CLI сокращает объем сам: документы разбиваются на сегменты, повторяющиеся сегменты переводятся один раз.

Если лимит все же превышен, команда завершается ошибкой `TRANSLATE_LIMIT_EXCEED`. В этом случае повторите запуск позже или сузьте набор файлов [фильтрами](https://3y3.dev/ru/tools/docs/translate.md#options) - уже переведенные файлы можно исключить.

Оценить объем текста до запуска помогает опция `--dry-run`.