外观
海外文本翻译 API简介
概念解释
输入一段文本，根据指定模型和目标语种，返回翻译结果。
说明
Hi，您好，欢迎使用有道智云接口服务。
本文档主要针对需要集成HTTP API的技术开发工程师，详细描述接口计费，入参，返回值等信息。
如果您有与我们商务合作的需求，可以通过以下方式联系我们：
商务邮箱： AIcloud_Business@corp.youdao.com
如果您对文档内容有任何疑问，可以通过以下几种方式联系我们：
客服QQ：1906538062
AIGC产品技术交流群 ：837394306
联系邮箱： zhiyun@corp.youdao.com
温馨提示：
- 本文档主要针对开发人员，接入测试前需要获取应用ID和应用密钥，并创建应用；如果您还没有，请按照 新手指南 获取。
- 平台向每个账户赠送50元的体验金，供用户集成前测试所用。
协议须知
调用方在集成本接口时，请遵循以下规则。
| 规则 | 描述 |
|---|---|
| 传输方式 | HTTPS |
| 请求方式 | POST |
| 字符编码 | 统一使用 UTF-8 编码 |
| 请求格式 | application/x-www-form-urlencoded |
| 响应格式 | application/json |
接口定义
任务提交接口：
https://wpsapi.youdao.com/proxy/http/text-trans
请求参数
| 参数名称 | 类型 | 含义 | 是否必填 | 示例或描述 |
|---|---|---|---|---|
| appKey | string | 应用ID | 是 | |
| salt | string | 随机值 | 是 | |
| curtime | string | 时间戳（单位到秒） | 是 | 例如：1757560399 |
| sign | string | 签名 | 是 | 参见下方的签名生成方法 |
| q | string | 待翻译文本 | 是 | 必须是UTF-8编码 |
| from | string | 源语言 | 是 | 参考下方支持语言 |
| to | string | 目标语言 | 是 | 参考下方支持语言 |
签名生成方法如下(v3)
sign=sha256(appKey+input+salt+curtime+应用密钥)；
其中，
1. 当 q 参数长度小于等于20时，input=q;
2. 当 q 参数长度大于20时，input= q的前10个字符 + q的长度 + q后10个字符；支持语言
| 中文名称 | 语种名称 | 语言代码 | 非常见语种 | 常见语种 |
|---|---|---|---|---|
| 西班牙语 | Spanish | es | Y | |
| 葡萄牙语 | Portuguese | pt | Y | |
| 英语 | English | en | Y | |
| 波兰语 | Polish | pl | Y | |
| 意大利语 | Italian | it | Y | |
| 简体中文 | Chinese(Simplified) | zh-CHS | Y | |
| 法语 | French | fr | Y | |
| 罗马尼亚语 | Romanian | ro | Y | |
| 德语 | German | de | Y | |
| 阿拉伯语 | Arabic | ar | Y | |
| 日语 | Japanese | ja | Y | |
| 印地语 | Hindi | hi | Y | |
| 孟加拉语 | Bangla | bn | Y | |
| 卡纳达语 | Kannada | kn | Y | |
| 马拉雅拉姆语 | Malayalam | ml | Y | |
| 马拉地语 | Marathi | mr | Y | |
| 泰米尔语 | Tamil | ta | Y | |
| 泰卢固语 | Telugu | te | Y | |
| 荷兰语 | Dutch | nl | Y | |
| 斯洛伐克语 | Slovak | sk | Y | |
| 保加利亚语 | Bulgarian | bg | Y | |
| 乌克兰语 | Ukrainian | uk | Y | |
| 捷克语 | Czech | cs | Y | |
| 塞尔维亚语(西里尔文) | Serbian (Cyrillic) | sr-Cyrl | Y | |
| 塞尔维亚语(拉丁文) | Serbian (Latin) | sr-Latn | Y | |
| 瑞典语 | Swedish | sv | Y | |
| 丹麦语 | Danish | da | Y | |
| 芬兰语 | Finnish | fi | Y | |
| 繁体中文 | Chinese (Traditional) | zh-CHT | Y | |
| 泰语 | Thai | th | Y | |
| 克罗地亚语 | Croatian | hr | Y | |
| 俄语 | Russian | ru | Y | |
| 韩语 | Korean | ko | Y | |
| 印尼语 | Indonesian | id | Y | |
| 乌尔都语 | Urdu | ur | Y | |
| 越南语 | Vietnamese | vi | Y |
- 常见语种与非常见语种互译，按照非常见语种收费.
响应结果
响应结果中会包含多条如下结果的消息，直到翻译结束
| 字段 | 类型 | 含义 |
|---|---|---|
| code | String | 状态码，参见最下方的状态码表 |
| message | String | 状态信息 |
| requestId | String | 本次请求唯一标识 |
| successful | boolean | 本条消息是否成功 |
| data | Object | 翻译结果 |
| data.translation | String[] | 翻译结果数组 |
| data.from | String | 源语种 |
| data.to | String | 目标语种 |
返回示例
json
{
"code": "0",
"message": "success",
"data": {
"translation": [
"مرحباً بعالمي"
],
"from": "ru",
"to": "ar"
},
"requestId": "1765361847100-841940982066791-871",
"successful": true
}curl调用示例
curl --location --request POST 'http://127.0.0.1:8686/http/text-trans' \
--header 'Accept: */*' \
--header 'Connection: keep-alive' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'appKey=<应用ID>' \
--data-urlencode 'salt=09d703a3-e79d-41b9-ab92-2a19f9426cec' \
--data-urlencode 'sign=bb4fd84778729312260101d0c43ce092516475337dbd7797f95b127982ea49e2' \
--data-urlencode 'curtime=1765275884' \
--data-urlencode 'q=Привет, мой мир' \
--data-urlencode 'from=ru' \
--data-urlencode 'to=vi'API 状态码列表
| 状态码 | 状态码含义 |
|---|---|
| 0 | 成功 |
| 1 | 未知错误，请联系客服 |
| 101 | 缺少必填的参数，首先确保必填参数齐全，然后，确认参数书写是否正确。 |
| 108 | 应用ID无效，注册账号，登录后台创建应用并完成绑定，可获得应用ID和应用密钥等信息 |
| 110 | 当前应用ID没有权限访问此服务，需要在控制台给当前应用ID开通此服务 |
| 112 | 请求的服务不存在 |
| 202 | 签名检验失败 |
| 206 | 因为时间戳无效导致签名校验失败 |
| 207 | 重放请求 |
| 902010 | 文本翻译调用失败 |
常用语言 Demo
Java 示例
暂无
python3 示例
暂无
go 示例
暂无