Guida all'API REST per la traduzione dei documenti (2024-05-01)

L'API REST traduzione documenti legacy (versione 2024-05-01) supporta la traduzione sincrona a documento singolo, la traduzione batch asincrona e le 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.

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

Nota

Per le nuove applicazioni, usare l'API REST traduzione documenti versione 2026-03-01.

Operazioni sincrone

Operation metodo Descrizione 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 Descrizione 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 Descrizione 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

API batch v1.1 precedente

L'API v1.1 precedente supporta operazioni di individuazione e batch asincrone nel /translator/text/batch/v1.1 percorso. L'operazione Get supported storage sources è disponibile solo nella versione 1.1. Translator supporta Archiviazione BLOB di Azure come origine di archiviazione.

È consigliabile eseguire la migrazione delle applicazioni esistenti alla versione più recente dell'API per usare le funzionalità correnti.

Operation metodo Percorso API
Avviare la conversione batch POST /translator/text/batch/v1.1/batches
Ottenere lo stato per tutti i processi di traduzione GET /translator/text/batch/v1.1/batches
Ottieni lo stato di un processo di traduzione specifico GET /translator/text/batch/v1.1/batches/{id}
Ottenere lo stato per tutti i documenti GET /translator/text/batch/v1.1/batches/{id}/documents
Ottenere lo stato di un documento specifico GET /translator/text/batch/v1.1/batches/{id}/documents/{documentId}
Annullare la traduzione DELETE /translator/text/batch/v1.1/batches/{id}
Ottenere i formati di documento supportati GET /translator/text/batch/v1.1/documents/formats
Ottenere i formati di glossario supportati GET /translator/text/batch/v1.1/glossaries/formats
Ottenere origini di archiviazione supportate GET /translator/text/batch/v1.1/storagesources

Contenuti correlati

  • Last updated on