Как начать работать c Translate

Статья создана

Перед началом
Перевести текст с любого языка

В этом разделе вы научитесь переводить текст, используя Translate API. Чтобы перевести текст, передайте его с помощью метода translate.

Перед началом

Чтобы воспользоваться примерами, установите cURL и получите данные вашего аккаунта для авторизации:

Аккаунт пользователя на Яндексе

Сервисный аккаунт

Федеративный аккаунт

На странице биллинга убедитесь, что платежный аккаунт находится в статусе ACTIVE или TRIAL_ACTIVE. Если платежного аккаунта нет, создайте его.
Получите IAM-токен, необходимый для аутентификации.
Получите идентификатор любого каталога, на который у вашего аккаунта есть роль editor или выше.

Выберите способ аутентификации:
- Получите IAM-токен, используемый в примерах.
- Создайте API-ключ. Передайте API-ключ в заголовке Authorization в следующем формате:
```
Authorization: Api-Key <API-ключ>
```
Назначьте сервисному аккаунту роль editor или выше на каталог, в котором он был создан.

Не указывайте в запросах идентификатор каталога — сервис использует каталог, в котором был создан сервисный аккаунт.

Аутентифицируйтесь в CLI от имени федеративного пользователя.
С помощью CLI получите IAM-токен, необходимый для аутентификации:
```
$ yc iam create-token
```
Получите идентификатор любого каталога, на который у вашего аккаунта есть роль editor или выше.

Перевести текст с любого языка

В этом примере показано, как перевести на русский язык две строки с текстом: Hello и World. Язык текста будет определен автоматически.

Создайте файл с телом запроса, например body.json.
В folderId укажите идентификатор каталога. Строки текста для перевода перечислите в поле texts.

В поле targetLanguageCode укажите язык перевода в формате ISO 639-1. Для русского языка это ru. Код языка можно получить вместе со списком поддерживаемых языков.
```
{
    "folderId": "b1gvmob95yysaplct532",
    "texts": ["Hello", "World"],
    "targetLanguageCode": "ru"
}
```

Передайте файл на перевод с помощью метода translate:

$ export IAM_TOKEN=CggaATEVAgA...
$ curl -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer ${IAM_TOKEN}" \
    -d '@body.json' \
    "https://translate.api.cloud.yandex.net/translate/v2/translate"

В ответе сервис вернет переведенные строки текста:

{
    "translations": [
        {
        "text": "Привет",
        "detectedLanguageCode": "en"
        },
        {
        "text": "Мир",
        "detectedLanguageCode": "en"
        }
    ]
}

Как начать работать c Translate

Перед началом

Перевести текст с любого языка

Что дальше

Была ли статья полезна?