PDFMathTranslate项目腾讯云翻译API配置指南

腾讯云翻译API环境变量配置详解

在使用PDFMathTranslate项目进行PDF文档翻译时，腾讯云机器翻译(Tencent Machine Translation)是一个可选的服务。本文将详细介绍如何正确配置腾讯云翻译API所需的环境变量。

环境变量配置方法

腾讯云翻译服务需要配置两个关键环境变量：

1. TENCENT_SECRET_ID - 腾讯云API访问密钥ID
2. TENCENT_SECRET_KEY - 腾讯云API访问密钥

Windows系统配置方法

在Windows命令提示符(cmd)中，使用以下命令设置环境变量：

set TENCENT_SECRET_ID=您的SecretID
set TENCENT_SECRET_KEY=您的SecretKey

设置完成后，在同一命令窗口执行PDFMathTranslate命令即可使用腾讯翻译服务。

Linux/MacOS系统配置方法

在终端中使用export命令设置环境变量：

export TENCENT_SECRET_ID=您的SecretID
export TENCENT_SECRET_KEY=您的SecretKey

或者可以在一行命令中同时设置环境变量并执行翻译：

export TENCENT_SECRET_ID=您的SecretID && export TENCENT_SECRET_KEY=您的SecretKey && pdf2zh 文件名.pdf -s tencent

常见问题解决

1. "Unsupported translation service"错误
   这表示当前版本可能尚未支持腾讯翻译服务，建议检查项目最新版本或使用其他翻译服务。

2. 环境变量不生效
   确保环境变量设置后没有开启新的命令行窗口，因为环境变量只在当前会话有效。

3. 密钥格式问题
   腾讯云的SecretID通常以"AKID"开头，请确保复制完整没有遗漏。

最佳实践建议

1. 对于频繁使用的情况，可以考虑将环境变量设置写入系统配置文件，如Windows的环境变量设置或Linux的~/.bashrc文件。

2. 使用腾讯云翻译时，注意API调用配额和费用情况，避免意外产生高额费用。

3. 密钥属于敏感信息，不要在公共场合或代码中明文存储，建议使用环境变量或专门的密钥管理工具。

通过正确配置这些环境变量，PDFMathTranslate项目将能够利用腾讯云的高质量翻译服务来处理PDF文档，为用户提供准确的中文翻译结果。