Skip to content

Commit 650f8a6

Browse files
committed
update version names
1 parent 00839eb commit 650f8a6

File tree

1 file changed

+10
-8
lines changed

1 file changed

+10
-8
lines changed

articles/ai-services/translator/document-translation/reference/rest-api-guide.md

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -15,22 +15,21 @@ ms.author: lajanuar
1515

1616
Reference</br>
1717
Feature: **Azure AI Translator → Document Translation**</br>
18-
API Version: **2024-05-01**</br>
1918

2019
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:
2120

22-
## Current (preview)
21+
## API Version: **2024-05-01**
2322

2423
> [!NOTE]
2524
>
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.
2726
>
2827
> * Starting with this current version, the `get supported storage sources` method is longer supported. The Translator service only supports Azure Blob storage.
2928
3029
| Request|Method| Description|API path|
3130
|---------|:-------:|-------|-----|
3231
|***Single*** |***Synchronous***|***Document***|***Translation***|
33-
|[**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}`|
3433
|||||
3534
|***Batch***|***Asynchronous***|***Documents***| ***Translation***|
3635
|[**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
4241
|[**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`|
4342
|[**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`|
4443

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+
>
4651
4752
| Request|Method| Description|API path|
4853
|---------|:-------|-------|-----|
@@ -60,8 +65,5 @@ Document Translation is a cloud-based feature of the Azure AI Translator service
6065
|[**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`|
6166
|[**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`|
6267

63-
64-
65-
6668
> [!div class="nextstepaction"]
6769
> [Explore our client libraries and SDKs for C# and Python programming languages.](../quickstarts/client-library-sdks.md).

0 commit comments

Comments
 (0)