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

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

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

Чтобы воспользоваться примерами в этом разделе:

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

Чтобы выполнять эти операции от имени сервисного аккаунта:

  1. Назначьте сервисному аккаунту роль editor или выше на каталог, в котором он был создан.
  2. Не указывайте в запросе идентификатор каталога — сервис использует каталог, в котором был создан сервисный аккаунт.
  3. Выберите способ аутентификации: получите IAM-токен или API-ключ.

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

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

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

    В поле targetLanguageCode укажите язык перевода в формате ISO 639-1. Для русского языка это ru. Код языка можно получить вместе со списком поддерживаемых языков.

    {
        "folder_id": "b1gvmob95yysaplct532",
        "texts": ["Hello", "World"],
        "targetLanguageCode": "ru"
    }
    
  2. Передайте файл на перевод с помощью метода 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"
            }
        ]
    }
    

Что дальше