Operazioni di traduzione di documenti

  • Articolo

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.