用途:Azure AI Translator 文档翻译服务的 Python 客户端库,面向批量文档翻译场景,在翻译过程中保留原有排版格式。
主要能力:支持批量提交翻译任务,可同时输出多种目标语言;支持单文档翻译;可查询整体任务与单个文档的翻译状态、取消运行中的任务;支持通过术语表(glossary)统一领域术语;可查询支持的文档格式与语言。支持格式包括 DOCX、PDF、PPTX、XLSX、HTML、TXT、RTF,以及 CSV、TSV、JSON、XML、XLIFF、XLF、MHTML 等。
使用方式:安装命令为 pip install azure-ai-translation-document。需配置环境变量 AZURE_DOCUMENT_TRANSLATION_ENDPOINT、AZURE_SOURCE_CONTAINER_URL、AZURE_TARGET_CONTAINER_URL;使用 API Key 时还需 AZURE_DOCUMENT_TRANSLATION_KEY,生产环境使用 DefaultAzureCredential 时设置 AZURE_TOKEN_CREDENTIALS=prod。推荐使用 DefaultAzureCredential,本地开发可直接使用,生产环境可改用 ManagedIdentityCredential 等具体凭据。客户端应使用上下文管理器(同步 with、异步 async with)以释放连接与令牌缓存。批量翻译通过 DocumentTranslationClient.begin_translation 提交,配合 DocumentTranslationInput 与 TranslationTarget 指定源、目标地址及语言;单文档翻译使用 SingleDocumentTranslationClient.translate。
适用场景:需要保留格式的批量文档本地化、多语言内容分发、企业文档翻译流水线。
限制:源与目标容器必须为 Azure Blob Storage,SAS 令牌需具备相应权限(源:Read、List;目标:Write、List);同一调用路径中不应混用同步与异步客户端;提交前应检查支持的格式。其余细节暂未提供。