聚合翻译aggregate-translate

聚合 DeepL / 腾讯 / 有道三大引擎的多语言翻译，可指定单一引擎或自动选优；支持 platform=all 模式同时返回所有引擎结果用于对比。三个 action：translate（翻译，默认）/ engines（引擎列表）/ languages（语言列表）。支持 12 种语言互译。

1. 基本信息

接口地址	`https://v1.apizero.cn/api/aggregate-translate`
请求方法	`POST`
分类	life
提供方	极数本源
计费模式	免费试用
单次消耗	0 积分
起步价	—
QPS 限制	2 req/s
每日免费额度	50 次（已认证用户）
匿名每日额度	20 次（无 API Key）
VIP 免费	否
调用次数

2. 认证

匿名可调用：QPS 1 / 每日 20 次。登录用户：QPS 2 / 每日 50 次。多引擎对比模式（platform=all）每次消耗 4 倍上游资源。

获取 API Key：登录 https://apizero.cn/account/keys

3. 请求参数

参数名	类型	必填	说明	示例
`action`	`string`	否	translate（默认）/ engines / languages	—
`text`	`string`	是	translate 必填；待翻译文本（≤ 5000 字）	`Hello world`
`source_lang`	`string`	否	源语言；auto/zh/en/ja/ko/fr/de/es/pt/it/ru/pl/nl，默认 auto；别名 from	—
`target_lang`	`string`	否	目标语言；同上但不允许 auto，默认 en；别名 to	—
`engine`	`string`	否	指定引擎：deepl / tencent / youdao；留空则自动选优	—
`platform`	`string`	否	设为 all 则同时调用所有引擎返回对比结果（alternatives 字段）	—

4. 请求头

Header	类型	必填	说明	示例
`Authorization`	`string`	否	—	—

5. 请求示例 (cURL)

curl -X POST "https://v1.apizero.cn/api/aggregate-translate" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "action": "<action>",
  "text": "Hello world",
  "source_lang": "<source_lang>",
  "target_lang": "<target_lang>",
  "engine": "<engine>",
  "platform": "<platform>"
}'

6. 响应字段

字段	类型	说明	示例
`result.text`	`string`	翻译后文本	—
`result.source_lang`	`string`	识别 / 输入的源语言	—
`result.target_lang`	`string`	目标语言	—
`result.engine`	`string`	实际使用的引擎	—
`alternatives`	`array`	platform=all 模式下其他引擎结果（同 result 结构数组）	—

7. 响应示例

{
    "code": 0,
    "msg": "成功",
    "data": {
        "result": {
            "text": "你好，世界",
            "source_lang": "en",
            "target_lang": "zh",
            "engine": "deepl"
        },
        "alternatives": null
    },
    "request_id": "abc123"
}

8. 错误码

code	status	说明
`4000`	`—`	text 缺失 / 超长 / 语言码非法 / source==target / engine 不支持
`4029`	`—`	调用过快（QPS 超限）
`4030`	`—`	今日额度用完
`5020`	`—`	上游 Python 服务异常 / 全部引擎都失败

9. 变更日志

1.0.0(2026-05-10)
- 首次上线，支持 deepl / tencent / youdao 三引擎自动选优 + platform=all 多引擎对比