You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/ai-services/translator/document-translation/reference/rest-api-guide.md
+10-8Lines changed: 10 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,22 +15,21 @@ ms.author: lajanuar
15
15
16
16
Reference</br>
17
17
Feature: **Azure AI Translator → Document Translation**</br>
18
-
API Version: **2024-05-01**</br>
19
18
20
19
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](../../language-support.md) while preserving document structure and data format. The available methods are listed in the following tables:
21
20
22
-
## Current (preview)
21
+
## API Version: **2024-05-01**
23
22
24
23
> [!NOTE]
25
24
>
26
-
> * The current version is backward compatible with the stable version. You can use either version's operations to translate documents.
25
+
> * The current version is backward compatible with the legacy version.
27
26
>
28
27
> * Starting with this current version, the `get supported storage sources` method is longer supported. The Translator service only supports Azure Blob storage.
|[**Translate document**](translate-document.md)|POST|Synchronously translate a single document.|`{document-translation-endpoint}/translator/document:translate?targetLanguage&api-version={date}`|
32
+
|[**Translate document**](translate-document.md)|POST|Synchronously translate a single document.|`{document-translation-endpoint}/translator/document:translate?targetLanguage={target_language}&api-version={date}`|
|[**Start translation**](start-translation.md)|POST| Start a batch document translation job.|`{document-translation-endpoint}/translator/document/batches?api-version={date}`|
@@ -42,7 +41,13 @@ Document Translation is a cloud-based feature of the Azure AI Translator service
42
41
|[**Get supported document formats**](get-supported-document-formats.md)|GET| Request a list of supported document formats.|`{document-translation-endpoint}/translator/document/formats?api-version={date}&type=document`|
43
42
|[**Get supported glossary formats**](get-supported-glossary-formats.md)|GET|Request a list of supported glossary formats.|`{document-translation-endpoint}/translator/document/formats?api-version={date}&type=glossary`|
44
43
45
-
## Stable
44
+
## Legacy
45
+
46
+
> [!NOTE]
47
+
>
48
+
> * The legacy version is backward compatible with the current version. You can use either version's operations to translate documents.
49
+
> * We recommend migrating your applications to the newest version to benefit from an enhanced experience and advanced capabilities.
50
+
>
46
51
47
52
| Request|Method| Description|API path|
48
53
|---------|:-------|-------|-----|
@@ -60,8 +65,5 @@ Document Translation is a cloud-based feature of the Azure AI Translator service
60
65
|[**Get supported glossary formats**](get-supported-glossary-formats.md)|GET|Request a list of supported glossary formats.|`{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/glossaries/formats`|
61
66
|[**Get supported storage sources**](get-supported-storage-sources.md)|GET|Request a list of supported storage sources/options. Currently, Translator service only supports Azure Blob storage.|`{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/storagesources`|
62
67
63
-
64
-
65
-
66
68
> [!div class="nextstepaction"]
67
69
> [Explore our client libraries and SDKs for C# and Python programming languages.](../quickstarts/client-library-sdks.md).
0 commit comments