SuperAPI AI 工具集

azure-ai-translation-document-py

写作与研究

查看项目

更新于 10-16 01:26

技能介绍

用途:Azure AI 文档翻译服务的 Python 客户端库,用于批量翻译文档并保留原始格式,支持 Word、PDF、Excel、PowerPoint、HTML、TXT、RTF 及 CSV、TSV、JSON、XML、XLIFF 等格式。

主要能力:使用 DocumentTranslationClient 通过 begin_translation 启动批量翻译任务,源与目标文档存放于 Azure Blob Storage;单个任务可配置多个目标语言,各语言使用独立目标容器;支持术语表(TranslationGlossary,如 CSV 格式)统一专业术语;可查询翻译状态、逐文档状态、取消任务;另提供 SingleDocumentTranslationClient 直接翻译单个文档字节流。

安装与配置:pip install azure-ai-translation-document。需设置环境变量 AZURE_DOCUMENT_TRANSLATION_ENDPOINT、AZURE_DOCUMENT_TRANSLATION_KEY,以及 AZURE_SOURCE_CONTAINER_URL、AZURE_TARGET_CONTAINER_URL。

认证:支持 API Key(AzureKeyCredential)与 Entra ID(DefaultAzureCredential,推荐)。

用法要点:构造 DocumentTranslationInput 与 TranslationTarget,调用 client.begin_translation 后用 poller.result() 等待完成,并通过 poller.status() 与 poller.details 查看成功与失败文档数。也可用 list_translation_statuses、list_document_statuses 检查状态,cancel_translation 取消任务;get_supported_document_formats、get_supported_languages 查询支持范围。异步客户端位于 azure.ai.translation.document.aio。

存储要求:源与目标必须为 Azure Blob Storage,SAS 令牌需具备源读取与列出、目标写入与列出权限。

适用场景:需要批量、多语言、保留版式的文档本地化任务。

限制:仅适用于明确匹配上述范围的场景;输出不能替代环境相关的验证、测试或专家审核;缺少必要输入、权限、安全边界或成功标准时应先询问澄清。示例代码与完整参数细节以官方资料为准,此处未展开。