对外域名 https://tr.tranzella.com · 端口 12345(直连备用) · 接口前缀 /translate-api · 版本 1.0.0 · 服务运行于新加坡节点,代理 Google Cloud Translation v2
| 方法 | 路径 | 说明 |
|---|---|---|
| POST / GET | /translate-api/translate | 翻译。源语言为空或 auto 时,先调用谷歌识别语种再翻译 |
| POST / GET | /translate-api/detect | 仅识别语种 |
| POST / GET | /translate-api/token | 用客户端凭据(clientId + clientSecret)申请 accessToken |
| POST / GET | /translate-api/token/refresh | 用 refreshToken 续期,返回新 accessToken(旧令牌立即作废) |
| POST / GET | /translate-api/token/introspect | 查询 TOKEN 是否有效、剩余时间、调用次数 |
| POST / GET | /translate-api/token/revoke | 主动吊销 TOKEN |
| GET | /translate-api/health | 健康检查(无需 TOKEN) |
accessToken 有效期 3 天,refreshToken 有效期 7 天。到期前用 refreshToken 换新(一次性轮换,旧 accessToken 立即失效),客户端可自行定时执行。
# 1) 申请
curl -s -X POST "https://tr.tranzella.com/translate-api/token" \
-H "Content-Type: application/json" \
-d '{"clientId":"cn-server","clientSecret":"<CLIENT_SECRET>","ttlSeconds":259200}'
# => {"ok":true,"accessToken":"gtk_...","expiresAt":"...","refreshToken":"gtr_..."}
# 2) 到期前续期(建议每 2 天一次,且不晚于第 7 天)
curl -s -X POST "https://tr.tranzella.com/translate-api/token/refresh" \
-H "Content-Type: application/json" \
-d '{"refreshToken":"gtr_..."}'
| 字段 | 必填 | 说明 |
|---|---|---|
token | 是 | 访问令牌。也可放在 Header:Authorization: Bearer <TOKEN> 或 X-Api-Token: <TOKEN> |
text | 是 | 待翻译文本(最长 5000 字符) |
source | 否 | 源语言,如 en;留空 / auto 则自动识别 |
target | 是 | 目标语言,如 zh-CN、en、ja |
format | 否 | text(默认)或 html |
curl -s -X POST "https://tr.tranzella.com/translate-api/translate" \
-H "Content-Type: application/json" \
-d '{
"token": "你的 TOKEN",
"text": "Hello world",
"source": "",
"target": "zh-CN"
}'
也可直连端口(HTTP,需安全组放行):http://43.159.49.146:12345/translate-api/translate
{
"ok": true,
"translatedText": "你好世界",
"source": "en",
"sourceDetected": true,
"target": "zh-CN",
"tookMs": 186
}