算力猫
← 返回教程列表

接入软件

PDFMathTranslate(pdf2zh)

保留公式排版的论文翻译工具:三个环境变量。

约 4 分钟适合:要整篇翻译 PDF 论文的研究者和学生

开始之前

  • 已安装 pdf2zh(pdf2zh --version 能运行)
  • 一把 Key 和一个模型名

步骤 1 · STEP 0x01

设置三个环境变量

bash
export OPENAI_BASE_URL=https://api.suanlimao.shop/v1
export OPENAI_API_KEY=<你的 Key>
export OPENAI_MODEL=<模型名>
terminal
$ export OPENAI_BASE_URL=https://api.suanlimao.shop/v1$ export OPENAI_API_KEY=<你的 Key>$ export OPENAI_MODEL=<模型名>
  • 官方文档强调:OPENAI_BASE_URL 必须以 /v1 结尾,缺少 /v1 会得到 404。
  • OPENAI_MODEL 填从模型广场复制的名字。整篇论文翻译 token 量大,选便宜的模型更划算。
完整 Key 只在创建时显示一次,关闭页面就看不到了。没来得及保存?吊销它,再创建一把新的。

去创建 Key →

步骤 2 · STEP 0x02

用 openai 服务翻译

terminal
$ pdf2zh paper.pdf -s openai…$ lspaper-mono.pdf  paper-dual.pdf
  • -s openai 指定翻译服务;也可以不设 OPENAI_MODEL,直接写 -s openai:模型名。
  • 输出两份:-mono 是纯译文,-dual 是双语对照。
模型名不要自己猜:到「模型广场」点模型卡片上的「复制模型名」,再粘贴到软件里。模型名写错是最常见的报错原因。

打开模型广场 →

步骤 3 · STEP 0x03

新版 pdf2zh-next(可选)

terminal
$ pdf2zh_next paper.pdf --openai --openai-base-url https://api.suanlimao.shop/v1 --openai-api-key <你的 Key> --openai-model <模型名>(参数名以 pdf2zh_next -h 的输出为准)
官方新版 pdf2zh-next 把 OpenAI 和「OpenAI Compatible」列为一级翻译引擎,参数名由配置项推导(官方规则:环境变量名是把 -- 换成 PDF2ZH_、- 换成 _)。具体参数请以 pdf2zh_next -h 为准。

✓ 怎么确认成功了

  • 生成了 -mono / -dual 两份 PDF;控制台「用量」页出现请求。

常见问题

404?

官方明说:OPENAI_BASE_URL 缺少 /v1 后缀会 404。确认是 https://api.suanlimao.shop/v1。

401?

OPENAI_API_KEY 没设置或没复制全;Windows 上 PowerShell 和 cmd 设变量的写法不同。

翻译一篇要花多少?

取决于页数和模型价格。先给这把 Key 设一个预算上限,再看「用量」页的实际消耗。

相关教程

还是不行?

先看排错教程;仍然解决不了,提交工单时附上 request_id、时间、模型和报错原文(不要贴 Key)。