Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Azure Translator in Foundry Tools text translation 2025-10-01-preview is our latest cloud-based, multilingual neural machine translation service. As Translator matures, we're focused on patterns and practices to best support and add value to our users.
Important
- Translator REST API
2025-10-01-previewis new version of the Translator REST API with breaking changes. - It's essential to thoroughly test your code against the new release before migrating any production applications from Translator v3.0.
- Make sure to review your code and internal workflows for adherence to best practices and restrict your production code to versions that you fully test.
The latest version of Azure Translator includes the following enhancements and capabilities:
Large language model (LLM) choice. You can choose a large language model based for translation based on quality, cost, and other factors, while avoiding costs associated with prompt engineering and quality evaluations.
Adaptive custom translation. New features enable adaptive custom translations using datasets or reference pairs to ensure more accurate and contextually relevant translations.
Expanded parameters for translation requests. The API supports a range of parameters, including text type, language codes, and options for tone and gender, providing more nuanced translation outputs.
Method changes
The following list compares available Translator 2025-10-01-preview methods with available v3.0 method.
Required parameters
| API version: 2025-10-01-preview | API version: v3 |
|---|---|
| api-version • Value must be 2025-10-01-preview |
api-version • Value must be 3.0 |
| text • Specifies source text for translation. |
text • Specifies source text for translation |
| targets • Array containing user-specified values for the translated text |
• The targets array isn't included with the Translator v3.0 schema. |
| language • The language code for the translated (target) text specified in the targets array. • Values are supported language codes for the translation operation. |
to • Specifies the language of the output text. • The target language must be one of the supported languages included in the translation scope. |
For more information on targets array values, see Translate text.
API compatibility
The following table provides a detailed comparison of the updates introduced in API version 2025-10-01-preview.
| API version: v3 | API version: 2025-10-01-preview |
|---|---|
| Translate text | Translate text |
| Transliterate | Transliterate |
| Languages | Languages |
| BreakSentence | Feature no longer supported. Use a sentence delimiter function or a Natural Language Processing (NLP) library that's compatible with your programming language. |
| Detect | Feature no longer supported. Use the Azure Language in Foundry Tools detection API. |
| Dictionary Lookup | Feature no longer supported. |
| Dictionary Examples | Feature no longer supported. |