分享方式：

容器：音譯文字

  • 文章

將來源語言的字元或字母轉換為目標語言的對應字元或字母。

要求 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':'さようなら'}]"

後續步驟

深入瞭解文字音譯