$ npm install traneasy-sdk

开发者资源一站下载
SDK / 模型 / 工具

不管你用的是Python、Node.js、Java、Go还是.NET，都能在这里找到对应的翻译SDK和安装命令。除此之外，翻译模型权重文件、Docker自部署镜像、CLI命令行工具——所有开发者需要的资源都在这里。

浏览 SDK CLI & Docker
traneasy@dev:~
$ pip install traneasy-sdk Collecting traneasy-sdk Downloading traneasy_sdk-4.1.0-py3-none-any.whl (3.8 MB) Installing collected packages: traneasy-sdk Successfully installed traneasy-sdk-4.1.0 $ traneasy translate --from zh --to en "你好" Hello $ docker pull traneasy/engine:latest latest: Pulling from traneasy/engine Digest: sha256:a1b2c3... Status: Downloaded $ _

SDK 下载

六种主流语言的原生SDK，设计哲学统一，用起来感觉一致

Py

Python SDK

v4.1.0

asyncio原生支持，内置请求池和连接复用。支持同步和异步两种调用风格，类型注解完整覆盖。

$ pip install traneasy-sdk
下载 .whl 3.8 MB
JS

Node.js SDK

v4.1.0

同时提供CJS和ESM双格式输出，TypeScript类型定义内嵌。支持Stream API实现流式翻译。

$ npm install traneasy-sdk
下载 .tgz 2.4 MB
Jv

Java SDK

v4.0.2

兼容Java 8至21，支持Spring Boot自动配置。提供同步/异步/响应式三种API，适配不同项目风格。

// Maven: com.traneasy:traneasy-sdk:4.0.2
下载 .jar 4.6 MB
Go

Go SDK

v4.1.0

纯Go实现，零CGO依赖。goroutine安全，内置连接池和自动重试，兼容Go 1.20以上版本。

$ go get github.com/traneasy/sdk-go
下载源码 1.9 MB
.N

.NET SDK

v4.0.1

支持.NET 6/7/8，NuGet分发。原生Task异步模式，与ASP.NET Core依赖注入无缝集成。

$ dotnet add package TranEasy.SDK
下载 .nupkg 3.2 MB
C++

C++ SDK

v4.1.0

Header-only库配合预编译共享库，CMake集成。支持C++17及以上标准，跨Linux/macOS/Windows。

$ cmake --build . --target traneasy
下载 .so/.dll 5.1 MB

模型下载

预训练翻译模型，量化版本适合端侧部署，完整版追求最高精度

🧠

Transformer 翻译模型

支持中、英、日、韩、法等42种语言对
1.2B
参数
2.4 GB
大小
下载模型
⚡

轻量量化模型

INT8量化，适配移动端和边缘设备
380M
参数
380 MB
大小
下载模型
📖

OCR 识别模型

支持横排、竖排、手写体及特殊字体
620M
参数
1.1 GB
大小
下载模型
🎤

ASR 语音识别模型

22种语言语音转文字，含噪声抑制
850M
参数
1.6 GB
大小
下载模型
🌐

多语言NMT模型

单一模型覆盖100+语言直接互译
2.8B
参数
5.6 GB
大小
下载模型
📦

术语库数据集

10万+专业术语双语对照，覆盖12个领域
120K
条目
48 MB
大小
下载数据

CLI 工具 & Docker 镜像

命令行爱好者和容器化部署的必备工具

💻 TranEasy CLI

跨平台命令行翻译工具，支持管道输入、文件批量翻译和JSON输出。可以轻松嵌入Shell脚本、CI/CD流水线或Vim/Emacs编辑器。

$ npm install -g traneasy-cli + traneasy-cli@2.3.0 installed $ echo "你好世界" | traneasy --to en Hello world $ traneasy batch --input ./docs/ --to ja --out ./ja/ Translated 47 files in 12.3s
下载 CLI

📦 Docker 镜像

官方维护的Docker镜像，包含完整的翻译引擎和REST API服务。一行命令即可在私有服务器上部署翻译能力，无需连接公网。

$ docker pull traneasy/engine:4.1.0 4.1.0: Pulling from traneasy/engine (428MB) $ docker run -p 8080:8080 -e API_KEY=xxx \ traneasy/engine:4.1.0 Server started on http://0.0.0.0:8080 $ curl http://localhost:8080/v1/translate \ -d '{"text":"Hello","to":"zh"}' {"translated":"你好"}
Docker Hub

文档与资源

离线阅读或批量打印，所有PDF随时可下载

📚

API 参考手册

286 页 · PDF 12.4 MB
下载 PDF
🔧

SDK 集成指南

164 页 · PDF 8.1 MB
下载 PDF
🛠

自部署运维手册

98 页 · PDF 5.2 MB
下载 PDF

资源更新日志

SDK、模型和工具的版本变更记录

v4.1.0

Python / Node / Go / C++ SDK 同步更新

2026-06-20
  • 新增 batch_translate() 批量翻译接口，单次最多支持100条文本
  • 流式翻译 API 正式版发布，支持 SSE 协议
  • Docker 镜像升级到 4.1.0，引擎性能提升 15%
v4.0.0

重大版本：统一API协议 & 新模型发布

2026-05-01
  • 所有语言SDK对齐v4 API协议，请求/响应格式完全统一
  • 发布1.2B参数Transformer翻译模型，BLEU分数提升至42.7
  • CLI工具2.0重构，支持交互模式和JSON配置
v3.5.0

.NET SDK首次发布 & 术语库扩展

2026-03-15
  • .NET SDK v1.0 正式发布，支持.NET 6/7/8
  • 术语库新增医学和法律两个领域，新增1.2万条专业术语
  • OCR模型升级，手写体识别准确率提升8%

资源使用统计

全球开发者对易翻译资源的信赖度

2,860万
SDK月度下载量
520万
Docker镜像拉取
18.6万
模型文件下载
380+
国家及地区覆盖

常见问题

SDK是开源的吗？可以商用吗？

SDK的客户端库全部在GitHub上以MIT协议开源，你可以自由地在商业项目中使用、修改和分发。翻译模型权重文件以CC BY-NC 4.0协议发布——个人和非商业用途免费，商业用途需要购买许可。Docker镜像中的引擎核心代码同样开源，但连接云端翻译服务需要有效的API Key。

Docker镜像可以离线使用吗？

可以，但需要额外下载离线模型文件挂载到容器内。Docker镜像本身只包含引擎和API服务（约430MB），不内置翻译模型。我们提供docker-compose模板，一键拉取引擎镜像并自动挂载模型目录。完全离线部署的总磁盘占用约3-6GB，取决于你加载了多少语言对。

SDK的API Key从哪里获取？

在易翻译开发者控制台注册账号后，进入"应用管理"创建应用即可生成API Key。每个账号默认可以创建3个应用、每应用2个Key（一个主Key一个备用Key）。免费额度每月10万字符，超过后按量计费。API Key的管理（轮换、吊销、额度监控）都在控制台完成。

不同语言的SDK功能有差异吗？

核心翻译功能在所有SDK中完全一致——文本翻译、文档翻译、语言检测。高级功能（如流式翻译、批量翻译）在各语言中的支持程度略有时间差：Python和Node.js最先获得新特性，Java和Go通常在1-2周内跟进，.NET周期稍长约3-4周。我们保持API签名在不同语言间尽可能相似，方便多语言团队协作。

模型文件怎么更新？需要重新下载整个文件吗？

目前模型采用全量更新策略，每次发布新版本需要重新下载完整文件。我们正在开发增量更新能力，通过模型权重的差分补丁实现小体积更新。对于生产环境，建议先在测试环境中拉取新模型验证效果，确认翻译质量符合预期后再更新线上服务。模型的历史版本会在CDN上保留至少6个月。

CLI工具支持在CI/CD流水线中使用吗？

CLI工具专门为自动化场景设计了非交互模式。设置环境变量TRANEASY_API_KEY后，所有命令在CI/CD中都能无头运行。退出码遵循标准约定——0表示成功，1表示翻译失败，2表示网络错误。JSON输出模式（--format json）方便你用jq等工具解析结果。GitHub Actions和GitLab CI的配置模板我们都准备了。

SDK有速率限制吗？高并发怎么处理？

免费账户的速率限制为每秒20次请求，企业账户最高可达每秒5000次。SDK内置了令牌桶限流器，超限时会自动排队等待而不是直接报错。对于真正的超大规模需求（每秒万次以上），我们建议通过Docker镜像进行私有化部署，那样完全不受云端限流的影响，只取决于你服务器的硬件配置。