Migrazione di Traduttore da V2 a V3

Articolo
09/03/2024

Nota

La V2 è stata deprecata il 30 aprile 2018. Eseguire la migrazione delle applicazioni alla versione 3 per sfruttare le nuove funzionalità disponibili esclusivamente nella V3. La V2 è stata ritirata il 24 maggio 2021.

La versione 3 (V3) del servizio Traduttore è disponibile a livello generale. Questa versione include nuove funzionalità, metodi deprecati e un nuovo formato per l’invio e la ricezione di 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à significa che il servizio non salva il testo inviato alla versione 3 dell’API.
JSON : XML sostituisce 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 di traduzione accetta più lingue di destinazione to per la traduzione in una singola richiesta. Ad esempio, una singola richiesta può essere in inglese from e in tedesco, spagnolo e giapponese to o in qualsiasi altro gruppo di lingue.
Dizionario bilingue: all'API viene aggiunto un metodo con dizionario bilingue. Questo metodo include lookup e examples.
Traslitterazione: all'API viene aggiunto un metodo traslitterato. Questo metodo converte parole e frasi presenti in uno script in un altro script. Ad esempio, dall'arabo al latino.
Lingue: un nuovo languages metodo fornisce informazioni sulle lingue, in formato JSON, che possono essere usate con i metodi translate, dictionary e transliterate.
Novità per la traduzione: sono state aggiunte nuove funzionalità per il metodo translate, in modo da supportare alcune delle funzionalità della versione 2 dell’API come metodi separati. Un esempio è TranslateArray.
Metodo Voce: 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 i metodi e le API 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 in Microsoft Translator V2 accettava e restituiva i dati in formato XML. Nella versione 3 tutti i dati inviati e ricevuti tramite l'API sono in formato JSON. XML non è più accettato o restituito nella versione 3.

Tale modifica interesserà diversi aspetti di un'applicazione scritta per la versione 2 dell’API di Traduzione testuale. 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 linguistico non richiede l'autenticazione. Se si seleziona il collegamento seguente è possibile visualizzare tutte le informazioni sulla lingua per la versione 3 in formato JSON:

https://api.cognitive.microsofttranslator.com/languages?api-version=3.0& scope=translation,dictionary,transliteration

Chiave di autenticazione

La chiave di autenticazione usata per versione 2 è accettata anche dalla versione 3. Non è necessario ottenere una nuova sottoscrizione. Durante tutto il periodo di migrazione sarà possibile combinare le versioni 2 e 3 nelle app. Ciò ha lo scopo di semplificare il rilascio di nuove versioni durante la migrazione dal formato XML della versione 2 al formato JSON della versione 3.

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 conteggiati come 50x5.
`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

L'Hub di Microsoft Translator 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 di testo della versione 3 non supporta l'uso di categorie standard (SMT, speech, tech, 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 personalizzati con Traduttore personalizzato (anteprima), la nuova funzionalità di personalizzazione di Traduzione automatica neurale (NMT) di Translator.
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, significa che si sta usando la versione 3 di 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 personalizzati con la funzionalità di personalizzazione di Traduttore.
Non fornisce l'accesso ai sistemi di traduzione personalizzati creati tramite l'Hub di Microsoft Translator.
Usa l'endpoint api.microsofttranslator.com.

Nessuna versione di 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

Passaggi successivi

Visualizza la documentazione sulla V3.0

Condividi tramite