了解語言偵測、翻譯和音譯

已完成

讓我們探索 Azure AI 翻譯工具的功能。 這些功能包括:

語言偵測

您可以使用 REST API 的偵測函式來偵測撰寫文字所使用的語言。

例如,您可以使用 curl 將下列文字提交至 https://api.cognitive.microsofttranslator.com/detect?api-version=3.0 端點。

以下是我們想要翻譯的文字:

{ 'Text' : 'こんにちは' }

以下是使用 curl 呼叫端點來偵測文字的語言:

curl -X POST "https://api.cognitive.microsofttranslator.com/detect?api-version=3.0" -H "Ocp-Apim-Subscription-Region: <your-service-region>" -H "Ocp-Apim-Subscription-Key: <your-key>" -H "Content-Type: application/json" -d "[{ 'Text' : 'こんにちは' }]

對此要求的回應會看起來如下所示,表示文字以日文撰寫:

[
  {
    "language": "ja",
    "score": 1.0,
    "isTranslationSupported": true,
    "isTransliterationSupported": true
    
    
   }
]

翻譯

若要將文字從某種語言翻譯成另一種語言,請使用翻譯函式;指定單一 from 參數以表示來源語言,以及一或多個 to 參數來指定您要翻譯成的目標語言。

例如,您可以提交先前用來偵測語言的相同 JSON,指定 from 參數為 ja (日文),並且將兩個 to 參數指定為值 en (英文) 和 fr (法文)。 若要這樣做,您要呼叫:

curl -X POST "https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&from=ja&to=fr&to=en" -H "Ocp-Apim-Subscription-Key: <your-key>" -H "Ocp-Apim-Subscription-Region: <your-service-region>" -H "Content-Type: application/json; charset=UTF-8" -d "[{ 'Text' : 'こんにちは' }]"

這會產生下列結果:

[
  {"translations": 
    [
      {"text": "Hello", "to": "en"},   
      {"text": "Bonjour", "to": "fr"}
    ]
  }
]

音譯

我們的日文文字以平假名指令碼撰寫,不必翻譯成其他語言,建議音譯為另一種令碼,例如,以拉丁指令碼轉譯文字 (如同英文語言文字的用法一樣)。

為了達到這個目的,我們可以將日文文字提交給音譯函式,其中 fromScript 參數為 Jpan,而 toScript 參數則為 Latn

curl -X POST "https://api.cognitive.microsofttranslator.com/transliterate?api-version=3.0&fromScript=Jpan&toScript=Latn" -H "Ocp-Apim-Subscription-Key: <your-key>" -H "Ocp-Apim-Subscription-Region: <your-service-region>" -H "Content-Type: application/json" -d "[{ 'Text' : 'こんにちは' }]"

回應的結果會如下所示:

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