Skip to content

Commit 795f514

Browse files
authored
Merge pull request #5037 from laujan/remove-v4-references-from-custom-branch
remove v4 references
2 parents 564d711 + d232f1a commit 795f514

37 files changed

+232
-1213
lines changed

articles/ai-services/translator/custom-translator/azure-ai-foundry/beginners-guide.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,9 +12,9 @@ ms.topic: overview
1212

1313
# Azure AI Translator custom translation for beginners
1414

15-
[Custom translation](overview.md) enables you to a build translation system that reflects your business, industry, and domain-specific terminology and style. Training and deploying a custom system is easy and doesn't require any programming skills. The customized translation system seamlessly integrates into your existing applications, workflows, and websites and is available on Azure through the same cloud-based [Microsoft Text Translation API](../../text-translation/reference/v4/translate-api.md) service that powers billions of translations every day.
15+
[Custom translation](overview.md) enables you to a build translation system that reflects your business, industry, and domain-specific terminology and style. Training and deploying a custom system is easy and doesn't require any programming skills. The customized translation system seamlessly integrates into your existing applications, workflows, and websites and is available on Azure through the same cloud-based [Microsoft Text Translation API](../../text-translation/reference/v3/translate.md) service that powers billions of translations every day.
1616

17-
[Custom translation](overview.md) empowers you to build a translation system that truly captures your business's unique language, industry terminology, and domain-specific style. With an intuitive interface, training, testing, and deploying your custom model is simple and requires no programming expertise. Seamlessly integrate your tailored translation system into your existing applications, workflows, and websites—all backed by the cloud-based [Azure AI Translator Text Translation API](../../text-translation/reference/v4/translate-api.md?tabs=curl) service that powers billions of translations each day.
17+
[Custom translation](overview.md) empowers you to build a translation system that truly captures your business's unique language, industry terminology, and domain-specific style. With an intuitive interface, training, testing, and deploying your custom model is simple and requires no programming expertise. Seamlessly integrate your tailored translation system into your existing applications, workflows, and websites—all backed by the cloud-based [Azure AI Translator Text Translation API](../../text-translation/reference/v3/translate.md?tabs=curl) service that powers billions of translations each day.
1818

1919
The platform enables users to build and publish custom translation systems to and from English. The Custom Translator supports more than 100 languages that map directly to the languages available for Neural machine translation (NMT). For a complete list, *see* [Translator language support](../../../language-support.md).
2020

articles/ai-services/translator/custom-translator/azure-ai-foundry/concepts/workspace-and-project.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ A project is private to you and the people you invite into your project. Uninvit
2222

2323
A language pair is a wrapper for a model, documents, and tests. Each language pair automatically includes all documents that are uploaded into that project that
2424
have the correct language pair. For example, if you have both an English-to-Spanish language pair and a Spanish-to-English language pair, the same documents are
25-
included in both language pairs. Each project has a Category ID associated with it that is used when querying the [V3 API](../../../text-translation/reference/v4/translate-api.md) for translations. Category ID is parameter used to get translations from a customized system built with custom translation.
25+
included in both language pairs. Each project has a Category ID associated with it that is used when querying the [V3 API](../../../text-translation/reference/v3/translate.md) for translations. Category ID is parameter used to get translations from a customized system built with custom translation.
2626

2727
## Language pair categories
2828

articles/ai-services/translator/custom-translator/azure-ai-foundry/faq.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ The deployment generally takes less than an hour.
3535

3636
## How do you access a deployed system?
3737

38-
Deployed systems can be accessed via the Azure AI Translator Text API V3 by specifying the Category ID. More information about the Translator Text API can be found in the [API Reference](../../text-translation/reference/v4/translate-api.md) webpage.
38+
Deployed systems can be accessed via the Azure AI Translator Text API V3 by specifying the Category ID. More information about the Translator Text API can be found in the [API Reference](../../text-translation/reference/v3/translate.md) webpage.
3939

4040
## How do I skip alignment and sentence breaking if my data is already sentence aligned?
4141

articles/ai-services/translator/custom-translator/azure-ai-foundry/how-to/translate-with-model.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ After you deploy your custom translation model, you can access it with the Azure
1616

1717
## How to translate
1818

19-
1. Use the **Category ID** when making a custom translation request via Microsoft Translator [Text API V3](../../../text-translation/reference/v4/translate-api.md?tabs=curl).
19+
1. Use the **Category ID** when making a custom translation request via Microsoft Translator [Text API V3](../../../text-translation/reference/v3/translate.md?tabs=curl).
2020

2121
1. To find the model **Category ID**, select **Train model** from the left menu then select the model name.
2222

@@ -33,7 +33,7 @@ After you deploy your custom translation model, you can access it with the Azure
3333
3434
```
3535

36-
More information about the Translator Text API can be found on the [Translator API Reference](../../../text-translation/reference/v4/translate-api.md) page.
36+
More information about the Translator Text API can be found on the [Translator API Reference](../../../text-translation/reference/v3/translate.md) page.
3737

3838
1. You can also use **Azure AI Foundry** > **AI Services** > **Language + Translator** > **Translation** > **Text translation**
3939

articles/ai-services/translator/custom-translator/azure-ai-foundry/overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@ The steps for creating a custom model are as follows:
6363

6464
1. [**Deploy a model**](how-to/deploy-model.md). Your custom model is made available for runtime translation requests in the regions you select.
6565

66-
1. [**Translate text**](../../text-translation/reference/v4/translate-api.md). Use the cloud-based, secure, high performance, highly scalable Azure AI Translator [Text API](../../text-translation/reference/v4/translate-api.md) to make translation requests.
66+
1. [**Translate text**](../../text-translation/reference/v3/translate.md). Use the cloud-based, secure, high performance, highly scalable Azure AI Translator [Text API](../../text-translation/reference/v3/translate.md) to make translation requests.
6767

6868
## Next steps
6969

articles/ai-services/translator/text-translation/how-to/migrate-to-v3.md

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,27 @@
11
---
2-
title: Migrate to v3 - Azure AI Translator
2+
title: Migrate to V3 - Azure AI Translator
33
titleSuffix: Azure AI services
4-
description: This article provides the steps to help you migrate from V2 to v3 of the Azure AI Translator.
4+
description: This article provides the steps to help you migrate from V2 to V3 of the Azure AI Translator.
55
author: laujan
66
manager: nitinme
77
ms.service: azure-ai-translator
88
ms.topic: conceptual
9-
ms.date: 04/15/2025
9+
ms.date: 05/19/2025
1010
ms.author: lajanuar
1111
---
1212

13-
# Azure AI Translator v3 migration
13+
# Azure AI Translator V3 Migration
1414

1515
> [!NOTE]
16-
> Microsoft Translator V2 was deprecated on April 30, 2018. Migrate your applications to v3 and experience new functionality available exclusively in v3. Translator v2 was retired on May 24, 2021.
16+
> Microsoft Translator V2 was deprecated on April 30, 2018. Migrate your applications to V3 and experience new functionality available exclusively in V3. V2 was retired on May 24, 2021.
1717
18-
Azure AI Translator Version 3 (v3) is generally available. The release includes new features, deprecated methods and a new format for sending to, and receiving data from the Microsoft Translator Service. This document provides information for changing applications to use v3.
18+
Azure AI Translator Version 3 (V3) is generally available. The release includes new features, deprecated methods and a new format for sending to, and receiving data from the Microsoft Translator Service. This document provides information for changing applications to use V3.
1919

2020
The end of this document contains helpful links for you to learn more.
2121

2222
## Summary of features
2323

24-
* No Trace - In v3 No-Trace applies to all pricing tiers in the Azure portal. This feature means that the service doesn't save text submitted to the v3 API.
24+
* No Trace - In V3 No-Trace applies to all pricing tiers in the Azure portal. This feature means that the service doesn't save text submitted to the V3 API.
2525
* JSON - XML replaces JSON. All data sent to the service and received from the service is in JSON format.
2626
* Multiple target languages in a single request - The Translate method accepts multiple `to` languages for translation in a single request. For example, a single request can be `from` English and `to` German, Spanish and Japanese, or any other group of languages.
2727
* Bilingual dictionary - A bilingual dictionary method is added to the API. This method includes `lookup` and `examples`.
@@ -30,9 +30,9 @@ The end of this document contains helpful links for you to learn more.
3030
* New to Translate - New capabilities are added to the `translate` method to support some of the features that were in the V2 API as separate methods. An example is TranslateArray.
3131
* Speech method - Text to speech functionality is no longer supported in the Microsoft Translator. Text to speech functionality is available in [Microsoft Speech Service](../../../speech-service/text-to-speech.md).
3232

33-
The following list of V2 and v3 methods identifies the v3 methods and APIs that provide the functionality that came with V2.
33+
The following list of V2 and V3 methods identifies the V3 methods and APIs that provide the functionality that came with V2.
3434

35-
| V2 API Method | v3 API Compatibility |
35+
| V2 API Method | V3 API Compatibility |
3636
|:----------- |:-------------|
3737
| `Translate` | [Translate](../reference/v3/translate.md) |
3838
| `TranslateArray` | [Translate](../reference/v3/translate.md) |
@@ -50,23 +50,23 @@ The following list of V2 and v3 methods identifies the v3 methods and APIs that
5050

5151
## Move to JSON format
5252

53-
Microsoft Translator Translation V2 accepted and returned data in XML format. In v3, all data sent and received using the API is in JSON format. XML is no longer accepted or returned in v3.
53+
Microsoft Translator Translation V2 accepted and returned data in XML format. In V3, all data sent and received using the API is in JSON format. XML is no longer accepted or returned in V3.
5454

5555
This change affects several aspects of an application written for the V2 Text translation API. As an example: The Languages API returns language information for text translation, transliteration, and the two dictionary methods. You can request all language information for all methods in one call or request them individually.
5656

57-
The languages method doesn't require authentication; by selecting the following link you can see all the language information for v3 in JSON:
57+
The languages method doesn't require authentication; by selecting the following link you can see all the language information for V3 in JSON:
5858

5959
[https://api.cognitive.microsofttranslator.com/languages?api-version=3.0&scope=translation,dictionary,transliteration](https://api.cognitive.microsofttranslator.com/languages?api-version=3.0&scope=translation,dictionary,transliteration)
6060

6161
## Authentication Key
6262

63-
The authentication key used for V2 is accepted for v3. You don't need to get a new subscription. You can mix V2 and v3 in your apps during the yearlong migration period, making it easier for you to release new versions while you migrate from V2-XML to v3-JSON.
63+
The authentication key used for V2 is accepted for V3. You don't need to get a new subscription. You can mix V2 and V3 in your apps during the yearlong migration period, making it easier for you to release new versions while you migrate from V2-XML to V3-JSON.
6464

6565
## Pricing Model
6666

67-
Microsoft Translator v3 is priced in the same way V2 was priced; per character, including spaces. The new features in v3 make some changes in what characters are counted for billing.
67+
Microsoft Translator V3 is priced in the same way V2 was priced; per character, including spaces. The new features in V3 make some changes in what characters are counted for billing.
6868

69-
| v3 Method | Characters Counted for Billing |
69+
| V3 Method | Characters Counted for Billing |
7070
|:----------- |:-------------|
7171
| `Languages` | No characters submitted, none counted, no charge. |
7272
| `Translate` | Count is based on how many characters are submitted for translation, and how many languages the characters are translated into. 50 characters submitted, and 5 counted as 50x5. |
@@ -75,13 +75,13 @@ Microsoft Translator v3 is priced in the same way V2 was priced; per character,
7575
| `BreakSentence` | No Charge. |
7676
| `Detect` | No Charge. |
7777

78-
## v3 End Points
78+
## V3 End Points
7979

8080
Global
8181

8282
* api.cognitive.microsofttranslator.com
8383

84-
## v3 API text translations methods
84+
## V3 API text translations methods
8585

8686
[`Languages`](../reference/v3/languages.md)
8787

@@ -103,11 +103,11 @@ Global
103103
>
104104
> The Microsoft Translator Hub will be retired on May 17, 2019. [View important migration information and dates](https://www.microsoft.com/translator/business/hub/).
105105
106-
Azure AI Translator v3 uses neural machine translation by default. As such, it can't be used with the Microsoft Translator Hub. The Translator Hub only supports legacy statistical machine translation. Customization for neural translation is now available using the Azure AI Custom Translator. [Learn more about customizing neural machine translation](../../custom-translator/overview.md)
106+
Azure AI Translator V3 uses neural machine translation by default. As such, it can't be used with the Microsoft Translator Hub. The Translator Hub only supports legacy statistical machine translation. Customization for neural translation is now available using the Azure AI Custom Translator. [Learn more about customizing neural machine translation](../../custom-translator/overview.md)
107107

108-
Neural translation with the v3 text API doesn't support the use of standard categories (`SMT`, `speech`, `tech`, `generalnn`).
108+
Neural translation with the V3 text API doesn't support the use of standard categories (`SMT`, `speech`, `tech`, `generalnn`).
109109

110-
| Version | Endpoint | GDPR Processor Compliance | Use Translator Hub | Use Custom Translator (preview) |
110+
| Version | Endpoint | GDPR Processor Compliance | Use Translator Hub | Use Custom Translator (Preview) |
111111
| :------ | :------- | :------------------------ | :----------------- | :------------------------------ |
112112
|Translator Version 2| api.microsofttranslator.com| No |Yes |No|
113113
|Translator Version 3| api.cognitive.microsofttranslator.com| Yes| No| Yes|
@@ -116,7 +116,7 @@ Neural translation with the v3 text API doesn't support the use of standard cate
116116

117117
* It's generally available and fully supported.
118118
* It's GDPR-compliant as a processor and satisfies all ISO 20001 and 20018 as well as SOC 3 certification requirements.
119-
* It allows you to invoke the neural network translation systems you customized with Custom Translator (preview), the new Translator neural machine translation (NMT) customization feature.
119+
* It allows you to invoke the neural network translation systems you customized with Custom Translator (Preview), the new Translator neural machine translation (NMT) customization feature.
120120
* It doesn't provide access to custom translation systems created using the Microsoft Translator Hub.
121121

122122
You're using Version 3 of the Translator if you're using the api.cognitive.microsofttranslator.com endpoint.
@@ -139,4 +139,4 @@ No version of the Azure AI Translator creates a record of your translations. You
139139
## Next steps
140140

141141
> [!div class="nextstepaction"]
142-
> [View Azure AI Translator v3.0 Documentation](../reference/v3/reference.md)
142+
> [View Azure AI Translator V3.0 Documentation](../reference/v3/reference.md)

articles/ai-services/translator/text-translation/how-to/migrate-to-v4.md

Lines changed: 0 additions & 63 deletions
This file was deleted.

articles/ai-services/translator/text-translation/how-to/prevent-translation.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: laujan
66
manager: nitinme
77
ms.service: azure-ai-translator
88
ms.topic: how-to
9-
ms.date: 01/28/2025
9+
ms.date: 05/19/2025
1010
ms.author: lajanuar
1111
---
1212

articles/ai-services/translator/text-translation/how-to/use-dynamic-dictionary.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: laujan
66
manager: nitinme
77
ms.service: azure-ai-translator
88
ms.topic: how-to
9-
ms.date: 02/11/2025
9+
ms.date: 05/19/2025
1010
ms.author: lajanuar
1111
---
1212

0 commit comments

Comments
 (0)