文本批量安全翻译

翻译简介

简要描述

• 支持大文本翻译与文件翻译处理；
• 支持 15 家翻译服务商对比翻译；
• 自动判别各种语种并翻译，100 万之内免费调用

请求 URL

https://api.catooilg.com/dataspace/tasks/xtranslate

请求方式

• POST

Header

统一接口请求 Token：https://api.catooilg.com/dataspace/tasks/getToken GET

Header	必选	类型	说明
accessToken	是	String	Token 鉴权，有效期为 3600sec

请求参数

参数名	必选	类型	说明
canvasId	是	Number	翻译服务商，具体如下

1: 彩云翻译
2: 小牛翻译
3: Youdao
4: Yandex(维护中)
5: Sougou(已下线)
6: Baidu
7: Microsoft Azure
8: Tencent
9: IBM
10: Google
11: Amazon AWS
12: Aliyun
13: 同花顺
14: 火山引擎
15: Deepl |
| source | 是 | String | 待翻译的文本 |
| file | 否 | File | 待翻译的文件(仅支持 TXT 文件) |

返回示例

{ “msg”: “success”, “code”: 200, “ResultObj”: { “isdict”: 0, “rc”: 0, “confidence”: 0.8, “target”: “这种屠杀是毫无意义的，因为它不能影响战争的结果。桑儿是一个杰出的战术家，穿着他辉煌的胜利服装。但我们需要的是堂-科利昂的战略天才。整个事件堕落成这样一场致命的游击战，双方都发现自己失去了大量的收入和生活毫无意义。柯里昂家族最终被迫关闭了一些最赚钱的赌马站，其中包括送给女婿卡洛 · 里奇谋生的那本书。卡罗和合唱团的姑娘们一起喝酒，跑来跑去，使他的妻子康妮很为难。自从他被桑儿打了以后，他就不敢再打他的妻子了，但是他没有和她睡觉。康妮扑倒在他的脚下，他象罗马人一样，带着高雅的贵族的喜悦，拒绝了她。他嘲笑她说: “去给你哥哥打电话，告诉他我不会欺负你，也许他会打我，直到我硬起来。”” } }

返回参数说明

参数名	类型	说明
msg	String	错误信息
code	String	错误代码
ResultObj	String	返回结果

---

自申接口设置

1 - 彩云小译

登陆/注册彩云小译
开通彩云小译 API，填写资料妥当人工审核 1-2 天获取 token 即可。

对接文档：

仅供参考，请以翻译供应商最新官方文档为准。
https://open.caiyunapp.com/五分钟学会彩云小译_API

收费相关：

每月翻译 100 万字之内都是免费的，如果您每月超过 100 万字，我们会按照 20 元 / 100 万字 的费率收费。

翻译入参：

统一接口请求域名：http://api.interpreter.caiyunai.com/v1/translator POST

参数名称	类型	描述
token	String	通过后获得的翻译权杖 token
测试 token:3975l6lr5pcbvidl6jl2
Source	String	待翻译的文本列表
trans_type	String	匹配源语种

en2zh: 英文 -> 中文
ja2zh: 日文 -> 中文
zh2en: 中文 -> 英文
zh2ja: 中文 -> 日文 |

附：
在线调用

---

2 - 小牛翻译云

登陆/注册小牛翻译云
打开控制台，点击个人中心即可获得 API_KEY

对接文档：

仅供参考，请以翻译供应商最新官方文档为准。
https://niutrans.com/documents/contents/trans_text#accessMode

收费相关：

每月 100 万字符免费额度，超过 100 万字符，不购买流量包则按照 59 元/百万字符支付当月超出部分字符量费用，流量包价格梯度有 500/2000/3000 元分别对应 1000 万/5000 万/10000 万字符，不可自定义。
注意，目前小牛完成升级 V7.0 版本，将关闭免费 API 服务，老用户可继续使用免费接口至 2021 年 12 月 31 日，具体规则浏览官网。
新增公众号打卡获取流量规则：

当月连续签到	1 天	3 天	7 天	14 天	30 天
获得字符流量	10 万	50 万	100 万	500 万	1000 万

翻译入参：

统一接口请求域名：https://api.niutrans.com/NiuTransServer/translation POST/GET
对接文档：https://niutrans.com/documents/contents/trans_text#accessMode

参数名称	类型	描述
apikey	String	API 密钥
from	String	文本翻译支持 299 种语言两两互译，具体代码查看
to	String	无匹配源语种，支持两两互翻译
src_text
待翻译的文本（UTF-8 编码）

附：
在线调用

---

3 - 有道翻译

登陆/注册有道智云（网易云）
创建应用，在创建选择接入方式为 API，然后创建实例，在自然语言翻译服务下文本翻译创建，绑定刚刚创建的应用，即可获得”应用 ID” 和 “应用密钥”。

对接文档：

仅供参考，请以翻译供应商最新官方文档为准。
https://ai.youdao.com/doc.s#guide

收费相关：

注册赠送 50 现金，中文与常见语种（越南语、英语、印度尼西亚语、意大利语、西班牙语、日语、葡萄牙语、韩语、法语、俄语、德语、阿拉伯语、泰语）互译 48 元/100 万字符，使用即扣费，中文与非常见语种互译 100 元/100 万字符。

翻译入参：

统一接口请求域名：https://openapi.youdao.com/api POST

参数名称	类型	描述
appKey	String	百度开发者信息的 APP ID
salt	String	random 随机数，可 UUID
signType	String	v3
curtime	String	当前 UTC 时间戳，如何在不同编程语言中获取现在的 Unix 时间戳(Unix timestamp)
from	String	文本翻译支持 111 种语言两两互译，具体代码查看

常见语种如下：
en：英语
vi：越南语
id：印度尼西亚语
it：意大利语
es：西班牙语
ja：日语
pt：葡萄牙语
ko：韩语
fr：法语
ru：俄语
de：德语
ar：阿拉伯语 |
| to | String | 无匹配源语种，支持两两互翻译 |
| sign | String | 签名，sha256(应用 ID+input+salt+curtime+应用密钥，其中，input 的计算方式为：input=q 前 10 个字符 + q 长度 + q 后 10 个字符（当 q 长度大于 20）或 input=q 字符串（当 q 长度小于等于 20）) |
| q |
| 待翻译的文本（UTF-8 编码） |

附：
在线调用

---

4 - Yandex

登陆/注册Yandex(和邮箱服务互通)
进入打开 Developers 进入个人开发者信息，创建 API keys -> Create a new Key 即可获得 API Keys

对接文档：

仅供参考，请以翻译供应商最新官方文档为准。
https://yandex.com/dev/translate/doc/dg/reference/translate.html

收费相关：

俄罗斯翻译商，全程收费，按 15USD/100 万字符计算。
具体收费标准请查看：https://translate.yandex.com/developers/prices

附：
在线调用

---

5 - 搜狗翻译(已下线)

登陆/注册搜狗深智引擎（不与搜狗输入法互通）
选择机器翻译 -> 文本翻译，点击获取 PID&KEY

收费相关：

注册赠送 100 现金，中文与常见语种互译 40 元/100 万字符，中文与非常见语种互译 60 元/100 万字符。

翻译入参：

统一接口请求域名：http://fanyi.sogou.com/reventondc/api/sogouTranslate POST
对接文档：https://deepi.sogou.com/doccenter/texttranslatedoc?fr=process

参数名称	类型	描述
pid	String	服务 id
salt	String	random 随机数，可 UUID
from	String	文本翻译支持 61 种语言两两互译，具体代码查看

常见语种如下：
zh-CHS：中文
en：英语
ja：日语
ko：韩语
fr：法语
de：德语
ru：俄语
es：西班牙语
ar：阿拉伯语
it：意大利语
pt：葡萄牙语
cs：捷克语
pl：波兰语
hu：匈牙利语
nl：荷兰语
sv：瑞典语
da：丹麦语
fi：芬兰语
tr：土耳其语
vi：越南语 se
th：泰语 |
| to | String | 无匹配源语种，支持两两互翻译 |
| sign | String | 签名，md5(pid+q+salt+用户密钥)，其中 pid、q、salt、用户密钥参数去除了首尾空格 |
| q |
| 待翻译的文本（UTF-8 编码） |

附：
在线调用

---

6 - 百度翻译

登陆/注册百度
开通通用翻译 API，资料填写，秒批审核即获得开发者信息（APP ID 以及 密钥）

对接文档：

仅供参考，请以翻译供应商最新官方文档为准。
https://fanyi-api.baidu.com/product/11

收费相关：

每月 200 万字符免费额度，超过 200 万字符，按照 49 元/百万字符支付当月超出部分字符量费用。
区分标准版、高级版和尊享版，之间区别在于 QPS（每秒请求数）翻译速度。

翻译入参：

统一接口请求域名：https://fanyi-api.baidu.com/api/trans/vip/translate POST

参数名称	类型	描述
appid	String	百度开发者信息的 APP ID
salt	String	random 随机数，可 UUID
from	String	文本翻译支持 201 种语言两两互译，具体代码查看

基础语种如下：
zh：简体中文
cht：繁体中文
en：英语
de：德语
jp：日语
kor：韩语
fra：法语
spa：西班牙语
th：泰语
ara：阿拉伯语
ru：俄语
pt：葡萄牙语
it：意大利语
el：希腊语
nl：荷兰语
pl：波兰语
bul：保加利亚语
est：爱沙尼亚语
dan：丹麦语
fin：芬兰语
cs：捷克语
rom：罗马尼亚语
slo：斯洛文尼亚语
swe：瑞典语
hu：匈牙利语
vie：越南语 |
| to | String | 无匹配源语种，支持两两互翻译 |
| sign | String | 签名，appid+q+salt+密钥的 MD5 值（需要生成的签名长度为 32 位 MD5 码，签名中的英文字符均为小写格式，且注意去空格） |
| q |
| 待翻译的文本（UTF-8 编码） |

附：
在线调用

---

7 - Microsoft Azure

登陆/注册Microsoft Azure
My account -> Azure Portal -> Create a resource 添加 Translator Text
建立 Translator Text 有一点需要注意，Region 需要选择 Global(全域),订阅账号默认 Pay-As-You-Go 即可。
开通后获取 Keys and Endpoint(金轮和端点)其中 Key1 就是请求需要的。

收费相关：

每月免费 200 万个字符，超出按 10USD/100 万字符计算。
具体收费标准请查看：https://azure.microsoft.com/zh-cn/pricing/details/cognitive-services/translator/
接入的是文字翻译，而非文件翻译。

翻译入参：

对接文档：https://docs.microsoft.com/zh-tw/azure/cognitive-services/translator/quickstart-translator?WT.mc_id=Portal-Microsoft_Azure_ProjectOxford&tabs=csharp
支持语种：https://docs.microsoft.com/zh-tw/azure/cognitive-services/translator/language-support

---

8 - 阿里云翻译

登陆/注册阿里云
启用机器翻译的 API，看到需购买资源包通用翻译引擎即开通成功。
惯例点击 RAM 访问控制配置一个子账户，授权拥有机器翻译的所有权限，然后获取子账户的 AccessKey ID 和 AccessKey Secret.查阅如何授权子账户。

对接文档：

仅供参考，请以翻译供应商最新官方文档为准。
https://help.aliyun.com/document_detail/158244.html

收费相关：

注意区分通用版与专业版，均为每月 100 万字符免费额度，超出则按通用 50 元/100 万，专业 60 元/100 万字符收费，接受资源包套餐，且可自定义资源包字符量。
建议使用通用版翻译引擎，这里不指向文档翻译。

翻译入参：

参数名称	类型	描述
accessKeyId	String	阿里云账号的 AccessKey ID
accessKeySecret	String	阿里云账号 Access Key Secret
SourceLanguage	String	文本翻译支持 214 种语言两两互译，具体代码查看

基础语种如下：
zh：简体中文
en：英语
ja：日语
ko：韩语
es：西班牙语
fr：法语
pt：葡萄牙语
it：意大利语
ru：俄语
ar：阿拉伯语
tr：土耳其语
th：泰语
id：印尼语
vi：越南语
ms：马来语
he：希伯来语
hi：印地语
pi：波兰语
ni：荷兰语
de：德语 |
| TargetLanguage | String | 无匹配源语种，支持两两互翻译 |
| Scene | String | general |
| SourceText |
| 待翻译的文本 |

附：
在线调用

---

9 - 腾讯翻译君

登陆/注册腾讯云
启用机器翻译 TMT 的 API，于控制台看到文本翻译数据中台即开通成功。
由于调用 API 翻译使用的不是独立的 Secret 和 token 为了安全起见建议自己去 RAM 开设多一个子账户，仅授权使用该翻译 API 其设置路径为访问管理 -> 用户 -> 用户列表

对接文档：

仅供参考，请以翻译供应商最新官方文档为准。
https://cloud.tencent.com/document/product/551

收费相关：

文本翻译的每月免费额度为 500 万字符，免费额度每月 1 日 0 点重置，如果 500 万-10000 万收费 58 元/每 100 万字符，如果大于 10000 万则收费 50 元/每 100 万字符。（1 个汉字、1 个字母、1 个标点或空格都计为 1 个字符）

附：
在线调用

---

10 - IBM

登陆/注册IBM
服务全称名为：IBM Watson Language Translator，进入 IBM Cloud 控制台，开通 Language Lite 服务，即可在面板看到金轮 Key

对接文档：

仅供参考，请以翻译供应商最新官方文档为准。
https://cloud.ibm.com/apidocs/language-translator#listlanguages

收费相关：

每月免费 100 万个字符，超出按 20USD/100 万字符计算。
具体收费标准请查看：https://www.ibm.com/cn-zh/cloud/watson-language-translator/pricing

附：
在线调用

---

11 - Google

登陆/注册Google
先在 Header 头部搜索框搜索 Cloud Translation API 启用该 API，然后获取 API Key 即可。
【目前注册 Google 不可使用国内手机号码，请使用 Email 注册】

对接文档：

仅供参考，请以翻译供应商最新官方文档为准。
https://cloud.google.com/translate/docs/advanced/quickstart?hl=zh_CN

收费相关：

基于 Cloud Translation 基本版 (v2)每月 50 万字符，使用的是 10USD 赠金抵扣，超出按 20USD/100 万字符计算
具体收费标准请查看：https://cloud.google.com/translate/pricing?hl=zh-cn

附：
在线调用

---

12 - Amazon AWS

登陆/注册Amazon(不与国内亚马逊账号互通)
登陆后选择 IAM，创建一个使用者授权含翻译所有权限(TranslateFullAccess、AmazonElasticTranscoder_FullAccess、AmazonTranscribeFullAccess、AWSTransferLoggingAccess、AmazonElasticTranscoder_JobsSubmitter、AWSTransferFullAccess、 AWSTransferConsoleFullAccess)最后拿到 Access Key 和 Secret
注意另存为 csv 文件，一次性显示。
【目前注册账号需要双币信用卡】

对接文档：

仅供参考，请以翻译供应商最新官方文档为准。
https://docs.aws.amazon.com/zh_cn/translate/latest/dg/examples-java.html
支持语种：https://cloud.ibm.com/docs/language-translator?topic=language-translator-translation-models

收费相关：

每月免费 200 万个字符（严格遵循 Free Tier）超过则按 15USD/100 万字符收费。
具体收费标准请查看：https://aws.amazon.com/cn/translate/pricing/?nc1=h_ls

附：
在线调用

---

13 - 同花顺

登陆/注册同花顺 AI 开放平台个人开发者账号
创建应用，填写应用名称以及应用描述，开通机器翻译下文本翻译获取 Appid 和 AppKey 即可完成创建。

对接文档：

仅供参考，请以翻译供应商最新官方文档为准。
http://www.aicubes.cn/api/public/docCenter.html#source=machineTranslationDoc

收费相关：

限时免费，收费另作公告。

附：
在线调用

---

14 - 火山引擎

登陆/注册火山账号（与头条/抖音互通）
使用银行卡号和身份证号完成实名认证，开通机器翻译，使用访问控制新增用户分配子账号关联翻译策略（TranslateFullAccess 和 I18nTranslateFullAccess）即可。

对接文档：

仅供参考，请以翻译供应商最新官方文档为准。
https://www.volcengine.com/docs/4640/65067

收费相关：

每月免费 200 万个字符，免费额度每月 1 日 0 点重置，超出按 49 元/100 万字符计算。
具体收费标准请查看：https://www.volcengine.com/docs/4640/68515

附：
在线调用

---

译云

登陆/注册译云
登陆个人中心即可获得 APP ID 以及密钥。
【目前暂停申请接入译云机器翻译开放 API】

收费相关：

申报学术用途，免费。
每小时 1000 次免费访问，超过访问次数后会进行封禁暂停服务，1 小时后会自然恢复。

翻译入参：

统一接口请求域名：http://api.yeekit.com/dotranslate.php POST
对接文档：https://api.yeekit.com/mannual.php#docs

参数名称	类型	描述
app_kid	String	授权 APP ID
app_key	String	授权 APP KEY(密钥)
from	String	只开放英语和中文的翻译，其他芬兰语等语种邮箱联系support@yeekit.com开通

zh：中文简体
en：英文 |
| to | String | 同上 |
| text |
| 待翻译的文本（UTF-8 编码） |

附：
在线调用
人工翻译

---

Deepl

登陆/注册Deepl
注意注册需要欧洲信用卡，且选择角色为 DeepL API Free

示例 Demo：

from enum import Enum, auto as auto_rename
import requests

DEEPL_API = "https://deepl.vercel.app/translate"


class TranslateError(Exception):
    pass


class ParamInvalidError(TranslateError):
    pass


class AutoName(Enum):
    def _generate_next_value_(name, start, count, last_values):
        return name


class Lang(AutoName):
    auto = auto_rename()
    DE = auto_rename()
    EN = auto_rename()
    ES = auto_rename()
    FR = auto_rename()
    IT = auto_rename()
    JA = auto_rename()
    NL = auto_rename()
    PL = auto_rename()
    PT = auto_rename()
    RU = auto_rename()
    ZH = auto_rename()
    BG = auto_rename()
    CS = auto_rename()
    DA = auto_rename()
    EL = auto_rename()
    ET = auto_rename()
    FI = auto_rename()
    HU = auto_rename()
    LT = auto_rename()
    LV = auto_rename()
    RO = auto_rename()
    SK = auto_rename()
    SL = auto_rename()
    SV = auto_rename()


def prepare_for_serialization(obj: dict):
    serialized_dict = dict()
    for k, v in obj.items():
        serialized_dict[k] = v.name if isinstance(v, Enum) else v
    return serialized_dict


def translate(text: str, target_lang: Lang, source_lang: Lang):
    if target_lang is Lang.auto:
        raise ParamInvalidError
    resp = requests.post(
        DEEPL_API,
        json=prepare_for_serialization({
            "text": text,
            "target_lang": target_lang,
            "source_lang": source_lang
        })
    )
    if resp.status_code != 200:
        raise TranslateError
    result = resp.json()
    return result


if __name__ == '__main__':
    print(translate(
        text="Hello World!",
        source_lang=Lang.auto,
        target_lang=Lang.ZH
    ))

附：
在线调用

---

免责声明及其他

收费一览，如表所示。

名字	类型	QPS	具体价格	备注
1.彩云小译	免费+收费		20RMB/100 万字符	免费额度 100 万/月
2.小牛翻译云	收费	50(5k)	59RMB/100 万字符	打卡额度
3.有道翻译	收费	(5k)	48&100RMB/100 万字符	50 元现金注册赠送
4.Yandex	收费		15USD/100 万字符	全程收费
5.搜狗	收费	50	40&60RMB/100 万字符	100 元现金注册赠送
6.百度	免费+收费	1	49USD/100 万字符	免费额度 200 万/月
7.Microsoft Azure	免费+收费		10USD/100 万字符	免费额度 200 万/月
8.阿里云	免费+收费	50(5k)	50RMB/100 万字符	免费额度 100 万/月
9.腾讯云	免费+收费	5(2k)	58RMB/100 万字符	免费额度 500 万/月
10.IBM	免费+收费		20USD/100 万字符	免费额度 100 万/月
11.Google	免费+收费		20USD/100 万字符	免费额度 50 万/月(赠金)
12.Amazon AWS	免费+收费		15USD/100 万字符	免费额度 200 万/月
13.同花顺	免费	(5k)		免费
14.火山引擎	免费+收费	(5k)	49RMB/100 万字符	免费额度 200 万/月
15.Deepl	收费			需欧洲属地信用卡开通
16.译云	免费
免费