Che cos'è la traduzione testuale di Azure?
Traduzione testuale di Azure è una funzionalità API REST basata sul cloud del servizio Traduttore che usa la tecnologia di traduzione automatica neurale per abilitare la traduzione testuale rapida e accurata da origine a destinazione in tempo reale in tutte le lingue supportate. In questa panoramica si apprenderà come le API REST di Traduzione testuale consentono di creare soluzioni intelligenti per applicazioni e flussi di lavoro.
La documentazione sulla traduzione testuale contiene i tipi di articolo seguenti:
- Avvio rapido. Istruzioni introduttive per guidare l'utente tramite l'esecuzione di richieste al servizio.
- Guide pratiche. Istruzioni per l'accesso e l'uso del servizio in modi più specifici o personalizzati.
- Articoli di riferimento. Documentazione dell'API REST e contenuto basato sul linguaggio di programmazione.
Funzionalità di Traduzione testuale
Traduzione testuale supporta i metodi seguenti:
Lingue. Restituisce un elenco di lingue supportate dalle operazioni di Traduzione, Traslitterazione e Ricerca nel dizionario. Questa richiesta non prevede l'autenticazione; basta copiare e incollare la richiesta GET seguente nel browser o nello strumento dell'API REST preferito:
https://api.cognitive.microsofttranslator.com/languages?api-version=3.0Traduzione. Esegue il rendering di testo in una sola lingua di origine in più testi in lingua di destinazione con una singola richiesta.
Traslitterazione. Converte caratteri o lettere di una lingua di origine nei caratteri o nelle lettere corrispondenti di una lingua di destinazione.
Rilevamento. Restituisce il codice lingua del codice sorgente e una variabile booleana che indica se la lingua rilevata è supportata per la traduzione testuale e la traslitterazione.
Nota
È possibile tradurre, traslitterare e rilevare un testo con una singola chiamata API REST.
Ricerca nel dizionario. Restituisce parole equivalenti per il termine di origine nella lingua di destinazione.
Esempio dizionario Restituisce esempi di struttura grammaticale e contesto per la coppia di termini di origine e di destinazione.
Opzioni di distribuzione di Traduzione testuale
Aggiungere Traduzione testuale ai progetti e alle applicazioni usando le risorse seguenti:
Accedere al servizio Traduttore basato sul cloud tramite l'API REST, disponibile in Azure.
Usare l'API REST translate request con il contenitore Docker di Traduzione testuale.
Importante
Per usare il contenitore Traduttore è necessario completare e inviare il modulo di richiesta onlineServizi di Azure AI per servizi gestiti e riceverne l'approvazione per acquisire l'accesso al contenitore.
L'immagine del contenitore Traduttore supporta funzionalità limitate rispetto alle offerte cloud.
Residenza dei dati
La residenza dei dati di Traduzione testuale dipende dall'area di Azure in cui è stata creata la risorsa Traduttore:
Residenza dei dati di traduzione testuale
✔️ Funzionalità: Traduzione testuale
| Endpoint di servizio | Data center di elaborazione della richiesta |
|---|---|
Globale (scelta consigliata):api.cognitive.microsofttranslator.com |
Data center più vicino disponibile. |
Americhe:api-nam.cognitive.microsofttranslator.com |
Stati Uniti orientali 2 • Stati Uniti occidentali 2 |
Asia Pacificoapi-apc.cognitive.microsofttranslator.com: |
Giappone orientale • Asia sud-orientale |
Europa (ad eccezione della Svizzera):api-eur.cognitive.microsofttranslator.com |
Francia centrale • Europa occidentale |
| Svizzera: per ulteriori informazioni, vedere Endpoint di servizio della Svizzera. |
Svizzera settentrionale • Svizzera occidentale |
Endpoint di servizio Svizzera
I clienti con una risorsa che si trova in Svizzera settentrionale o Svizzera occidentale possono garantire che le richieste dell'API Text vengano gestite in Svizzera. Per assicurarsi che le richieste vengano gestite in Svizzera, creare la risorsa Translator nel Resource region Switzerland North o Switzerland West, quindi usare l'endpoint personalizzato della risorsa nelle richieste API.
Ad esempio: se si crea una risorsa Translator nel portale di Azure con Resource region come Switzerland North e il nome della risorsa è my-swiss-n, l'endpoint personalizzato è https​://my-swiss-n.cognitiveservices.azure.com. Una richiesta di esempio da tradurre è:
// Pass secret key and region using headers to a custom endpoint
curl -X POST "https://my-swiss-n.cognitiveservices.azure.com/translator/text/v3.0/translate?to=fr" \
-H "Ocp-Apim-Subscription-Key: xxx" \
-H "Ocp-Apim-Subscription-Region: switzerlandnorth" \
-H "Content-Type: application/json" \
-d "[{'Text':'Hello'}]" -v
Custom Translator non è attualmente disponibile in Svizzera.
Introduzione alla Traduzione testuale
Preparazione
Creare una risorsa Traduttore nel portale di Azure.
Ottenere le chiavi di accesso e l'endpoint API. Per l'autenticazione sono necessari un URL dell'endpoint e una chiave di sola lettura.
Vedere l'Avvio rapido e visualizzare i casi d'uso e gli esempi di codice per i linguaggi di programmazione seguenti:
Passaggi successivi
Approfondire l'API REST Traduzione testuale: