SuperAPI AI 工具集

translator

办公与效率

查看项目

更新于 10-25 20:20

技能介绍

Zoom AI Services Translator 是 Zoom AI Services 中的文本翻译能力,本资料为面向该服务的参考技能说明,核心用途是帮助开发者在符合路由条件时正确接入翻译接口。

用途与路由:当用户需要翻译纯文本时,应优先路由到本技能。若需先将音视频转写再翻译,则先路由到 ../scribe/SKILL.md 再串联到本技能;若需摘要或行动项,路由到 ../summarizer/SKILL.md;若需翻译前的实时会议媒体,路由到 ../rtms/SKILL.md;若需原始 AI Services 端点清单,串联 ../rest-api/SKILL.md;若需 webhook 签名模式,可选串联 ../webhooks/SKILL.md。

主要能力与端点:支持两种模式。Fast 模式为同步翻译,接口为 POST /aiservices/translator/translate,适用于单条文本输入。Batch 模式为异步批量任务,接口包括 POST /aiservices/translator/jobs(提交任务)、GET /aiservices/translator/jobs(列出任务)、GET /aiservices/translator/jobs/{jobId}(查看任务状态)、DELETE /aiservices/translator/jobs/{jobId}(取消排队或处理中的任务)、GET /aiservices/translator/jobs/{jobId}/files(查看逐文件结果)、GET /aiservices/translator/jobs/{jobId}/files/{fileId}(查看单个文件结果)。

使用方式(核心工作流):1)获取 Build-platform API key 与 API secret;2)在服务器端生成 HS256 JWT;3)选择模式:单条文本用 fast 模式,存储的文本文件用 batch 模式;4)设置 source_language 与单个 target_languages 条目;5)提交请求并持久化 result.translations;6)批处理任务通过轮询任务/文件状态或接收 webhook 通知获取进度。

模式选择:4,000 字符以下的单条文本用 Fast 模式;S3 中的 .txt 文件用 Batch 模式;聊天消息、界面字符串、工作流动作适合 Fast 模式;大型离线文档归档适合 Batch 模式。

翻译约束:Fast 模式每次请求仅支持一个目标语言;Batch 模式每个任务仅支持一个目标语言;翻译为与英语的双向翻译,每个请求或任务必须将 source_language 或 target_languages 之一设为 en-US;暂不支持非英语到非英语的语言对;需使用 BCP-47 语言代码(如 en-US、es-ES),而非 en 这类短代码。

串联组合:媒体转写后翻译(scribe + translator);摘要转本地化输出(summarizer + translator);批量 webhook 接收器(translator + webhooks);原始端点发现(rest-api);跨产品路由(general)。

资料还提供若干快速链接:scenarios/high-level-scenarios.md、examples/fast-mode-node.md、examples/batch-webhook-pipeline.md、references/api-reference.md、references/environment-variables.md、references/samples-validation.md、troubleshooting/common-drift-and-breaks.md、RUNBOOK.md(含 5 分钟预检与调试清单)。官方文档地址包括 https://developers.zoom.us/docs/ai-services/、https://developers.zoom.us/docs/ai-services/translator/ 及 fast-mode、batch-mode 页面,端点清单为 https://developers.zoom.us/api-hub/ai-services/methods/endpoints.json,快速入门示例为 https://github.com/zoom/ai-services-quickstart/。具体定价、配额、速率限制和错误码细节暂未提供。

适用场景:需对短文本(聊天、界面文案、工作流动作)做同步英汉双向翻译,或对 S3 中 .txt 文件做异步批量英汉双向翻译的开发与集成。限制:仅英汉双向、单一目标语言、需服务器端 JWT 认证,其他语言对与多目标语言并发暂不支持。