APIS

目录

当前项目支持两种类型的 API，所有方法都需要 Redis；

• Python 中的函数调用
• HTTP 协议

Python

由于 pdf2zh 是一个已安装的 Python 模块，我们公开了两个方法供其他程序在任何 Python 脚本中调用。

例如，如果你想使用 Google 翻译将文档从英语翻译成中文，可以使用以下代码：

from pdf2zh_next import translate, translate_stream

params = {
    'lang_in': 'en',
    'lang_out': 'zh',
    'service': 'google',
    'thread': 4,
}

翻译文件

使用文件进行翻译：

(file_mono, file_dual) = translate(files=['example.pdf'], **params)[0]

with open('example.pdf', 'rb') as f:
    (stream_mono, stream_dual) = translate_stream(stream=f.read(), **params)

⬆️ 返回顶部

HTTP

以更灵活的方式，您可以通过 HTTP 协议与程序进行通信，如果：

1. 安装并运行后端

pip install pdf2zh_next[backend]
pdf2zh_next --flask
pdf2zh_next --celery worker

1. 使用如下 HTTP 协议：

2. 提交翻译任务

   curl http://localhost:11008/v1/translate -F "[email protected]" -F "data={\"lang_in\":\"en\",\"lang_out\":\"zh\",\"service\":\"google\",\"thread\":4}"
   {"id":"d9894125-2f4e-45ea-9d93-1a9068d2045a"}
   

3. 检查进度

   curl http://localhost:11008/v1/translate/d9894125-2f4e-45ea-9d93-1a9068d2045a
   {"info":{"n":13,"total":506},"state":"PROGRESS"}
   

4. 检查进度 (如果已完成)

   curl http://localhost:11008/v1/translate/d9894125-2f4e-45ea-9d93-1a9068d2045a
   {"state":"SUCCESS"}
   

5. 保存单语文件

   curl http://localhost:11008/v1/translate/d9894125-2f4e-45ea-9d93-1a9068d2045a/mono --output example-mono.pdf
   

6. 保存双语文件

   curl http://localhost:11008/v1/translate/d9894125-2f4e-45ea-9d93-1a9068d2045a/dual --output example-dual.pdf
   

7. 如果正在运行则中断并删除任务

   curl http://localhost:11008/v1/translate/d9894125-2f4e-45ea-9d93-1a9068d2045a -X DELETE
   

⬆️ 返回顶部