你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

容器：转译文本

项目
09/01/2024

将源语言的字符或字母转换为目标语言的相应字符或字母。

请求 URL

POST 请求：

 POST http://localhost:{port}/transliterate?api-version=3.0&language={language}&fromScript={fromScript}&toScript={toScript}

请参阅虚拟网络支持，以了解翻译器服务选择的网络和专用终结点配置与支持。

请求参数

查询字符串上传递的请求参数如下：

查询参数	说明	条件
api-version	客户端所请求的 API 的版本。值必须是 `3.0`。	必需参数
language	指定要从一个脚本转换为另一个脚本的文本的源语言。	必需参数
fromScript	指定输入文本所使用的脚本。	必需参数
toScript	指定输出脚本。	必需参数

可以查询服务中transliteration支持的语言范围。
另请参阅语言对音译的支持。

请求标头

头文件	说明	条件
身份验证标头	请参阅可用的身份验证选项	所需的请求标头
Content-Type	指定有效负载的内容类型。可能的值： `application/json`	所需的请求标头
Content-Length	请求正文的长度。	可选
X-ClientTraceId	客户端生成的 GUID，用于唯一标识请求。如果在查询字符串中使用名为 `ClientTraceId` 的查询参数包括了跟踪 ID，则可以省略此标头。	可选

响应正文

成功的响应是一个 JSON 数组，其中的每个结果对应于输入数组中的一个元素。结果对象包括以下属性：

text：一个字符串，它是将输入字符串转换为输出脚本的结果。
script：一个字符串，指定输出中使用的脚本。

响应标头

头文件	说明
X-RequestId	服务生成的用于标识请求的值。它可用于故障排除目的。

示例请求

curl -X POST "http://localhost:5000/transliterate?api-version=3.0&language=ja&fromScript=Jpan&toScript=Latn"

示例请求正文

请求的正文是一个 JSON 数组。每个数组元素都是一个 JSON 对象，具有一个名为 Text 的字符串属性，该属性表示要转换的字符串。

[
    {"Text":"こんにちは"},
    {"Text":"さようなら"}
]

以下限制适用：

数组最多可以包含 10 个元素。
数组元素的文本值不能超过 1000 个字符 (包括空格)。
请求中包含的整个文本不能超过 5000 个字符 (包括空格)。

示例 JSON 响应：

[
  {
    "text": "Kon'nichiwa",
    "script": "Latn"
  },
  {
    "text": "sayonara",
    "script": "Latn"
  }
]

注意

每个示例都运行在 localhost 使用 docker run 命令指定的实例上。
在容器运行时， localhost 指向容器本身。
你不必使用 localhost:5000。可以使用主机环境中尚未使用的任何端口。

使用 REST API 进行音译


  curl -X POST "http://localhost:5000/transliterate?api-version=3.0&language=ja&fromScript=Jpan&toScript=Latn" -H "Content-Type: application/json" -d "[{'Text':'こんにちは'},{'Text':'さようなら'}]"

后续步骤

了解有关文本音译的详细信息

通过