用途：面向 TypeScript 开发者，演示如何使用 Azure 翻译 SDK 的 REST 风格客户端完成文本翻译与文档翻译。
主要能力：文本翻译（支持多目标语言、源语言自动检测、Plain/Html 文本类型、profanityAction、tone 等选项）、获取支持语言、音译、语言检测；文档翻译支持单文档翻译与基于 Azure Blob 存储 SAS URL 的批量翻译，并可查询翻译状态、分页列出文档、获取支持格式。
安装：文本翻译执行 npm install @azure-rest/ai-translation-text @azure/identity；文档翻译执行 npm install @azure-rest/ai-translation-document @azure/identity。
环境变量：TRANSLATOR_ENDPOINT、TRANSLATOR_SUBSCRIPTION_KEY、TRANSLATOR_REGION。
用法要点：文本客户端可用 API Key + Region 或仅凭据（全局端点）初始化；调用 /translate、/languages、/transliterate、/detect 等路径。文档客户端可用 DefaultAzureCredential 或 API Key 初始化，单文档走 /document:translate，批量走 /document/batches，状态查询走 /document/batches/{id}，格式查询走 /document/formats。
最佳实践：省略 language 自动检测源语言；批量请求提升效率；文档翻译使用限时 SAS 令牌；访问 body 前先检查 isUnexpected(response)；使用区域端点降低延迟。
限制：仅适用于与上述范围明确匹配的任务；输出不能替代针对具体环境的验证、测试或专家评审；若缺少必要输入、权限、安全边界或成功标准，应停止并请求澄清。