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/custom-translator/azure-ai-foundry/beginners-guide.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,9 +12,9 @@ ms.topic: overview
12
12
13
13
# Azure AI Translator custom translation for beginners
14
14
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.
16
16
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.
18
18
19
19
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).
Copy file name to clipboardExpand all lines: articles/ai-services/translator/custom-translator/azure-ai-foundry/concepts/workspace-and-project.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,7 +22,7 @@ A project is private to you and the people you invite into your project. Uninvit
22
22
23
23
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
24
24
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.
Copy file name to clipboardExpand all lines: articles/ai-services/translator/custom-translator/azure-ai-foundry/faq.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -35,7 +35,7 @@ The deployment generally takes less than an hour.
35
35
36
36
## How do you access a deployed system?
37
37
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.
39
39
40
40
## How do I skip alignment and sentence breaking if my data is already sentence aligned?
Copy file name to clipboardExpand all lines: articles/ai-services/translator/custom-translator/azure-ai-foundry/how-to/translate-with-model.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -16,7 +16,7 @@ After you deploy your custom translation model, you can access it with the Azure
16
16
17
17
## How to translate
18
18
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).
20
20
21
21
1. To find the model **Category ID**, select **Train model** from the left menu then select the model name.
22
22
@@ -33,7 +33,7 @@ After you deploy your custom translation model, you can access it with the Azure
33
33
34
34
```
35
35
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.
37
37
38
38
1. You can also use **Azure AI Foundry** > **AI Services** > **Language + Translator** > **Translation** > **Text translation**
Copy file name to clipboardExpand all lines: articles/ai-services/translator/custom-translator/azure-ai-foundry/overview.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -63,7 +63,7 @@ The steps for creating a custom model are as follows:
63
63
64
64
1.[**Deploy a model**](how-to/deploy-model.md). Your custom model is made available for runtime translation requests in the regions you select.
65
65
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.
Copy file name to clipboardExpand all lines: articles/ai-services/translator/text-translation/how-to/migrate-to-v3.md
+21-21Lines changed: 21 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,27 +1,27 @@
1
1
---
2
-
title: Migrate to v3 - Azure AI Translator
2
+
title: Migrate to V3 - Azure AI Translator
3
3
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.
5
5
author: laujan
6
6
manager: nitinme
7
7
ms.service: azure-ai-translator
8
8
ms.topic: conceptual
9
-
ms.date: 04/15/2025
9
+
ms.date: 05/19/2025
10
10
ms.author: lajanuar
11
11
---
12
12
13
-
# Azure AI Translator v3 migration
13
+
# Azure AI Translator V3 Migration
14
14
15
15
> [!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.
17
17
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.
19
19
20
20
The end of this document contains helpful links for you to learn more.
21
21
22
22
## Summary of features
23
23
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.
25
25
* JSON - XML replaces JSON. All data sent to the service and received from the service is in JSON format.
26
26
* 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.
27
27
* 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.
30
30
* 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.
31
31
* 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).
32
32
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.
@@ -50,23 +50,23 @@ The following list of V2 and v3 methods identifies the v3 methods and APIs that
50
50
51
51
## Move to JSON format
52
52
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.
54
54
55
55
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.
56
56
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:
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.
64
64
65
65
## Pricing Model
66
66
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.
68
68
69
-
|v3 Method | Characters Counted for Billing |
69
+
|V3 Method | Characters Counted for Billing |
70
70
|:----------- |:-------------|
71
71
|`Languages`| No characters submitted, none counted, no charge. |
72
72
|`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,
75
75
|`BreakSentence`| No Charge. |
76
76
|`Detect`| No Charge. |
77
77
78
-
## v3 End Points
78
+
## V3 End Points
79
79
80
80
Global
81
81
82
82
* api.cognitive.microsofttranslator.com
83
83
84
-
## v3 API text translations methods
84
+
## V3 API text translations methods
85
85
86
86
[`Languages`](../reference/v3/languages.md)
87
87
@@ -103,11 +103,11 @@ Global
103
103
>
104
104
> The Microsoft Translator Hub will be retired on May 17, 2019. [View important migration information and dates](https://www.microsoft.com/translator/business/hub/).
105
105
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)
107
107
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`).
109
109
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) |
|Translator Version 2| api.microsofttranslator.com| No |Yes |No|
113
113
|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
116
116
117
117
* It's generally available and fully supported.
118
118
* 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.
120
120
* It doesn't provide access to custom translation systems created using the Microsoft Translator Hub.
121
121
122
122
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
139
139
## Next steps
140
140
141
141
> [!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)
0 commit comments