1# Azure Translation — TypeScript SDK Quick Reference
2 
3> Condensed from **azure-ai-translation-ts**. Full patterns (document translation, batch SAS, transliterate)
4> in the **azure-ai-translation-ts** plugin skill if installed.
5 
6## Install
7```bash
8npm install @azure-rest/ai-translation-text @azure/identity
9```
10 
11## Quick Start
12```typescript
13import TextTranslationClient, { TranslatorCredential, isUnexpected } from "@azure-rest/ai-translation-text";
14const credential: TranslatorCredential = { key: process.env.TRANSLATOR_SUBSCRIPTION_KEY!, region: process.env.TRANSLATOR_REGION! };
15const client = TextTranslationClient(process.env.TRANSLATOR_ENDPOINT!, credential);
16```
17 
18## Non-Obvious Patterns
19- REST client — `TextTranslationClient` is a function, not a class
20- Translate via `client.path("/translate").post({ body: { inputs: [...] } })`
21- Document translation: separate package `@azure-rest/ai-translation-document`
22- Batch docs require SAS URLs for source/target blob containers
23 
24## Best Practices
251. Auto-detect source — omit `language` parameter to auto-detect
262. Batch requests — translate multiple texts in one call for efficiency
273. Use SAS tokens — for document translation, use time-limited SAS URLs
284. Handle errors — always check `isUnexpected(response)` before accessing body
295. Regional endpoints — use regional endpoints for lower latency
30