Informazioni su rilevamento della lingua, traduzione e traslitterazione

Completato

Verranno ora esaminate le funzionalità di Traduttore per Azure AI. Tali funzionalità includono:

Rilevamento lingua

È possibile usare la funzione Rileva dell'API REST per rilevare la lingua in cui è scritto il testo.

Ad esempio, è possibile inviare il testo seguente all'endpoint https://api.cognitive.microsofttranslator.com/detect?api-version=3.0 usando curl.

Ecco il testo che si vuole tradurre:

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

Ecco una chiamata che usa curl all'endpoint per rilevare la lingua del testo:

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' : 'こんにちは' }]

La risposta a questa richiesta è simile alla seguente, a indicare che il testo è scritto in giapponese:

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

Traduzione

Per tradurre il testo da una lingua a un'altra, usare la funzione translate specificando un singolo parametro from per indicare la lingua di origine e uno o più parametri to per specificare le lingue in cui si vuole tradurre il testo.

Ad esempio, è possibile inviare lo stesso codice JSON usato in precedenza per rilevare la lingua, specificando un parametro from con il valore ja (giapponese) e due parametri to con i valori en (inglese) e fr (francese). A tale scopo, si chiamerà:

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' : 'こんにちは' }]"

Il risultato generato sarà simile al seguente:

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

Traslitterazione

Il testo giapponese è scritto con lo script dell'alfabeto Hiragana, quindi anziché tradurlo in una lingua diversa, è possibile traslitterarlo in uno script diverso, ad esempio per eseguire il rendering del testo nello script dell'alfabeto latino (usato dal testo in lingua inglese).

A tale scopo, è possibile inviare il testo giapponese alla funzione transliterate con un parametro fromScript con il valore Jpan e un parametro toScript con il valore 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' : 'こんにちは' }]"

La risposta darà il risultato seguente:

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