Document Translation operations
Reference
Feature: Azure AI Translator → Document Translation
API Version: 2024-05-01
Document Translation is a cloud-based feature of the Azure AI Translator service and is part of the Azure AI service family of REST APIs. The Batch Document Translation API translates documents across all supported languages and dialects while preserving document structure and data format. The available methods are listed in the following table:
| Request | Method | Description | API path |
|---|---|---|---|
| Single document translation operation | |||
| Translate document | POST | Synchronously translate a single document. | {document-translation-endpoint}/translator/document:translate?api-version={date} |
| Batch Translation operations | |||
| Start translation | POST | Start a batch document translation job. | {document-translation-endpoint}/translator/document/batches?api-version={date} |
| Get status for all translation jobs | GET | Request a list and the status of translation jobs submitted by the user. | {document-translation-endpoint}/translator/document/batches?api-version={date} |
| Get status for a specific translation job | GET | Request a summary of the status for a specific translation job. The response includes the overall job status and the status for documents that are being translated as part of that job. | {document-translation-endpoint}/translator/document/batches/{id}?api-version={date} |
| Get status for all documents | GET | Request the status of all documents in a translation job. | {document-translation-endpoint}/translator/document/batches/{id}/documents?api-version={date} |
| Get status for a specific document | GET | Request the status for a specific document in a job. | {document-translation-endpoint}/translator/document/batches/{id}/documents/{documentId}?api-version={date} |
| Cancel translation | DELETE | Cancel a document translation job that is currently processing or queued. | {document-translation-endpoint}/translator/document/batches/{id}?api-version={date} |
| Get supported document formats | GET | Request a list of supported document formats. | {document-translation-endpoint}/translator/document/formats?api-version={date}&type=document |
| Get supported glossary formats | GET | Request a list of supported glossary formats. | {document-translation-endpoint}/translator/document/formats?api-version={date}&type=glossary |
Note
The get supported storage sources method is no longer supported. The Translator service only supports Azure Blob storage.
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for