1# Azure AI Text Translation — Python SDK Quick Reference
2 
3> Condensed from **azure-ai-translation-text-py**. Full patterns (transliteration, dictionary lookup, sentence boundaries)
4> in the **azure-ai-translation-text-py** plugin skill if installed.
5 
6## Install
7```bash
8pip install azure-ai-translation-text
9```
10 
11## Quick Start
12```python
13from azure.ai.translation.text import TextTranslationClient
14from azure.core.credentials import AzureKeyCredential
15client = TextTranslationClient(credential=AzureKeyCredential(key), region=region)
16```
17 
18## Non-Obvious Patterns
19- API key auth requires `region` param: `TextTranslationClient(credential=..., region="eastus")`
20- Source language param: `from_parameter="fr"` (not `from` — reserved word)
21- Dict example model: `from azure.ai.translation.text.models import DictionaryExampleTextItem`
22- Async: `from azure.ai.translation.text.aio import TextTranslationClient`
23 
24## Best Practices
251. Batch translations — send multiple texts in one request (up to 100)
262. Specify source language when known to improve accuracy
273. Use async client for high-throughput scenarios
284. Cache language list — supported languages change infrequently
295. Handle profanity appropriately for your application
306. Use `html` text_type when translating HTML content
317. Include alignment for applications needing word mapping
32