LibreTranslate 自建翻译API完整指南:一条命令本地部署并调通接口

发布时间:2026/11/11 9:17:12

LibreTranslate 自建翻译API完整指南:一条命令本地部署并调通接口 LibreTranslate 自建翻译API完整指南一条命令本地部署并调通接口【免费下载链接】LibreTranslateFree and Open Source Machine Translation API. Self-hosted, offline capable and easy to setup.项目地址: https://gitcode.com/GitHub_Trending/li/LibreTranslate同事把内部文档站丢给我说加个中英互译吧。商业接口这条路我当场否了按字符计费传的还是内部资料。我选的是 LibreTranslate——一个免费、开源、可自托管的机器翻译服务装在自己的机器上就能提供翻译接口。一天后这个站有了自己说了算的翻译API翻译数据全程没出过内网。按下面的顺序走一遍你也能把这套服务搭起来。装之前先判断三条标准决定要不要自建翻译API先给结论下面三条命中任意一条就值得自建一条都不沾商业API的免费额度够你用了。数据不能出网。涉及客户资料、内部文档时很多公司对翻译数据隐私有明确要求。自建与商业服务最本质的差别就在这翻译请求全程在你自己的机器上完成文本不需要发给任何第三方服务器。量大、长期跑。商业翻译服务按调用量或字符数计费跑得越久账越大一套免费机器翻译跑起来之后边际成本只有电费调用次数你自己说了算也没有每分钟请求数的限制。环境联不上外网。内网、机房、离线设备上商业API直接不可用只有本地部署的开源翻译服务能顶上。一句实话它的底层是 Argos Translate 开源模型翻译质量略逊于大厂的商业引擎。对翻译质量要求高的场景先用 Web 界面试译几段样文再决定。十分钟完成翻译API本地部署Docker 一条命令前提机器上装了 Docker内存至少 2GB模型加载要吃内存。docker run -d -p 5000:5000 --name libretranslate libretranslate/libretranslate:latest首次启动会在后台下载语言模型几十个语言对下来需要几分钟所以第一次打开页面慢属正常。装完后浏览器打开http://localhost:5000你得到的不只是API还有一个完整的 Web 翻译界面——页面底部会直接展示当前请求的参数可以照着拼 curl。需要改代码或参与开发的话克隆源码仓库git clone https://gitcode.com/GitHub_Trending/li/LibreTranslatepip install -e .装好依赖后python main.py启动的效果和 docker 一样。仓库里自带 docker-compose.yml含健康检查配置生产部署时可以直接参考。敲通第一条请求/translate、/detect 与 /languages先用GET /health确认服务活着返回{status:ok}就可以开工。发第一条翻译请求curl -X POST http://localhost:5000/translate -d qHello world -d sourceauto -d targetzhsource传auto时服务端会先做语言检测所以响应里除了translatedText还会有带置信度的detectedLanguage字段。另外两个高频端点GET /languages返回已加载语言及每种语言能翻译到的目标列表targets。翻译报错时先查它POST /detect只检测不翻译传q参数返回语言代码和置信度。/translate同时支持 form 和 JSON 两种请求体q传数组就是批量翻译返回对应数组。完整参数不用背服务自带/docs接口文档页浏览器直接打开就能看。把翻译API接进你的代码import requests r requests.post( http://localhost:5000/translate, data{q: The weather is nice, source: auto, target: zh}, ) print(r.json()[translatedText])要翻译文件txt、docx 等则改用POST /translate_file上传文件后响应返回一个下载地址translatedFileUrl取回的就是翻译好的文件。开启 API 密钥的正确姿势只你自己用裸奔没问题多人或多服务共用时建议打开密钥认证这样每个调用方可以单独限流。两步启动时加开关docker 加-e LT_API_KEYStrue源码启动加--api-keys先带--api-keys启动一次让数据库建好然后签发密钥python manage.py keys add 100 --key auto第一个数字是该密钥每分钟可请求的次数--key auto自动生成也可以--key 你自己的串自定义。调用时在请求里带上api_key参数即可。密钥库默认落在db/api_keys.dbdocker 部署时把该目录挂成卷避免重建容器丢密钥。省内存只加载你用的语言默认行为会安装全部语言对内存占用高、首启下载久。只用中英的话只装这一对python main.py --load-only en,zh --host 0.0.0.0 --port 5000docker 部署则加环境变量LT_LOAD_ONLYen,zh效果相同。语言越少启动越快内存越省——先按需裁剪确认质量后再扩展。三个最常见的坑现象、原因、解法现象启动后页面长时间打不开或容器反复重启。原因首次启动正在下载并安装语言模型属正常现象。解决耐心等或提前用 scripts/install_models.py 脚本预装docker 记得挂卷持久化模型目录。现象局域网里其他机器访问不了。原因默认绑定 127.0.0.1只监听本机。解决docker 用-p 5000:5000映射端口源码启动加--host 0.0.0.0。现象翻译返回 is not supported 之类的 400。原因你传的语言方向没有直接模型并非所有语言两两之间都有。解决先调GET /languages看targets字段挑现成的语言对。GPU 加速、Prometheus 监控--metrics、翻译结果缓存--translation-cache、多实例负载均衡这些深水区项目都留了对应参数需要时查官方文档即可。眼下你要做的就一件事跑通上面那条 curl 请求然后打开浏览器访问/docs页面对照着把每个参数试一遍——到这一步这套自建翻译API 就彻底归你了。【免费下载链接】LibreTranslateFree and Open Source Machine Translation API. Self-hosted, offline capable and easy to setup.项目地址: https://gitcode.com/GitHub_Trending/li/LibreTranslate创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/11/11 23:53:58

蓟州特种作业操作证网上查询全攻略:应届生如何快速上岗?

蓟州特种作业操作证网上查询全攻略:应届生如何快速上岗? 你是不是刚毕业就急着找工作,却因为没有特种作业操作证而被拒之门外?别急,今天咱们就来聊聊【蓟州特种作业操作证】怎么网上查询、怎么报名、怎么考,关键是还能帮你搞清楚应届生如何最快拿到证书…

2026/11/11 23:53:58

买假电工证犯法吗正规报名入口怎么找

买假电工证犯法吗正规报名入口怎么找 你是不是也遇到过这种情况:刚找到工作,结果公司要求必须有特种作业操作证才能上岗,可你手上什么证都没有,心里慌得不行,网上一搜就看到“买假电工证犯法吗”这种问题,越看越焦虑?别急,这篇文章就是为你准备的,带…

2026/11/11 23:48:58

移民电工证可以换香港?在哪考最稳妥?实操考试心里没底怕挂科

移民电工证可以换香港?在哪考最稳妥?实操考试心里没底怕挂科 实操考试心里没底怕挂科?你不是一个人。尤其是像南阳卧龙区的公路工程从业者,很多都在考虑如何把手中的电工证用上,甚至有人想着移民后还能不能在海外用。尤其是“移民电工证可以换香港”这个…

2026/11/11 12:42:59

电工证丢失还能补吗?千万别踩坑,丢了证等于失业

电工证丢失还能补吗?千万别踩坑,丢了证等于失业 你正在找工作,但手里的电工证突然丢了,这下怎么办?别急,先别慌, 电工证丢失还能补吗 ?答案是肯定的,但 千万别踩坑 ,补办流程如果不了解,可能会耽误你上岗、甚至影响到你的收入。…

2026/11/11 0:02:26

考低压电工证通过率考试真题与备考技巧

低压电工证通过率高不高?学历不高也能考,值不值得考? 你是不是总听说电工证能帮你找高薪工作,但又担心自己学历不够,考不上?其实,低压电工证考试门槛并没有你想象中那么高,关键是方法对不对。这篇文章就告诉你, 考低压电工证通过率到底有多高 ,…

2026/11/11 0:02:26

低压电工证学时千万别踩坑,濮阳毕业生怎么避坑报名

低压电工证学时千万别踩坑,濮阳毕业生怎么避坑报名 你是不是也和我一样,刚毕业就听说低压电工证学时必须达标才能上岗?可一打听,发现报名机构五花八门,价格参差不齐, 不知道去哪报名怕被中介坑…

2026/11/11 20:27:01

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/10 10:29:37

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑