Migrazione di Traduttore da V2 a V3
Nota
La V2 è stato deprecata il 30 aprile 2018. Eseguire la migrazione delle applicazioni alla versione 3 per sfruttare le nuove funzionalità disponibili esclusivamente nella V3. La V2 è stato ritirata il 24 maggio 2021.
Il team di Microsoft Translator ha rilasciato la versione 3 (V3) del Traduttore. Questa versione include nuove funzionalità, metodi deprecati e un nuovo formato per inviare e ricevere dati dal servizio Microsoft Translator. Questo documento fornisce informazioni per modificare le applicazioni da usare nella V3.
Alla fine di questo documento sono riportati collegamenti utili per avere maggiori informazioni.
Riepilogo delle funzionalità
- Senza tracciabilità: nella V3 la funzione Senza tracciabilità si applica a tutti i piani tariffari nel portale di Azure. Questa funzionalità indica che nessun testo inviato all'API V3 verrà salvato da Microsoft.
- JSON: XML viene sostituito da JSON. Tutti i dati inviati al servizio e ricevuti dal servizio sono in formato JSON.
- Più lingue di destinazione in una singola richiesta: il metodo "Translate" accetta più lingue di destinazione per la traduzione in una singola richiesta. Ad esempio, una singola richiesta può essere ''dalla'' lingua inglese e ''alla'' lingua tedesca, spagnola e giapponese o qualsiasi altro gruppo di lingue.
- Dizionario bilingue: all'API è stato aggiunto un metodo "Bilingual dictionary". Questo metodo include ''ricerca'' e ''esempi''.
- Traslitterazione: all'API è stato aggiunto un metodo "Transliterate". Questo metodo convertirà parole e frasi in un unico script in un altro script. Ad esempio, dall'arabo al latino.
- Lingue: un nuovo metodo "Languages" offre informazioni sulla lingua, in formato JSON, per l'utilizzo con i metodi "translate", "dictionary" e "transliterate".
- Novità di Translate: sono state aggiunte nuove funzioni per il metodo "Translate", in modo da supportare alcune delle funzionalità dell'API V2 come metodi separati. Un esempio è TranslateArray.
- Metodo Speak: la funzionalità di sintesi vocale non è più supportata in Microsoft Translator. La funzionalità di sintesi vocale è disponibile nel servizio Voce Microsoft.
L'elenco di metodi delle versioni 2 e 3 seguente individua le API e i metodi della versione 3 che forniranno le funzionalità della versione 2.
| Metodo API V2 | Compatibilità API V3 |
|---|---|
Translate |
Traduci |
TranslateArray |
Traduci |
GetLanguageNames |
Lingue |
GetLanguagesForTranslate |
Lingue |
GetLanguagesForSpeak |
Servizio Voce Microsoft |
Speak |
Servizio Voce Microsoft |
Detect |
Rileva |
DetectArray |
Rileva |
AddTranslation |
La funzionalità non è più supportata |
AddTranslationArray |
La funzionalità non è più supportata |
BreakSentences |
BreakSentence |
GetTranslations |
La funzionalità non è più supportata |
GetTranslationsArray |
La funzionalità non è più supportata |
Passare al formato JSON
La Traduzione Microsoft Translator V2 ha accettato e restituito i dati in formato XML. Nella V3 tutti i dati inviati e ricevuti tramite l'API sono in formato JSON. La V3 non accetterà o restituirà più il formato XML.
Tale modifica interesserà diversi aspetti di un'applicazione scritta per l'API Traduzione testuale della V2. Ad esempio, l'API Languages restituisce informazioni sulla lingua per i metodi di traduzione testuale, traslitterazione e i due metodi del dizionario. È possibile richiedere tutte le informazioni sulla lingua per tutti i metodi in un'unica chiamata o richiederle singolarmente.
Il metodo Languages non richiede l'autenticazione. Selezionando il collegamento seguente è possibile visualizzare tutte le informazioni sulla lingua per la V3 in formato JSON:
Chiave di autenticazione
La chiave di autenticazione in uso per la V2 verrà accettata per la V3. Non è necessario ottenere una nuova sottoscrizione. Sarà possibile combinare la V2 e la V3 nelle app in tutto il periodo di migrazione, semplificando il rilascio di nuove versioni durante la migrazione dal formato XML della V2 al formato JSON della V3.
Modello tariffario
Microsoft Translator V3 ha lo stesso prezzo della V2; per ogni carattere, inclusi gli spazi. Le nuove funzionalità della V3 apportano alcune modifiche al conteggio dei caratteri per la fatturazione.
| Metodo V3 | Caratteri conteggiati per la fatturazione |
|---|---|
Languages |
Nessun carattere inviato, nessuno conteggiato, nessun addebito. |
Translate |
Il conteggio si basa sul numero di caratteri inviato per la traduzione e sul numero delle lingue in cui vengono tradotti i caratteri. 50 caratteri inviati e 5 lingue richieste faranno 50 x 5. |
Transliterate |
Viene conteggiato il numero di caratteri inviati per la traslitterazione. |
Dictionary lookup & example |
Viene conteggiato il numero di caratteri inviato per la ricerca nel dizionario e gli esempi. |
BreakSentence |
Nessun addebito. |
Detect |
Nessun addebito. |
Obiettivi della V3
Generale
- api.cognitive.microsofttranslator.com
Metodi delle traduzioni testuali dell'API V3
Compatibilità e personalizzazione
Nota
Microsoft Translator Hub verrà ritirato il 17 maggio 2019. Visualizzare informazioni e date importanti sulla migrazione.
Microsoft Translator V3 usa la traduzione neurale automatica per impostazione predefinita. Di conseguenza, non può essere usato con l'hub di Microsoft Translator, che supporta solo la traduzione automatica statistica legacy. La personalizzazione per la traduzione neurale è ora disponibile usando Custom Translator (traduttore personalizzato). Altre informazioni sulla personalizzazione della traduzione automatica neurale
La traduzione neurale con l'API testuale V3 non supporta l'uso delle categorie standard (SMT, voce, tecnologia, generalnn).
| Versione | Endpoint | Conformità al processore GDPR | Usare l'Hub di Translator | Usare il traduttore personalizzato (anteprima) |
|---|---|---|---|---|
| Traduttore Versione 2 | api.microsofttranslator.com | No | Sì | No |
| Traduttore Versione 3 | api.cognitive.microsofttranslator.com | Sì | No | Sì |
Traduttore Versione 3
- È disponibile a livello generale e completamente supportata.
- È un processore conforme al GDPR e soddisfa tutti i requisiti ISO 20001 e 20018 nonché i requisiti della certificazione SOC 3.
- Consente di richiamare i sistemi di traduzione di rete neurale che sono stati personalizzati con il traduttore personalizzato (anteprima), la nuova funzionalità di personalizzazione di Translator NMT.
- Non fornisce l'accesso ai sistemi di traduzione personalizzati creati tramite l'Hub di Microsoft Translator.
Se si usa l'endpoint api.cognitive.microsofttranslator.com, si usa la versione 3 del Traduttore.
Traduttore Versione 2
- Non soddisfa tutti i requisiti di certificazione 20001,20018 ISO e SOC 3.
- Non consente di richiamare i sistemi di traduzione di rete neurale che sono stati personalizzati con la funzionalità di personalizzazione di Translator.
- Fornisce l'accesso ai sistemi di traduzione personalizzati creati tramite l'Hub di Microsoft Translator.
- Se si usa l'endpoint api.microsofttranslator.com, si usa la versione 2 del Traduttore.
Nessuna versione del Traduttore crea un record delle traduzioni. Le traduzioni non vengono mai condivise con altri. Altre informazioni sulla pagina Web Nessuna traccia relativa a Translator.
Collegamenti
- Informativa sulla privacy di Microsoft
- Informazioni legali su Microsoft Azure
- Condizioni per i servizi online