Перевод текста
Чтобы перевести текст, передайте его с помощью метода translate.
Пример в этом разделе совпадает с примером из раздела Как начать работать c 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
.
Вfolder_id
укажите идентификатор каталога. Строки текста для перевода перечислите в полеtexts
.В поле
targetLanguageCode
укажите язык перевода в формате ISO 639-1. Для русского языка этоru
. Код языка можно получить вместе со списком поддерживаемых языков.{ "folder_id": "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" } ] }