Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Novità
La versione 3.0 di Translator fornisce un'API Web moderna basata su JSON. Migliora l'usabilità e le prestazioni consolidando le funzionalità esistenti in meno operazioni e offre nuove funzionalità.
- Traslitterazione per convertire il testo in una lingua da uno script a un altro.
- Traduzione in più lingue in una richiesta.
- Rilevamento della lingua, traduzione e traslitterazione in una richiesta.
- Dizionario per cercare traduzioni alternative di un termine, per trovare traduzioni e esempi che mostrano i termini usati nel contesto.
- Risultati di rilevamento del linguaggio più informativi.
URL di base
L'URL di base globale è https://api.cognitive.microsofttranslator.com. La traduzione testuale supporta anche endpoint geografici e specifici delle risorse. Per tutti gli URL degli endpoint e i percorsi di elaborazione delle richieste, vedere Supporto dell'area per Traduttore di Azure.
supporto Rete virtuale
Translator è ora disponibile con funzionalità di Rete virtuale (VNET) in tutte le aree del cloud pubblico Azure. Per abilitare Rete virtuale, SeeConfiguring Foundry Tools virtual networks.
Dopo aver attivato questa funzionalità, è necessario usare l'endpoint personalizzato per chiamare Translator. Non è possibile usare l'endpoint traduttore globale ("api.cognitive.microsofttranslator.com") e non è possibile eseguire l'autenticazione con un token di accesso.
È possibile trovare l'endpoint personalizzato dopo aver creato una risorsa traduttore e consentire l'accesso da reti selezionate ed endpoint privati.
Passare alla risorsa Traduttore nel portale di Azure.
Selezionare Rete nella sezione Gestione risorse.
Nella scheda Firewall e reti virtuali scegliere Reti selezionate ed endpoint privati.
Seleziona Salva per applicare le modifiche.
Selezionare Chiavi ed endpoint nella sezione Gestione risorse .
Selezionare la scheda Rete virtuale.
Nell'elenco sono elencati gli endpoint per la traduzione testuale e la traduzione dei documenti.
| Intestazioni | Description |
|---|---|
| Ocp-Apim-Subscription-Key | Il valore è la chiave privata Azure per la sottoscrizione a Translator. |
| Ocp-Apim-Subscription-Region | Il valore è l'area della risorsa traduttore. Questo valore è facoltativo se la risorsa è global |
Ecco una richiesta di esempio per chiamare Translator usando l'endpoint personalizzato
// Pass secret key and region using headers
curl -X POST "https://<your-custom-domain>.cognitiveservices.azure.com/translator/text/v3.0/translate?api-version=3.0&to=es" \
-H "Ocp-Apim-Subscription-Key:<your-key>" \
-H "Ocp-Apim-Subscription-Region:<your-region>" \
-H "Content-Type: application/json" \
-d "[{'Text':'Hello, what is your name?'}]"
Metrics
Le metriche consentono di visualizzare le informazioni sull'utilizzo e sulla disponibilità del traduttore nel portale di Azure. Per altre informazioni, vedere Metriche dei dati e della piattaforma.
Questa tabella elenca le metriche disponibili con la descrizione del modo in cui vengono usate per monitorare le chiamate API di traduzione.
| Metrics | Description |
|---|---|
| TotalCalls | Numero totale di chiamate API. |
| TotalTokenCalls | Numero totale di chiamate API tramite il servizio token usando il token di autenticazione. |
| SuccessfulCalls | Numero di chiamate riuscite. |
| TotalErrors | Numero di chiamate con risposta di errore. |
| BlockedCalls | Numero di chiamate che hanno superato il limite di frequenza o di quota. |
| ServerErrors | Numero di chiamate con errore interno del server (5XX). |
| ClientErrors | Numero di chiamate con errore sul lato client (4XX). |
| Latenza | Durata del completamento della richiesta in millisecondi. |
| CharactersTranslated | Numero totale di caratteri nella richiesta di testo in ingresso. |