---
id: azure-ai-translation-text
version: "2.0.0"
license: unclear
license_treatment: unclear
maintenance: active
---

# azure-ai-translation-text — Microsoft Corporation Azure Ai Translation Text Client Library for Python

License: unclear · Maintenance: active · Downloads: 335.7K/mo

## What it is and what it does

This package is a Python client library for Microsoft Azure's Translator service, a cloud-based neural machine translation API. It wraps the REST endpoints to provide synchronous and asynchronous methods for translating text, detecting source languages, and transliterating text between scripts. The library depends on azure-core for credential handling and HTTP communication, isodate for date parsing, and typing-extensions for type hints.

Developers use it to integrate real-time translation into applications without building HTTP clients manually. The main entry point is TextTranslationClient, which requires an API key or token credential and an Azure region. The library supports querying supported languages and models, translating single or batch text items with configurable parameters, and converting text between writing systems—useful for applications serving multilingual users or handling non-Latin scripts.

Use it for:

- Integrate real-time text translation into a web or mobile application to serve users in multiple languages.
- Detect the source language of user input and automatically translate it to a target language in a chatbot or support system.
- Convert text from one script to another (e.g., Chinese Hanzi to Latin characters) for display or processing.
- Build a multilingual content pipeline that translates user-generated text or documents on demand.
- Query available translation languages and models to dynamically populate UI dropdowns or validate user requests.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides a Python client for Azure's neural machine translation service, enabling text translation, transliteration, and language detection across supported languages.

Yes. The package is production-stable, actively maintained, has no known vulnerabilities, and low install friction. Install it if you need to call Azure's Translator service from Python. You must have an Azure Translator resource and API key; the library itself is a straightforward wrapper around that service.

## Install

pip install azure-ai-translation-text
uv add azure-ai-translation-text
poetry add azure-ai-translation-text

## Installing azure-ai-translation-text

Before you install: Low install friction with a pure-Python wheel and three lightweight runtime dependencies. The package is actively maintained with a recent release and no known vulnerabilities.

Quickstart:

pip install azure-ai-translation-text

from azure.ai.translation.text import TextTranslationClient
from azure.core.credentials import AzureKeyCredential

credential = AzureKeyCredential(api_key)
client = TextTranslationClient(credential=credential, region=region)
response = client.translate(body=["Hello world"], to_language=["es"])

Requires an Azure Translator service resource and valid API key; Python 3.9 or later.

Verify before relying:

- Whether LLM-based tone-specific and gender-aware translation variants are available in all regions or require specific model selection.
- Rate limits and request size constraints for production workloads beyond the service documentation reference.

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 335.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

azure text translation, machine translation api, neural machine translation python, transliteration service, language detection translation, azure translator client, multilingual text translation, azure-sdk, nlp, cloud-api

[View on SkillFed](https://skillfed.io/packages/azure-ai-translation-text) · [View on PyPI](https://pypi.org/project/azure-ai-translation-text/)