MuleRun文档多语言翻译有四种方法：一、REST API调用，需构造含source_lang、target_lang和text的JSON请求；二、CLI工具批量处理，支持.docx等格式并保留排版；三、Python SDK集成，提供自动检测与错误处理；四、Web UI交互式翻译，无需代码，支持拖拽上传与格式还原。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您需要使用MuleRun对文档进行多语言翻译，但不确定如何正确调用其多语言翻译智能体，则可能是由于未配置正确的输入格式、未指定目标语言或未正确接入API接口。以下是实现文档翻译的几种具体方法：
一、通过REST API直接调用翻译智能体
该方法适用于具备后端开发能力的用户，通过构造标准HTTP请求将待翻译文档内容提交至MuleRun提供的翻译端点，由服务端完成语义理解与跨语言生成。
1、准备待翻译的纯文本内容或提取文档中的可读段落（如PDF需先OCR或解析为UTF-8文本）。
2、构建POST请求，请求头中设置Content-Type: application/json并携带有效认证Token。
3、在请求体中以JSON格式传入字段：{"source_lang": "zh", "target_lang": "en", "text": "需要翻译的中文句子"}。
4、发送请求至MuleRun官方文档中公布的翻译API地址，例如/v1/translate。
5、接收响应体中键为translated_text的字段值，即为目标语言译文。
二、使用MuleRun CLI工具批量处理本地文档文件
该方法适用于需离线或批量处理Word、Markdown、TXT等格式文档的场景，CLI工具内置文档解析模块，可自动识别编码并分段调用翻译引擎。
1、在终端执行命令安装CLI：pip install mulerun-cli。
2、运行初始化命令：mulerun init --api-key YOUR_API_KEY，填入平台分配的有效密钥。
3、执行翻译指令：mulerun translate --input report.docx --output report_en.docx --src zh --tgt es。
4、确认输出目录中生成的目标语言文档，格式与源文件一致，保留原始排版结构（仅限.docx与.md支持样式映射）。
三、在Python脚本中集成MuleRun翻译SDK
该方法适用于需嵌入现有数据处理流程的开发者，SDK封装了重试机制、字符截断处理及语言自动检测逻辑，降低集成复杂度。
1、执行安装命令：pip install mulerun-sdk。
2、在Python代码中导入模块：from mulerun.translator import DocumentTranslator。
3、实例化翻译器对象，传入api_key与region参数（如"cn"或"us"）。
4、调用translator.translate_file("manual.pdf", target_lang="ja")，返回生成的PDF路径。
5、检查返回对象中的status字段是否为"success"，否则读取error_code进行故障排查。
四、通过Web UI上传文档并选择语言对进行交互式翻译
该方法面向无技术背景的终端用户，利用MuleRun控制台图形界面完成文档上传、语言设定与结果预览，全程无需编写代码或配置环境。
1、登录MuleRun官网控制台，进入Translation Studio功能模块。
2、点击+ Upload Document按钮，支持拖拽或点击选择文件，兼容格式包括PDF、DOCX、MD、TXT、RTF。
3、在语言选择区域，分别从下拉菜单中指定源语言（Source Language）和目标语言（Target Language）。
4、勾选Preserve original formatting选项以启用排版还原功能（仅对.docx与.pdf生效）。
5、点击Start Translation，等待状态栏显示“Completed”，点击下载图标获取译文文件。
