LibreTranslate

在线试用！ | API文档 | 社区论坛

![Python版本]([] ![运行测试]([] ![发布至DockerHub]([] ![发布至GitHub容器 registry]([] ![Awesome Humane Tech]([***]

免费开源的机器翻译API，完全支持自托管。与其他API不同，它不依赖谷歌或Azure等专有服务提供商来执行翻译。

!image

在线试用！ | API文档

API示例

请求：

javascript
const res = await fetch("[***]", {
	method: "POST",
	body: JSON.stringify({
		q: "Hello!",
		source: "en",
		target: "es"
	}),
	headers: { "Content-Type": "application/json" }
});

console.log(await res.json());

响应：

javascript
{
    "translatedText": "¡Hola!"
}

安装和运行

只需几步设置，即可运行自己的API服务器！

确保已安装Python（建议3.8或更高版本），然后执行：

bash
pip install libretranslate
libretranslate [参数]

然后打开浏览器访问 http://localhost:5000

如果使用Windows，建议通过Docker运行。

在Ubuntu 20.04上，也可使用 [***] 提供的安装脚本。

构建和运行

如果需要修改代码，可从源代码构建并运行API：

bash
git clone [***]
cd LibreTranslate
pip install -e .
libretranslate [参数]

# 或
python main.py [参数]

然后打开浏览器访问 http://localhost:5000

通过Docker运行

直接执行：

bash
docker run -ti --rm -p 5000:5000 libretranslate/libretranslate

然后打开浏览器访问 http://localhost:5000

通过Docker构建

bash
docker build [--build-arg with_models=true] -t libretranslate .

如果要在完全离线环境中运行Docker镜像，需添加--build-arg with_models=true参数，语言模型将在镜像构建过程中下载。否则，模型将在镜像/容器首次运行时下载。

运行构建的镜像：

bash
docker run -it -p 5000:5000 libretranslate [参数]

或使用docker-compose构建并运行：

bash
docker-compose up -d --build

可修改docker-compose.yml文件以适应部署需求，或使用额外的docker-compose.prod.yml文件进行部署配置。

参数说明

注意：每个参数都有对应的环境变量，可用于替代默认值。环境变量会覆盖默认值，但优先级低于命令行参数。在Docker中使用环境变量尤为方便，其名称为命令行参数的大写蛇形形式，前缀为LT。

使用Gunicorn运行

bash
pip install gunicorn
gunicorn --bind 0.0.0.0:5000 'wsgi:app'

可通过以下方式直接向Gunicorn传递应用参数：

bash
gunicorn --bind 0.0.0.0:5000 'wsgi:app(api_keys=True)'

管理API密钥

LibreTranslate支持每用户限制配额，例如可向用户发放API密钥，使他们能享受更高的每分钟请求限制（需同时设置--req-limit）。默认情况下，所有用户基于--req-limit进行速率限制，但向REST端点传递可选的api_key参数可让用户享受更高请求限制。

只需使用--api-keys选项启动LibreTranslate即可启用API密钥。

添加新密钥

要创建一个每分钟120次请求限制的新API密钥：

bash
ltmanage keys add 120

删除密钥

bash
ltmanage keys remove <api-key>

查看密钥

bash
ltmanage keys

语言绑定

可通过以下绑定使用LibreTranslate API：

• Rust: [***]
• Node.js: [***]
• .Net: [***]
• Go: [***]
• Python: [***]

更多语言绑定即将推出！

Discourse插件

可使用此discourse翻译插件翻译Discourse主题。安装时只需修改/var/discourse/containers/app.yml：

yaml
## 插件配置
## 详见 [***]
hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - git clone [***]
          - git clone [***]
          ...

然后执行./launcher rebuild app。在Discourse管理面板中，选择“LibreTranslate”作为翻译提供商，并设置相关端点配置。

在线镜像列表

以下是提供LibreTranslate API的在线资源列表，部分需要API密钥。如需添加新URL，请提交pull request。

路线图

欢迎提交pull request贡献代码！

• Docker镜像（感谢@vemonet！）
• 自动检测输入语言（感谢@vemonet！）
• 用户认证/令牌
• 支持所有计算机语言的绑定
• 改进翻译质量

FAQ

能否在生产环境中使用libretranslate.com的API服务器？

libretranslate.com的API应仅用于测试、个人使用或低频使用。如要在生产环境中运行应用，请联系我们获取API密钥或讨论其他选项。

能否在反向代理（如Apache2）后使用？

可以，以下是将子域名（带HTTPS证书）重定向到本地Docker运行的LibreTranslate的Apache2配置示例：

bash
sudo docker run -ti --rm -p 127.0.0.1:5000:5000 libretranslate/libretranslate

如希望同时通过domain.tld:5000和subdomain.domain.tld访问，可删除上述命令中的127.0.0.1（有助于排查Apache2或Docker容器问题）。

如需Docker在启动时自动运行（除非手动停止），添加--restart unless-stopped。

ApacheConf
#Libretranslate

#将http重定向到https
<VirtualHost *:80>
    ServerName http://[YOUR_DOMAIN]
    Redirect / https://[YOUR_DOMAIN]
    # ErrorLog ${APACHE_LOG_DIR}/error.log
    # CustomLog ${APACHE_LOG_DIR}/tr-access.log combined
 </VirtualHost>

#https
<VirtualHost *:443>
    ServerName https://[YOUR_DOMAIN]
    
    ProxyPass / [***]
    ProxyPassReverse / [***]

    SSLEngine on
    SSLCertificateFile /etc/letsencrypt/live/[YOUR_DOMAIN]/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/[YOUR_DOMAIN]/privkey.pem
    SSLCertificateChainFile /etc/letsencrypt/live/[YOUR_DOMAIN]/fullchain.pem
    
    # ErrorLog ${APACHE_LOG_DIR}/tr-error.log
    # CustomLog ${APACHE_LOG_DIR}/tr-access.log combined
</VirtualHost>

致谢

本项目的实现很大程度上得益于Argos Translate提供的翻译引擎。

许可证

GNU Affero General Public License v3