Che cos'è la traduzione del testo di Azure in Microsoft Foundry?

Azure traduzione testuale è un'API REST basata sul cloud per la traduzione multilingue in più di 100 lingue e dialetti supportati. È possibile integrarlo in applicazioni, servizi e flussi di lavoro di automazione per tradurre il testo in tempo reale su larga scala usando API REST o SDK.

La versione più recente disponibile a livello generale è 2026-06-06. Questa versione introduce uno schema di richiesta e risposta modificato, aggiunge il supporto per la selezione del modello tra NMT (Neural Machine Translation) standard e i modelli di linguaggio large supportati e espande i controlli di traduzione per scenari che richiedono variazioni adattive di output, tono e genere.

Translator è progettato per carichi di lavoro multilingue con volumi elevati in cui la coerenza, la scalabilità e il controllo operativo sono importanti. Se attualmente utilizzi la versione 3.0, pianifica la migrazione e la verifica prima dell'implementazione, poiché 2026-06-06 introduce modifiche che comportano incompatibilità.

Novità in 2026-06-06 (GA)

La versione 2026-06-06 dell'API è disponibile a livello generale e include modifiche di rilievo rispetto alla versione 3.0.

Questa versione aggiunge nuovi controlli di conversione e opzioni del modello durante l'aggiornamento dei contratti di richiesta e risposta. Se si esegue la migrazione dalla versione 3.0, pianificare un passaggio di convalida completo per la forma del payload, l'analisi delle risposte e i controlli di qualità di produzione prima dell'implementazione.

Importante

  • L'API REST di Traduttore di Azure 2026-06-06 introduce modifiche che comportano l'incompatibilità con le versioni precedenti.
  • Testare accuratamente le applicazioni prima di eseguire la migrazione dei carichi di lavoro di produzione dalla versione 3.0.
  • Convalidare i percorsi di codice e i flussi di lavoro interni e limitare l'uso di produzione alle versioni completamente testate.

Gli aggiornamenti principali in 2026-06-06 includono:

  • Schema JSON della richiesta e della risposta modificato. La matrice di richieste usa inputse la matrice di risposte usa value. Per un esempio end-to-end, vedere la guida all'API REST.
  • Scelta del modello (NMT o LLM). È possibile selezionare NMT standard o una distribuzione LLM (ad esempio GPT-5.1) in base ai requisiti di qualità, costo e scenario. L'uso della traduzione basata su LLM richiede una risorsa Microsoft Foundry. Per indicazioni sulla configurazione, vedere Creare risorse di Translator.
  • Traduzione personalizzata adattiva. È possibile fornire fino a cinque traduzioni di riferimento o un ID di indice del set di dati adattivo per influenzare lo stile e la terminologia di output LLM. Per altre informazioni, vedere Traduzione personalizzata adattiva.
  • Controlli del tono di voce e del genere. La traduzione basata su LLM supporta varianti di tono (formale, informale, neutro) e controlli dell’output specifici per genere.

Operazioni principali

L'API 2026-06-06 include le operazioni principali seguenti:

Queste operazioni riguardano le più comuni esigenze di runtime per le pipeline di localizzazione del testo: individuazione di lingue supportate, traduzione di testo su larga scala e traslitterazione di script per coppie di lingue che richiedono la conversione di script.

  • Lingue: restituisce le lingue supportate per le operazioni di traduzione. Questa richiesta non richiede l'autenticazione.

    https://api.cognitive.microsofttranslator.com/languages?api-version=2026-06-06

  • Translate: converte il testo di origine in una o più lingue di destinazione in una singola POST richiesta.

  • Traslitterare: converte gli script o i set di caratteri da un sistema di scrittura a un altro.

Per una procedura dettagliata completa per le richieste, vedere la guida all'API REST.

Opzioni di sviluppo

Usare le opzioni seguenti per compilare e distribuire soluzioni di traduzione testuale multilingue nelle applicazioni e nei flussi di lavoro:

Scegliere il percorso di integrazione in base al controllo e all'automazione necessari. La maggior parte dei sistemi di produzione usa l'integrazione diretta dell'API REST o dell'SDK, mentre i flussi di lavoro del portale possono essere utili per la configurazione, il test e la risoluzione dei problemi operativi.

Opzione di sviluppo Descrizione
Portale di Microsoft Foundry Usare Microsoft Foundry per gestire progetti, modelli e risorse di intelligenza artificiale correlate.
API REST Integrare direttamente con le API REST di traduzione testuale.
Librerie client (SDKs) Sviluppa con gli SDK supportati utilizzando le guide introduttive alla libreria client .
Contenitore Docker Usare il contenitore di Translator per gli scenari disconnessi o controllati supportati. Iniziare con Container: tradurre il testo.

Autenticazione

Tutte le richieste di traduzione testuale richiedono intestazioni di autenticazione. Per le distribuzioni in produzione, scegli un approccio in linea con il tuo modello operativo e di sicurezza. Le chiavi delle risorse sono semplici da iniziare, mentre Microsoft Entra ID è in genere preferibile per gli ambienti aziendali che richiedono l'identità centralizzata e l'accesso senza chiave.

Metodo Descrizione
Chiave di risorsa Passa Ocp-Apim-Subscription-Key dalla tua risorsa Translator.
Token di accesso Ottenere un token con durata limitata e inviarlo nell'intestazione Authorization .
Microsoft Entra ID Usa le identità gestite o le entità servizio per l'autenticazione senza chiavi.

Per le intestazioni obbligatorie e gli esempi specifici per l'endpoint, vedere Autenticazione e autorizzazione.

Endpoint e residenza dei dati

La traduzione testuale supporta endpoint globali, geografici e specifici delle risorse. La selezione dell'endpoint determina dove Translator elabora le richieste NMT. Per gli URL degli endpoint, le posizioni di elaborazione e le differenze di distribuzione LLM di Foundry, vedere Supporto delle aree per Traduttore di Azure.

Elaborazione, limiti e prezzi LLM

Per le distribuzioni di NMT e LLM miste, considerare il routing, i limiti e i costi del modello come parte della progettazione del runtime. Il throughput e il dimensionamento del payload differiscono tra i flussi NMT e LLM, quindi stabilisci valori di riferimento per la latenza e i costi prima di aumentare il traffico.

Limiti del servizio

Operation Numero massimo di elementi di matrice Dimensione massima dell'elemento della matrice Numero massimo di elementi di matrice LLM Dimensioni massime LLM dell'elemento della matrice
Traduci 1,000 50,000 50 5,000

Per quote e limiti più ampi, vedere Limiti del servizio - Traduttore.

Pricing

Se si supportano più fasce di traffico, definire regole di instradamento che riservino l'uso degli LLM agli scenari che richiedono un comportamento adattivo, il controllo del tono o una gestione del contesto più ricca, e mantenere su NMT il traffico di base ad alto volume, dove opportuno.

Risoluzione dei problemi

Se una richiesta ha esito negativo, iniziare con lo stato HTTP e il codice di errore del servizio.

Nei sistemi di produzione, il modo più rapido per isolare i problemi consiste nel registrare gli ID richiesta, l'endpoint, l'area, la versione dell'API e le intestazioni di chiave con ogni chiamata non riuscita. Questo contesto consente di distinguere gli errori di autenticazione, quota, payload e disponibilità delle funzionalità.

Sintomo Probabile causa Risoluzione
401 Unauthorized Chiave di sottoscrizione mancante o non valida. Verificare Ocp-Apim-Subscription-Key e l'associazione delle risorse.
403 Forbidden Credenziali valide ma operazioni o configurazione non supportate. Verificare l'area, il tipo di risorsa e la disponibilità delle funzionalità.
429 Too Many Requests Limite di frequenza o quota superati. Ridurre la frequenza delle richieste ed esaminare i limiti del servizio.
400 Bad Request Payload non valido o valore di lingua non supportato. Convalidare il linguaggio JSON della richiesta e i linguaggi supportati.

Per i codici dettagliati, vedere Codici di risposta e messaggi.

Get started

Usare questa sequenza per passare dal provisioning al primo flusso di lavoro di traduzione convalidato. Mantenere i payload di test di piccole dimensioni all'inizio, quindi ridimensionare le dimensioni e la concorrenza delle richieste dopo aver convalidato l'autenticazione, il routing degli endpoint e la gestione delle risposte.

  1. Crea una risorsa Translator.
  2. Ottenere le chiavi di accesso e l'URL dell'endpoint.
  3. Esegui la guida introduttiva alla traduzione di testo nella lingua che preferisci:

Contenuto correlato

  • Last updated on