如何使用 Azure AI Translation 在 TypeScript 中实现文本与文档翻译

解决应用国际化与多语言处理需求：通过集成 Azure AI Translation SDK，在 TypeScript 项目中快速构建支持文本实时翻译、文档格式转换及大规模语料处理的自动化工作流。

为什么需要这个技能

在开发全球化应用时，手动调用 REST API 处理翻译请求往往需要处理复杂的认证、流式传输和错误重试机制。

Azure 提供的 TypeScript SDK 将这些底层细节封装为类型安全的客户端。无论是简单的短文本翻译，还是需要保持原格式的 PDF/Office 文档翻译，使用 SDK 都能极大地降低开发成本，并通过 isUnexpected 等内置机制确保 API 响应的健壮性。

适用场景

• 多语言内容平台：自动将用户生成的文本翻译成多种目标语言。
• 自动化文档处理：将存储在 Azure Blob Storage 中的大量文档批量翻译为指定语言。
• 语言分析工具：在处理未知语言输入时，自动检测来源语言并进行转写（Transliterate）。
• 企业级集成：需要严格的权限管理（如使用 DefaultAzureCredential）的生产环境。

核心工作流

1. 环境准备与安装

首先安装文本翻译和文档翻译对应的客户端库及身份验证模块：

# 文本翻译
npm install @azure-rest/ai-translation-text @azure/identity

# 文档翻译
npm install @azure-rest/ai-translation-document @azure/identity

2. 文本翻译实现

配置 TranslatorCredential（API Key + Region），通过 /translate 接口实现文本转换。你可以指定 textType 为 Plain 或 Html，并设置 tone（如 formal）以适应不同场景。

3. 文档翻译处理

针对文档翻译，SDK 提供了两种模式：

• 单文件翻译：通过 multipart/form-data 直接上传文件流并获取翻译结果。
• 批量翻译：利用 SAS URL 将源容器和目标容器关联，启动异步翻译任务，并通过 operationId 轮询查询状态。

4. 健壮性处理

在所有请求后，必须使用 isUnexpected(response) 检查响应状态，以防止在 API 报错时直接访问 body 导致程序崩溃。

下载和安装

下载 azure-ai-translation-ts 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。

你可能还需要

暂无推荐