易翻译API - 企业级翻译接口服务

为规模化集成而生

API设计的每一个细节，都来自我们和数百家企业客户长期磨合的经验。

🌐

RESTful标准接口

完全遵循RESTful设计规范，标准的JSON请求/响应格式，状态码语义明确。任何一个熟悉HTTP协议的开发者都能在几分钟内上手，无需翻阅冗长的文档。

⚡

实时翻译 + 批量处理

同步接口单次请求平均延迟低于80毫秒，适合聊天、客服等实时场景。异步批量接口支持一次提交最多10万条文本，48小时内回调结果，适合文档和数据库迁移。

📦

多语言SDK

提供Python、Java、JavaScript/TypeScript、Go、PHP五种官方SDK，覆盖绝大多数后端和前端技术栈。每个SDK都附带完整的单元测试和使用示例，代码仓库在GitHub上公开。

🔢

灵活计费模式

支持按字符数计费（后付费）和包月预付费两种模式。按量付费精确到千字符，用多少付多少；包月套餐包含固定字符池，超出部分自动切换按量计费，不会中断服务。

📊

用量监控与告警

控制台提供实时的API调用量、延迟分布和错误率监控面板。可以设置字符用量和QPS的阈值告警，通过邮件、短信或Webhook推送通知，避免因为额度不足导致业务中断。

🛡️

企业级安全保障

API Key + IP白名单双重认证，支持TLS 1.3加密传输。所有请求日志保留30天后自动清除，翻译内容处理完毕后不落盘持久化。SOC 2 Type II审计报告中可以查到完整的安全控制措施。

功能特性	免费版	入门版	专业版	企业版
月费	免费	¥199	¥799	定制报价
月翻译字符数	10万	200万	2000万	无限制
支持语种数	37+	37+	37+	37+
API速率限制	10次/分钟	300次/分钟	3000次/分钟	不限
批量异步翻译	—	✓	✓	✓
术语库	—	1000条	10000条	不限
领域优化	—	通用	通用+1个领域	通用+全部领域
技术支持	社区	邮件	在线7x24	专属客户经理
SLA保障	—	99.5%	99.9%	99.95%
	免费注册	开始试用	立即购买	联系我们

多语言代码示例

无论你的技术栈是什么，接进来只需要几行代码。

Python JavaScript Java cURL

// Python SDK - traneasy-sdk v2.1
from traneasy import Client

client = Client(api_key="te_api_xxxxxx")

// 单条翻译
result = client.translate(
    text="合同条款中的争议解决机制应当明确管辖法院。",
    source="zh",
    target="en",
    domain="legal"
)
print(result.translated_text)

// 批量翻译 - 异步模式
texts = [
    "第一条 合同双方",
    "第二条 标的物描述",
    "第三条 交付与验收"
]
batch = client.batch_translate(
    texts=texts,
    source="zh",
    target="en",
    callback_url="https://api.example.com/webhook"
)
print(f"Batch ID: {batch.batch_id}")

// 术语库管理
client.glossary.create(
    name="合同术语表",
    entries=[
        {"source": "标的物", "target": "subject matter"},
        {"source": "不可抗力", "target": "force majeure"}
    ]
)
        

集成方式

三种典型集成路径，适配不同规模和场景。

直接API集成

最轻量的方式，适合需要快速验证的团队。直接通过HTTP请求调用翻译端点，无需安装额外的库。

1. 注册并获取API Key
2. 在请求头中携带认证信息
3. 发送POST请求到翻译端点
4. 解析JSON响应获取译文

SDK集成

推荐大多数团队使用。SDK封装了认证、重试、连接池和错误处理逻辑，减少样板代码。

1. 通过包管理器安装SDK
2. 初始化Client并传入API Key
3. 调用SDK方法完成翻译
4. SDK自动处理重试和异常

中间件/代理层集成

适合大规模分布式系统。在企业网关或消息队列层面统一接入翻译能力，业务系统无需直接依赖外部API。

1. 部署翻译代理服务（Docker镜像提供）
2. 配置内部路由和认证策略
3. 业务系统通过内部域名访问
4. 代理层统一管理配额和监控

常见问题

API的认证机制是怎样的？

采用API Key + Bearer Token的认证方式。注册后可以在控制台生成一对Access Key和Secret Key。调用API时在HTTP Header中携带Bearer Token，Token通过Secret Key签名生成，有效期为2小时。对于对安全要求更高的场景，我们还支持IP白名单——可以限制只有来自指定IP段的请求才会被处理。所有认证相关的细节在开发者文档中有完整说明。

翻译字符数如何计算？中文字符算几个字符？

我们按Unicode码点计数——一个中文字、一个英文字母、一个标点符号都算作1个字符。空格和换行符也计入。这个规则对中文和英文都比较公平，不会出现"一个中文词被算成多个字符"的情况。唯一需要注意的是，emoji和某些特殊符号可能占用2个码点，会按2个字符计算。具体的计费粒度为千字符（向下取整），不足1000字符也按1000字符计。

批量翻译和实时翻译有什么区别？

实时翻译接口（sync）在200ms内返回结果，适合需要即时反馈的场景，如聊天消息翻译、搜索查询翻译。批量翻译接口（async）接受大批量文本的提交，以离线方式处理，通过回调或轮询获取结果。批量模式的优势是成本更低——同样数量的字符，批量模式的价格约为实时模式的60%。但它不适合需要即时响应的场景，因为处理时间取决于队列深度，通常在几分钟到几小时之间。

SDK支持哪些编程语言？

官方维护的SDK覆盖五种语言：Python（3.8+）、Java（11+）、JavaScript/TypeScript（Node.js 16+和浏览器）、Go（1.19+）、PHP（8.1+）。所有SDK都开源在GitHub上，欢迎社区贡献。如果你的技术栈不在上述列表中，RESTful接口本身是语言无关的——你可以直接用任何支持HTTP客户端的语言来调用。社区也为Rust、Ruby和C#贡献了非官方SDK，可以在各自的包管理器中找到。

API的可用性SLA如何保障？

专业版和企业版分别提供99.9%和99.95%的月度可用性SLA。这个数字是用"每月正常服务时间除以总时间"计算的，排除了计划内维护窗口（每月不超过2小时，提前48小时通知）。如果实际可用性低于承诺值，我们会按照未达标的时间比例折算成服务费抵扣。从运营记录来看，过去12个月的实际可用性为99.97%，远高于承诺指标。

如何处理翻译请求的并发和限流？

每个套餐都有对应的速率限制（见定价表格），超出限制的请求会返回429状态码。SDK内置了指数退避重试逻辑——遇到429时会自动等待后重试，不需要你在业务代码中手动处理。如果你的业务有短时高并发的需求（比如电商秒杀期间的批量商品翻译），可以提前联系我们将限流阈值临时调高。长期需要高并发的场景，建议升级到企业版（不限速）或部署私有节点。

术语库如何使用？能动态更新吗？

术语库通过API或控制台管理，支持CRUD操作。添加一条术语后大约30秒内生效——之后所有翻译请求会自动优先使用你指定的译法。术语支持精确匹配和模糊匹配两种模式：精确匹配要求原文完全一致才替换，模糊匹配可以覆盖原文的不同形态（如单复数、时态变化）。术语库更新不需要重启服务或重建索引，可以随时增删改。

超量使用后会发生什么？

对于按量付费的用户，超量部分直接按标准费率继续计费，不会中断服务，月底统一结算。对于包月套餐用户，超出套餐包含的字符池后，系统自动切换为按量付费模式，超量部分在当月账单中单独列出。如果你设置了消费告警，在额度消耗到80%和100%时会分别收到通知。我们不会在额度用完后直接停掉服务——这个设计是刻意为之，因为翻译API的中断可能会连锁影响你的业务。

一行代码接通全球37种语言