Метод translate
Переводит текст на указанный язык.
HTTP-запрос
POST https://translate.api.cloud.yandex.net/translate/v2/translate
Параметры в теле запроса
{
"sourceLanguageCode": "string",
"targetLanguageCode": "string",
"format": "string",
"texts": [
"string"
],
"folderId": "string",
"model": "string",
"glossaryConfig": {
"glossaryData": {
"glossaryPairs": [
{
"sourceText": "string",
"translatedText": "string"
}
]
}
}
}
| Поле | Описание |
|---|---|
| sourceLanguageCode | string Язык, на котором написан исходный текст. Указывается в формате ISO 639-1 (например, Обязательно при переводе с глоссарием. Максимальная длина строки в символах — 3. |
| targetLanguageCode | string Обязательное поле. Язык, на который переводится текст. Указывается в формате ISO 639-1 (например, Максимальная длина строки в символах — 3. |
| format | string Формат текста.
|
| texts[] | string Обязательное поле. Массив строк для перевода. Максимальная общая длина всех строк составляет 10000 символов. Должен содержать хотя бы один элемент. |
| folderId | string Идентификатор каталога, к которому у вас есть доступ. Требуется для авторизации с пользовательским аккаунтом (см. ресурс UserAccount ). Не используйте это поле, если вы делаете запрос от имени сервисного аккаунта. Максимальная длина строки в символах — 50. |
| model | string Не используйте это поле, пользовательские модели пока не поддерживаются. Максимальная длина строки в символах — 50. |
| glossaryConfig | object Глоссарий для применения при переводе. Дополнительные сведения см. в разделе Глоссарии. |
| glossaryConfig. glossaryData |
object Передать содержимое глоссария в запросе. В настоящее время поддерживается только этот способ передачи глоссария. |
| glossaryConfig. glossaryData. glossaryPairs[] |
object Обязательное поле. Массив текстовых пар. Максимальная общая длина всех исходных текстов 10000 символов. Максимальная общая длина всех переведенных текстов 10000 символов. Количество элементов должно находиться в диапазоне от 1 до 50. |
| glossaryConfig. glossaryData. glossaryPairs[]. sourceText |
string Обязательное поле. Текст на языке оригинала. |
| glossaryConfig. glossaryData. glossaryPairs[]. translatedText |
string Обязательное поле. Текст на языке перевода. |
Ответ
HTTP Code: 200 - OK
{
"translations": [
{
"text": "string",
"detectedLanguageCode": "string"
}
]
}
| Поле | Описание |
|---|---|
| translations[] | object Массив переводов. |
| translations[]. text |
string Переведенный текст. |
| translations[]. detectedLanguageCode |
string Код языка исходного текста. Указывается в формате ISO 639-1 (например, |