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	支持的认知服务终结点
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 的查询参数在查询字符串中包含跟踪 ID，则可以省略此标头。

请求正文

名称	类型	说明
texts	TransliterateTextInput[]	请求主体 请求的正文是一个 JSON 数组。 每个数组元素都是一个 JSON 对象，具有一个名为 Text 的字符串属性，该属性表示要转换的字符串。 以下限制适用： 数组最多可以有 10 个元素。 数组元素的文本值不能超过 1,000 个字符（包括空格）。 请求中包含的整个文本不能超过 5,000 个字符，包括空格。 响应体 成功的响应是一个 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