容器:音譯文字
將來源語言的字元或字母轉換為目標語言的對應字元或字母。
要求 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 | 指定輸出文稿。 | 必要參數 |
要求標頭
標題 | 描述 | 條件 |
---|---|---|
驗證標頭 | 請參閱可用的驗證選項 | 必要要求標頭 |
內容-類型 | 指定承載的內容類型。 可能的值: application/json |
必要要求標頭 |
Content-Length | 要求本文的長度。 | 選擇性 |
X-ClientTraceId | 用於識別唯一要求的 GUID,由用戶端產生。 如果您使用名為 ClientTraceId 的查詢參數,在查詢字串中包含追蹤標識碼,則可以省略此標頭。 |
選擇性 |
回應本文
成功的回應是 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個專案。
- 陣列專案的文字值不能超過1,000個字元,包括空格。
- 要求中包含的整個文字不能超過5,000個字元,包括空格。
範例 JSON 回應:
[
{
"text": "Kon'nichiwa",
"script": "Latn"
},
{
"text": "sayonara",
"script": "Latn"
}
]
注意
- 每個範例都會在您使用 命令指定的
docker run
上localhost
執行。 - 當您的容器正在執行時,
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':'さようなら'}]"