Guida all'API REST traduzione documenti (2026-03-01)

L'API REST traduzione documenti (versione 2026-03-01) supporta due modelli di traduzione e un set di operazioni di individuazione. La traduzione sincrona elabora un singolo documento senza gestione rete virtuale di Azure e restituisce direttamente il file tradotto. La traduzione batch asincrona elabora uno o più documenti archiviati in Archiviazione BLOB di Azure e consente di eseguire il polling dello stato. Entrambi i modelli usano la traduzione automatica neurale (NMT) per impostazione predefinita.

Tutte le richieste richiedono un endpoint di dominio personalizzato. Il formato è https://{your-resource-name}.cognitiveservices.azure.com/.

Note

Per le applicazioni esistenti che usano LE API precedenti, vedere la guida all'API REST traduzione documenti legacy.

Operazioni sincrone

Operation metodo Description Reference
Tradurre un documento POST Tradurre un singolo documento e ricevere l'output tradotto nella risposta. Nessun gestione rete virtuale di Azure obbligatorio. Traduzione sincrona dei documenti

Operazioni batch asincrone

Operation metodo Description Reference
Avviare la conversione batch POST Inviare uno o più documenti per la traduzione asincrona. I documenti devono trovarsi in Archiviazione BLOB di Azure. Restituisce un ID processo. Avviare la conversione batch
Ottenere lo stato della traduzione GET Recuperare lo stato complessivo e il riepilogo del documento per un processo batch specifico. Eseguire il polling fino a quando il processo non raggiunge lo stato del terminale. Ottenere lo stato della traduzione
Ottenere lo stato per tutte le traduzioni GET Elencare tutti i processi di traduzione batch inviati alla risorsa. Supporta il filtro e il paging. Ottenere lo stato per tutti i processi di traduzione
Ottenere lo stato per tutti i documenti GET Recuperare lo stato per documento per tutti i documenti in un processo specifico. Ottenere lo stato per tutti i documenti
Ottenere lo stato di un documento specifico GET Recuperare i dettagli di stato e output per un singolo documento all'interno di un processo. Ottenere lo stato per un documento specifico
Annullare la traduzione DELETE Annullare un processo in coda o in corso. Annullare la traduzione

Operazioni di individuazione

Operation metodo Description Reference
Ottenere i formati di documento supportati GET Recuperare un elenco di formati di documento supportati e i relativi tipi MIME. Ottenere i formati di documento supportati
Ottenere i formati di glossario supportati GET Recuperare un elenco di formati di glossario supportati e i relativi tipi MIME. Ottenere i formati di glossario supportati