帮助与文档 > 产品文档 > 自然语言翻译 > API文档 > 富文本翻译服务
富文本翻译服务

富文本翻译 API 简介

概念解释

富文本翻译:可对网页html标签自动识别,翻译所需内容。

说明

Hi,您好,欢迎使用有道智云富文本翻译API接口服务。

本文档主要针对需要集成HTTP API的技术开发工程师,详细描述富文本翻译能力相关的技术内容。

如果您有与我们商务合作的需求,可以通过以下方式联系我们:

商务邮箱: AIcloud_Business@corp.youdao.com

如果您对文档内容有任何疑问,可以通过以下几种方式联系我们:

客服QQ:1906538062

智云翻译技术交流QQ 1群: 652880659

智云翻译技术交流QQ 2群: 669384425

智云翻译技术交流QQ 3群: 807539209

智云翻译技术交流QQ 4群: 936752411

联系邮箱: zhiyun@corp.youdao.com

温馨提示:

  • 本文档主要针对开发人员,接入测试前需要获取 应用ID应用密钥 ,并绑定实例;如果您还没有,请按照 新手指南 获取。
  • 平台向每个账户赠送50元的体验金,供用户集成前测试所用,具体资费规则详见 富文本翻译服务报价

接口说明

富文本翻译API接口提供有道的翻译服务,可对网页html标签自动识别,翻译所需内容,目前支持中英、中日、中韩双向共6个语言方向。

富文本翻译API HTTPS地址:

https://openapi.youdao.com/translate_html

协议须知

调用方在集成富文本翻译API时,请遵循以下规则。

规则描述
传输方式HTTPS
请求方式GET/POST
字符编码统一使用UTF-8 编码
请求格式表单
响应格式JSON

接口调用参数

调用API需要向接口发送以下字段来访问服务。

字段名类型含义必填备注
qtext待翻译文本True必须是UTF-8编码
fromtext源语言True参考下方 支持语言 (可设置为auto)
totext目标语言True参考下方 支持语言
appKeytext应用IDTrue可在 应用管理 查看
salttextUUIDTrueuuid,唯一通用识别码
signtext签名Truesha256(应用ID+input+salt+curtime+应用密钥)
signTypetext签名类型Truev3
curtimetext当前UTC时间戳(秒)trueTimeStamp

签名生成方法如下:
signType=v3;
sign=sha256(应用ID+input+salt+curtime+应用密钥);
其中,input的计算方式为:input=q前10个字符 + q长度 + q后10个字符(当q长度大于20)或 input=q字符串(当q长度小于等于20);

注意:

  1. 接口salt+curtime来防重放(即一个请求不可以被请求2次),所以salt最好为UUID。

不同语言获取时间戳,请参看此链接

如果对签名有疑问,可以参看各语言demo。

输出结果

正常返回

字段名含义
data翻译结果
errorCode错误码
errorMessage成功信息

异常返回

字段名含义
errorCode错误码
errorMessage错误信息

支持语言

下表为各语言对应代码:

语言代码
中文zh-CHS
英文en
日文ja
韩文ko
自动识别auto

错误代码列表

错误码含义
0请求成功
101缺少必填的参数,首先确保必填参数齐全,然后确认参数书写是否正确。
303服务内部错误
405鉴权失败
411访问频率受限,请稍后重试
500翻译失败,请参考errorMessage

errorMessage说明:

错误码含义
11不支持的语言方向
12输入的html文本超过长度限制
14不支持的翻译内容
30翻译失败

常用语言 Demo

可参考文本翻译服务示例demo