如何配置 PDFMathTranslate 接入自定义 OpenAI 兼容代理网关

如何配置 PDFMathTranslate 接入自定义 OpenAI 兼容代理网关【免费下载链接】PDFMathTranslate[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译支持 Google/DeepL/Ollama/OpenAI 等服务提供 CLI/GUI/MCP/Docker/Zotero项目地址: https://gitcode.com/GitHub_Trending/pd/PDFMathTranslate当你有一个兼容 OpenAI API 的自建代理网关例如 grok2api 这类转发服务、本地 Ollama 的 OpenAI 兼容端点或任何自托管推理网关想让 PDFMathTranslate 通过它完成论文 PDF 的翻译时需要做两件事在 PDFMathTranslate 的配置文件中注册一个指向网关的服务项再用--service参数指定该服务运行翻译。docs/PROXY_CONFIGURATION.md 专门描述了这个接入流程包括配置格式、各变量的含义以及典型报错的排查方法。开始前需要已安装 PDFMathTranslatePython 版本要求 3.11 到 3.12安装命令为pip install pdf2zh见 README。选择服务openailiked 还是 grok项目文档建议对自定义代理使用OPENAILIKED服务以获得最大兼容性PROXY_CONFIGURATION.md 的 Notes 一节原话。两类服务的配置变量如下变量必填默认值说明OPENAILIKED_BASE_URL是无网关地址必须以/v1结尾OPENAILIKED_API_KEY否无代码中缺省时使用openailiked占位API 认证密钥OPENAILIKED_MODEL是无网关侧的模型名OPENAILIKED_STREAM否false是否启用流式模式grok服务则对应GROK_BASE_URL可选默认https://api.x.ai/v1、GROK_API_KEY必填、GROK_MODEL默认grok-2-1212、GROK_STREAM默认true四个变量。如果你接的是 grok2api 之类的 Grok 专用代理用它更贴切其余自定义网关走openailiked即可。注意无论用哪个服务BASE_URL必须以/v1结尾如http://your-proxy:8000/v1缺少/v1后缀会报 404 错误。这一点在 ADVANCED.md 的自定义配置文件一节中有明确警告。主路径在 config.json 中配置 openailiked打开配置文件nano ~/.config/PDFMathTranslate/config.json在translators数组中加入openailiked条目下面是文档中的配置结构http://your-proxy:8000/v1、your-api-key、grok-4为文档示例值需替换为你自己网关的地址、密钥和模型名{ translators: [ { name: openailiked, envs: { OPENAILIKED_BASE_URL: http://your-proxy:8000/v1, OPENAILIKED_API_KEY: your-api-key, OPENAILIKED_MODEL: grok-4, OPENAILIKED_STREAM: false } } ] }文档中给这段配置的定位是For custom proxies that dont support streaming即OPENAILIKED_STREAM设为false适合不支持流式的代理流式与非流式的取舍见下文Notes。运行翻译用--service指定刚才注册的服务-o指定输出目录pdf2zh input.pdf --service openailiked -o ./output如果想指定源/目标语言可参考 ADVANCED.md 的语言参数用法例如pdf2zh example.pdf -li en -lo ja也可以通过配置文件中的PDF2ZH_LANG_FROM/PDF2ZH_LANG_TO设置文档完整示例使用English/Simplified Chinese。配置文件默认存放在~/.config/PDFMathTranslate/config.json也可以用--config参数指向其他路径例如pdf2zh example.pdf --config config.json见 ADVANCED.md。备选路径通过环境变量配置不修改配置文件时可以直接设置环境变量再运行以grok服务为例PROXY_CONFIGURATION.md 的 Environment Variables 一节export GROK_BASE_URLhttp://your-proxy:8000/v1 export GROK_API_KEYyour-api-key export GROK_MODELgrok-4 export GROK_STREAMfalse pdf2zh input.pdf --service grok注意优先级规则环境变量的优先级高于config.json即当环境变量存在时以环境变量为准。另外用grok服务接代理时配置写法如下文档 Quick Start 原例your-proxy:8000与your-api-key需替换为实际值{ name: grok, envs: { GROK_BASE_URL: http://your-proxy:8000/v1, GROK_API_KEY: your-api-key, GROK_MODEL: grok-4, GROK_STREAM: false } }验证网关连通性与模型名文档给出的核对方式是用curl查询网关的模型列表curl http://your-proxy:8000/v1/models \ -H Authorization: Bearer your-api-key把返回的模型名与配置里的*_MODEL对照确认网关认识你配置的模型名。按报错对症处理PROXY_CONFIGURATION.md 的 Troubleshooting 一节列出了四种典型现象及文档给出的原因和解决办法报错现象文档给出的原因解决办法Model not found代理不认识该模型名用上面的curl .../v1/models查询可用模型然后更新GROK_MODEL或OPENAILIKED_MODEL为有效模型名str object has no attribute choices代理返回流式格式但代码按非流式处理把对应的*_STREAM设为falseConnection error或404 Not Foundbase URL 不正确确认 URL 以/v1结尾如http://your-proxy:8000/v1Missing authentication tokenAPI key 未配置或错误核对配置中的 API key文档给出的完整配置示例以下配置同时注册了grok和openailiked两个服务并限制启用的服务文档中 Complete Example 原样保留your-proxy:8000与your-api-key为待替换的文档示例值{ USE_MODELSCOPE: 0, PDF2ZH_LANG_FROM: English, PDF2ZH_LANG_TO: Simplified Chinese, translators: [ { name: grok, envs: { GROK_BASE_URL: http://your-proxy:8000/v1, GROK_API_KEY: your-api-key, GROK_MODEL: grok-4, GROK_STREAM: false } }, { name: openailiked, envs: { OPENAILIKED_BASE_URL: http://your-proxy:8000/v1, OPENAILIKED_API_KEY: your-api-key, OPENAILIKED_MODEL: grok-4, OPENAILIKED_STREAM: false } } ], ENABLED_SERVICES: [grok, openailiked] }本地 Ollama 与流式模式取舍如果网关其实是本地 Ollama 的 OpenAI 兼容端点文档给出的示例配置是{ name: openailiked, envs: { OPENAILIKED_BASE_URL: http://localhost:11434/v1, OPENAILIKED_API_KEY: ollama, OPENAILIKED_MODEL: llama3, OPENAILIKED_STREAM: false } }关于*_STREAM两个取值文档 Notes 一节的说明是流式模式true响应感知更快但可能与部分代理存在兼容性问题非流式模式false兼容性更好但要等待完整响应base URL 始终要以/v1结尾对接自定义代理时优先用OPENAILIKED服务以获得最大兼容性。配置完成后若curl模型查询正常但翻译仍报错按上表对照报错信息逐项检查模型名、_STREAM取值、URL 后缀和 API key这四类是文档覆盖的接入报错范围未列出的现象需要参考报错原文自行定位。【免费下载链接】PDFMathTranslate[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译支持 Google/DeepL/Ollama/OpenAI 等服务提供 CLI/GUI/MCP/Docker/Zotero项目地址: https://gitcode.com/GitHub_Trending/pd/PDFMathTranslate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考