SuperAPI AI 工具集

azure-ai-translation-ts

写作与研究

查看项目

更新于 10-16 06:47

技能介绍

用途:使用 Azure 翻译 SDK 在 TypeScript/JavaScript 中构建翻译应用,覆盖文本翻译与文档翻译两类场景。

主要能力:文本翻译客户端支持 API Key+区域或凭据认证,可翻译文本、指定源语言或自动检测、多目标语言、纯文本或 HTML、脏话处理与语气选项;支持获取支持语言列表、音译(转写)和语言检测。文档翻译客户端支持 TokenCredential 或 API Key 认证,可翻译单个文档(multipart/form-data,返回流)以及通过源/目标容器 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;使用 DefaultAzureCredential 时生产环境需 AZURE_TOKEN_CREDENTIALS=prod。

用法要点:文本客户端通过 client.path("/translate").post 提交 inputs,用 isUnexpected(response) 检查错误;文档客户端通过 client.path("/document:translate").post 或 "/document/batches" 发起请求,批量任务从 operation-location 头取 operationId,再用 paginate 分页。

适用场景:需要多语言文本翻译、音译、语言检测,或批量文档翻译的 Node.js/TypeScript 应用。

限制:需 Azure 翻译资源与有效凭据;文档批量翻译依赖 Azure Blob 存储 SAS URL;具体配额、价格与支持语言范围暂未提供。