Translator - Transliterate

Служба:

Azure AI Services

Версия API:

3.0

Преобразует текст языка в один скрипт в другой тип скрипта. Пример: японский скрипт "こんにちは" То же слово в латинском скрипте "konnichiha"

POST {Endpoint}/transliterate?api-version=3.0&language={language}&fromScript={fromScript}&toScript={toScript}

Параметры URI

Имя	В	Обязательно	Тип	Описание
Endpoint	path	True	string	Поддерживаемые конечные точки Cognitive Services
api-version	query	True	string	Версия API, запрошенная клиентом. Значение должно быть 3.0.
fromScript	query	True	string	Задает скрипт, используемый входным текстом. Поддерживаемые языки подстановки с помощью области transliteration для поиска входных скриптов, доступных для выбранного языка.
language	query	True	string	Задает язык текста для преобразования из одного скрипта в другой. Возможные языки перечислены в области transliteration, полученной путем запроса службы на поддерживаемые языки.
toScript	query	True	string	Указывает выходной скрипт. Поддерживаемые языки подстановки с помощью области transliteration для поиска выходных скриптов, доступных для выбранного сочетания языка ввода и скрипта ввода.

Заголовок запроса

Имя	Обязательно	Тип	Описание
X-ClientTraceId		string	Идентификатор GUID, созданный клиентом, однозначно идентифицирует запрос. Обратите внимание, что этот заголовок можно опустить, если вы включаете идентификатор трассировки в строку запроса с помощью параметра запроса с именем ClientTraceId.

Текст запроса

Имя	Тип	Описание
texts	TransliterateTextInput[]	Текст запроса Текст запроса — это массив JSON. Каждый элемент массива представляет собой объект JSON со строковым свойством с именем Text, который представляет строку для преобразования. Применяются следующие ограничения: Массив может содержать не более 10 элементов. Текстовое значение элемента массива не может превышать 1000 символов, включая пробелы. Весь текст, включенный в запрос, не может превышать 5000 символов, включая пробелы. Текст ответа Успешный ответ — это массив JSON с одним результатом для каждого элемента в входном массиве. Результирующий объект содержит следующие свойства: text— строка, которая является результатом преобразования входной строки в выходной скрипт. script— строка, указывающая скрипт, используемый в выходных данных.

Ответы

Имя	Тип	Описание
200 OK	TransliterateResult[]	Успех
Other Status Codes	ErrorMessage	Ответ на ошибку.

Безопасность

Ocp-Apim-Subscription-Key

Тип: apiKey
В: header

Ocp-Apim-Subscription-Key

Тип: apiKey
В: header

Ocp-Apim-Subscription-Region

Тип: apiKey
В: header

Примеры

Transliterate success example

Образец запроса

HTTP

POST https://api.cognitive.microsofttranslator.com/transliterate?api-version=3.0&language=ja&fromScript=jpan&toScript=latn

Пример ответа

Код состояния:

200

[
  {
    "text": "sodeska",
    "script": "latn"
  }
]

Определения

Имя	Описание
Error
ErrorMessage
TransliterateResult	Пример успешного запроса транслитерации
TransliterateTextInput	Текст, необходимый для запроса транслитерации

Error

Object

Имя	Тип	Описание
code	string
message	string

ErrorMessage

Object

Имя	Тип	Описание
error	Error

TransliterateResult

Object

Пример успешного запроса транслитерации

Имя	Тип	Описание
script	string
text	string

TransliterateTextInput

Object

Текст, необходимый для запроса транслитерации

Имя	Тип	Описание
text	string