Loading source

Preparing the source view

Pulling the file list, source metadata, and syntax-aware rendering for this listing.

Source from repo

Azure AI Services

Build with Azure AI Search, Speech, OpenAI, and Document Intelligence services.

microsoftGitHub microsoftOfficialSource repo Original GitHub link Publisher page

Files

16

Skill

n/a

Size

28.1 KB

Entrypoint

SKILL.md

Format

git-repo

Open file

references/sdk/azure-ai-translation-text-py.md

Syntax-highlighted preview of this file as included in the skill package.

Rendered Source

markdown32 linesFree

Azure AI Text Translation — Python SDK Quick Reference

Condensed from azure-ai-translation-text-py. Full patterns (transliteration, dictionary lookup, sentence boundaries) in the azure-ai-translation-text-py plugin skill if installed.

Install

pip install azure-ai-translation-text

Quick Start

from azure.ai.translation.text import TextTranslationClient
from azure.core.credentials import AzureKeyCredential
client = TextTranslationClient(credential=AzureKeyCredential(key), region=region)

Non-Obvious Patterns

API key auth requires region param: TextTranslationClient(credential=..., region="eastus")
Source language param: from_parameter="fr" (not from — reserved word)
Dict example model: from azure.ai.translation.text.models import DictionaryExampleTextItem
Async: from azure.ai.translation.text.aio import TextTranslationClient

Best Practices

Batch translations — send multiple texts in one request (up to 100)
Specify source language when known to improve accuracy
Use async client for high-throughput scenarios
Cache language list — supported languages change infrequently
Handle profanity appropriately for your application
Use html text_type when translating HTML content
Include alignment for applications needing word mapping