Связаться с намиПодключиться

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

Статья создана
Улучшена
Обновлена 4 октября 2024 г.

Yandex Translate предоставляет API для интеграции технологий перевода в свои приложения. Если вы хотите использовать для перевода графический интерфейс, воспользуйтесь Яндекс Переводчиком.

В этом разделе вы научитесь переводить текст, используя Translate API.

Чтобы воспользоваться примерами, установите cURL.

Больше примеров на разных языках программирования доступно в пошаговых инструкциях.

О том, как создать сервисный аккаунт и API-ключ для интеграции Yandex Translate в свое приложение, см. Настройка доступа с помощью API-ключа.

Перед началом работы

  1. На странице Биллинг убедитесь, что платежный аккаунт находится в статусе ACTIVE или TRIAL_ACTIVE. Если платежного аккаунта нет, создайте его.

  2. Получите данные вашего аккаунта для авторизации:

    1. Получите IAM-токен для аккаунта на Яндексе или федеративного аккаунта, необходимый для аутентификации. Передавайте полученный токен в заголовке Authorization каждого запроса в формате:

      Authorization: Bearer <IAM-токен>

    2. Получите идентификатор любого каталога, на который у вашего аккаунта есть роль ai.translate.user или выше. Идентификатор каталога должен передаваться в теле каждого запроса в поле folderId.

Перевести текст

Пример ниже разработан для выполнения в операционных системах MacOS и Linux. Чтобы выполнить его в системе Windows, ознакомьтесь с особенностями работы с Bash в Microsoft Windows.

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

  1. Создайте файл с телом запроса (например, body.json):

    {
    "folderId": "<идентификатор_каталога>",
    "texts": ["Hello", "World"],
    "targetLanguageCode": "ru"
}

    Где:

  2. Передайте файл на перевод, выполнив команду:

    export IAM_TOKEN=<IAM-токен>
curl \
  --request POST \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer ${IAM_TOKEN}" \
  --data '@<путь_до_файла_json>' \
  "https://translate.api.cloud.yandex.net/translate/v2/translate"

    Где IAM_TOKEN — IAM-токен, полученный перед началом работы.

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

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

Что дальше

Следующая
Все инструкции