Operazioni di traduzione di documenti

Funzionalità di riferimento
: Traduzione → documenti di Azure AI Translator

La traduzione dei documenti è una funzionalità basata sul cloud del servizio Azure AI Translator ed è parte della famiglia di API REST del servizio azure per intelligenza artificiale. L'API Traduzione documenti batch converte i documenti in tutte le lingue e i dialetti supportati mantenendo al tempo stesso la struttura dei documenti e il formato dei dati. I metodi disponibili sono elencati nelle tabelle seguenti:

Versione API: 2024-05-01

Nota

• La versione corrente è compatibile con la versione precedente.

• A partire da questa versione corrente, il get supported storage sources metodo non è più supportato. Il servizio Translator supporta solo l'archiviazione BLOB di Azure.

Richiedi	metodo	Descrizione	Percorso API
Singolo	Sincrona	Documento	Traduzione
Tradurre il documento	POST	Tradurre in modo sincrono un singolo documento.	{document-translation-endpoint}/translator/document:translate?targetLanguage={target_language}&api-version={date}
Batch	Asincrona	Documenti	Traduzione
Avviare la traduzione	POST	Avviare un processo di traduzione di documenti batch.	{document-translation-endpoint}/translator/document/batches?api-version={date}
Ottenere lo stato per tutti i processi di traduzione	GET	Richiedere un elenco e lo stato dei processi di traduzione inviati dall'utente.	{document-translation-endpoint}/translator/document/batches?api-version={date}
Ottenere lo stato per un processo di traduzione specifico	GET	Richiedere un riepilogo dello stato per un processo di traduzione specifico. La risposta include lo stato complessivo del processo e lo stato dei documenti che vengono tradotti come parte di tale processo.	{document-translation-endpoint}/translator/document/batches/{id}?api-version={date}
Ottenere lo stato per tutti i documenti	GET	Richiedere lo stato di tutti i documenti in un processo di traduzione.	{document-translation-endpoint}/translator/document/batches/{id}/documents?api-version={date}
Ottenere lo stato per un documento specifico	GET	Richiedere lo stato di un documento specifico in un processo.	{document-translation-endpoint}/translator/document/batches/{id}/documents/{documentId}?api-version={date}
Annullare la traduzione	DELETE	Annullare un processo di traduzione di documenti in fase di elaborazione o accodamento.	{document-translation-endpoint}/translator/document/batches/{id}?api-version={date}
Ottenere i formati di documento supportati	GET	Richiedere un elenco di formati di documento supportati.	{document-translation-endpoint}/translator/document/formats?api-version={date}&type=document
Ottenere i formati di glossario supportati	GET	Richiedere un elenco di formati di glossario supportati.	{document-translation-endpoint}/translator/document/formats?api-version={date}&type=glossary

Legacy

Nota

• La versione legacy è compatibile con la versione corrente. È possibile usare le operazioni di entrambe le versioni per tradurre i documenti.
• È consigliabile eseguire la migrazione delle applicazioni alla versione più recente per trarre vantaggio da un'esperienza avanzata e funzionalità avanzate.

Richiedi	metodo	Descrizione	Percorso API
Singolo	Sincrona	Documento	Traduzione
Tradurre il documento	POST	Tradurre in modo sincrono un singolo documento.	{document-translation-endpoint}/translator/document:translate?sourceLanguage={source language}&targetLanguage={target language}&api-version=2024-05-01" -H "Ocp-Apim-Subscription-Key:{your-key}" -F "document={path-to-your-document-with-file-extension};type={ContentType}/{file-extension}" -F "glossary={path-to-your-glossary-with-file-extension};type={ContentType}/{file-extension}" -o "{path-to-output-file}"
Batch	Asincrona	Documenti	Traduzione
Avviare la traduzione	POST	Avviare un processo di traduzione di documenti batch.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches
Ottenere lo stato per tutti i processi di traduzione	GET	Richiedere un elenco e lo stato dei processi di traduzione inviati dall'utente.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches
Ottenere lo stato per un processo di traduzione specifico	GET	Richiedere un riepilogo dello stato per un processo di traduzione specifico. La risposta include lo stato complessivo del processo e lo stato dei documenti che vengono tradotti come parte di tale processo.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}
Ottenere lo stato per tutti i documenti	GET	Richiedere lo stato di un documento specifico in un processo.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents
Ottenere lo stato per un documento specifico	GET	Richiedere lo stato di un documento specifico in un processo.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents/{documentId}
Annullare la traduzione	DELETE	Annullare un processo di traduzione di documenti in fase di elaborazione o accodamento.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}
Ottenere i formati di documento supportati	GET	Richiedere un elenco di formati di documento supportati.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/documents/formats
Ottenere i formati di glossario supportati	GET	Richiedere un elenco di formati di glossario supportati.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/glossaries/formats
Ottenere origini di archiviazione supportate	GET	Richiedere un elenco di origini/opzioni di archiviazione supportate. Attualmente, il servizio Translator supporta solo l'archiviazione BLOB di Azure.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/storagesources

Esplorare le librerie client e gli SDK per linguaggi di programmazione C# e Python.