功能说明#

本工具适用于字幕、文本等文件的多语言翻译任务，支持批量处理、缓存优化、多语言导出等多种场景，帮助您高效完成本地化工作。

多语言翻译：一次翻译，输出多语种#

你可以将同一个文件同时翻译为多种语言，适合多语种字幕或国际化项目：

• 示例：将英文字幕翻译为中文、日语、德语、法语等
• 当前支持 50+ 种语言，后续将持续增加

翻译缓存：减少重复翻译，提升效率#

为避免重复请求翻译 API，本工具引入本地缓存机制：

• 缓存规则：每段翻译内容会以 源文本_目标语言_源语言_翻译 API_模型设置 作为唯一 key 进行存储
• 缓存命中条件：需各参数完全一致，才会调用缓存结果
• 缓存作用：避免重复翻译，减少 API 调用次数，提高翻译速度。

如不希望使用缓存功能，可在设置中：取消勾选“使用翻译缓存”，或在 API 设置中点击“清除翻译缓存”按钮进行手动清除。

翻译模式：自动适用类型#

工具会根据上传行为自动切换翻译模式，无需手动选择：

• 批量模式（默认）：支持同时上传多个文件，适合大规模翻译任务，翻译结果自动下载保存。
• 单文件模式：当仅上传一个文件或粘贴文本时，将进入单文件模式，适合快速预览或测试翻译结果。注意：单文件模式下，每次上传会覆盖上一个文件。

设置导入/导出#

支持一键导出/导入当前设置，便于跨设备或迁移部署：

• 导出内容包含所有配置（包括 API 密钥等敏感信息）
• 导入将覆盖当前配置，请务必在操作前备份确认

翻译 API 参数详解#

为了兼顾上下文和接口限制，您可自定义如下关键参数：

分块翻译大小#

对于非AI翻译API，工具会将文本自动分块后翻译，便于处理长文档或字幕。分块翻译大小即指每个打包块的字符数上限。以下是常见接口的最大字符限制：

翻译服务	单次最大字符数
DeepL API	128,000 字符
DeepLX Free	1,000 字符
Azure Translate	10,000 字符
Google Translate 网页端	5,000 字符
Google Cloud API	30,000 字符

⚠️ 注意：Google Translate 网页版可能破坏换行符，因此未使用分块翻译方式。

延迟时间（ms）#

控制分块翻译之间的请求间隔，有助于避免频繁请求失败：

• 建议在网络较差或使用免费 API时设置更高延迟
• 例如：使用 Azure Translate 免费接口时，建议设置为 5000ms 以上

翻译速率#

设定请求频率过高会触发限流或返回空值（如 HTTP 429 错误）：

• 请根据实际使用的服务类型调整速率
• 若频繁遇到错误，建议降低速率或增加延迟