API接入文档

API使用文档
使用文档

译云机器翻译开放API是中译语通面向广大开发者提供的专业翻译服务接口。您的网站或应用可通过译云机器翻译开放API为各种有翻译需求的用户提供多语种翻译服务。译云机器翻译开放API可免费连接中译语通的海量语料库及全球优质翻译资料,有效助力开发者,为用户带来高效及无障碍的优质跨语言阅读与应用体验。译云机器翻译开放API仅需传入源语言、目标语言及待翻译文本等少量参数,便可快速获得翻译结果。

译云机器翻译开放API数据接口地址:

http://api.yeekit.com/dotranslate.php

参数说明:

字段名 类型 必填参数 描述 备注
from TEXT Y源语言 见语言列表
to TEXT Y目标语言 见语言列表
app_kid TEXT YAPP ID 授权APP ID
app_key TEXT YAPP KEY 授权APP KEY
text TEXT Y待翻译文本 UTF-8编码

HTTP 请求模式为:POST

app_kid和app_key为开发者在API个人中心创建应用时,由系统后端自动产生的授权ID和KEY.

所有字段均为小写。

为保证翻译质量,请将单次请求长度控制在3000字符以内。

1.系统支持的文本编码为UTF-8格式。

2.在发送HTTP请求之前需要对待翻译文本作urlencode编码转换。

执行HTTP POST请求后,返回JSON格式数据:

{
    "translation": [
        {
            "translated": [
                {
                    "alignment-raw": [
                        {
                            "src-start": 0,
                            "tgt-start": 0,
                            "src-end": 0,
                            "tgt-end": 0
                        }
                    ],
                    "text": "China",
                    "rank": 0,
                    "tgt-tokenized": "China ",
                    "score": -0.8170589804649353,
                    "src-tokenized": "中国"
                }
            ],
            "translationId": "b68b0ab9f9ca44ce962b6d26a613eca6"
        }
    ]
}

返回参数说明:

参数名 类型 含义
TranslationListList翻译结果数组
Translated List List翻译结果
Alignment-rawListList返回对齐信息(可能不止一段对齐信息)
Src-startIntInteger源语言对齐信息开始
Tgt-startIntInteger目标语言对齐信息开始
Src-endIntInteger源语言对齐信息结束
Tgt-endIntInteger目标语言对齐结束
TextStringString翻译文本
RankIntInteger翻译排名0最高
Tgt-tokenizedStringString翻译文本分词后结果
scoreFloatFloat翻译概率
Src-tokenizedStringString待翻译文本分词结果
translationIdStringString翻译ID
错误码参照

当翻译结果无法正常返回时,请参考下表处理:

错误时,返回格式为: error:错误编码:错误描述

错误码 含义 解决方案
0 成功 成功
1 请求超时 重试
2 系统错误 重试
3 未授权用户 检查您的appid/appkey是否正确
4 必填参数为空 检查是否少传参数
5 访问频率受限 请降低您单位小时的调用频率
6 源语言不支持 检查源语言是否在语言列表里
7 目标语言不支持 检查目标语言是否在语言列表里
8 请求语言对不支持 请选择默认或授权的语言对
9 当前请求总字符超过当天最大流量限制 次日再发请求信息
10 请求长度过长 限定请求长度小于3000字符
语言列表

目前暂时只开放英语和中文的翻译:

语言简写 名称
en 英语
zh 中文简体

后续即将开放如下语种支持:

语言简写 名称
fr 法语
es 西班牙语
pt 葡萄牙语
de 德语
pl 波兰语
fi 芬兰语
zh_TW 中文繁体