Azure Text Translation SDK (preview)
- The Translator text SDKs are currently available in public preview. Features, approaches and processes may change, prior to General Availability (GA), based on user feedback.
Text Translation SDK supports the programming languages and platforms:
|Language → SDK version||Package||Client library||Supported API version|
|.NET/C# → 1.0.0-beta.1||NuGet||Azure SDK for .NET||Translator v3.0|
|Java✱ → 1.0.0-beta.1||MVN repository||Azure SDK for Java||Translator v3.0|
|Python → 1.0.0b1||PyPi||Azure SDK for Python||Translator v3.0|
✱ The Azure Text Translation SDK for Java is tested and supported on Windows, Linux, and macOS platforms. It isn't tested on other platforms and doesn't support Android deployments.
Changelog and release history
This section provides a version-based description of Text Translation feature and capability releases, changes, updates, and enhancements.
Translator Text SDK April 2023 preview release
This release includes the following updates:
- Version 1.0.0-beta.1 (2023-04-17)
- Targets Text Translation v3.0
- Initial version release
Use Text Translation SDK in your applications
The Text Translation SDK enables the use and management of the Text Translation service in your application. The SDK builds on the underlying Text Translation REST API allowing you to easily use those APIs within your programming language paradigm. Here's how you use the Text Translation SDK for your preferred programming language:
1. Install the SDK client library
dotnet add package Azure.AI.Translation.Text --version 1.0.0-beta.1
Install-Package Azure.AI.Translation.Text -Version 1.0.0-beta.1
2. Import the SDK client library into your application
3. Authenticate the client
Interaction with the Translator service using the client library begins with creating an instance of the
TextTranslationClientclass. You need your API key and region to instantiate a client object.
The Text Translation API key is found in the Azure portal:
Using the global endpoint (default)
string key = "<your-key>"; AzureKeyCredential credential = new(key); TextTranslationClient client = new(credential);
Using a regional endpoint
Uri endpoint = new("<your-endpoint>"); string key = "<your-key>"; string region = "<region>"; AzureKeyCredential credential = new(key); TextTranslationClient client = new(credential, region);
4. Build your application
Create a client object to interact with the Text Translation SDK, and then call methods on that client object to interact with the service. The SDKs provide both synchronous and asynchronous methods. For more insight, see the Text Translation sample repository for .NET/C#.
The Microsoft Q&A and Stack Overflow forums are available for the developer community to ask and answer questions about Azure Text Translation and other services. Microsoft monitors the forums and replies to questions that the community has yet to answer. To make sure that we see your question, tag it with