外观
语种识别简介
概念解释
输入一段文本，识别出文本的语种。
说明
Hi，您好，欢迎使用有道智云接口服务。
本文档主要针对需要集成HTTP API的技术开发工程师，详细描述接口计费，入参，返回值等信息。
如果您有与我们商务合作的需求，可以通过以下方式联系我们：
商务邮箱： AIcloud_Business@corp.youdao.com
如果您对文档内容有任何疑问，可以通过以下几种方式联系我们：
客服QQ：1906538062
AIGC产品技术交流群 ：837394306
联系邮箱： zhiyun@corp.youdao.com
温馨提示：
- 本文档主要针对开发人员，接入测试前需要获取应用ID和应用密钥，并创建应用；如果您还没有，请按照 新手指南 获取。
- 平台向每个账户赠送50元的体验金，供用户集成前测试所用。
协议须知
调用方在集成本接口时，请遵循以下规则。
| 规则 | 描述 |
|---|---|
| 传输方式 | HTTPS |
| 请求方式 | POST 或 GET |
| 字符编码 | 统一使用UTF-8 编码 |
| 请求格式 | application/x-www-form-urlencoded 或 query parameters |
| 响应格式 | application/json |
接口定义
任务提交接口：
https://openapi.youdao.com/v1/detect
请求参数
| 参数名称 | 类型 | 含义 | 是否必填 | 示例或描述 |
|---|---|---|---|---|
| appKey | string | 应用ID | 是 | |
| salt | string | 随机值 | 是 | |
| curtime | string | 时间戳（单位到秒） | 是 | 例如：1757560399 |
| sign | string | 签名 | 是 | 参见下方的签名生成方法 |
| q | string | 待识别文本 | 是 | |
| preferFrom | string | 期待的语种结果 | 否 | 如果识别结果中包含期待语种，则直接返回期待语种 |
--签名生成方法如下(v3)
sign=sha256(appKey+input+salt+curtime+应用密钥)；
其中，
1. 当 q 长度小于等于20时，input=q;
2. 当 q 长度大于20时，input=q前10个字符 + q长度 + q后10个字符；响应结果
响应结果中会包含多条如下结果的消息，直到翻译结束
| 字段 | 类型 | 含义 |
|---|---|---|
| errorCode | String | 错误码，参见最下方的错误码表 |
| errorMessage | String | 错误信息 |
| successful | Boolean | 本次请求是否成功 |
| data | Array | 识别结果 |
| data[*].language | 语种 | 可能的语种 |
| data[*].confidence | Double | 当前语种的概率 0.0 - 1.0 |
-- 返回示例
json
{
"errorCode": "0",
"errorMessage": "成功",
"data": [
{
"language": "zh-CHS",
"confidence": 0.352
},
{
"language": "fr",
"confidence": 0.342
},
{
"language": "ca",
"confidence": 0.292
},
{
"language": "no",
"confidence": 0.012
},
{
"language": "vi",
"confidence": 0.0
},
{
"language": "sq",
"confidence": 0.0
},
{
"language": "en",
"confidence": 0.0
}
],
"requestId": "1765788278603-17902713954764199-792"
}curl 调用示例
bash
curl --location --request POST 'https://openapi.youdao.com/v1/detect' \
--header 'Accept: */*' \
--header 'Host: openapi.youdao.com' \
--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=6360374ce4cd35c5072e1caed737aae7af4d6fd4d9f03b17bdfb71026fc8de7b' \
--data-urlencode 'curtime=1765788278' \
--data-urlencode 'q=Bonjour, comment ça va ? 欢迎来中国旅游。'语种识别列表
| 代码 | 名称 |
|---|---|
| af | 南非荷兰语 |
| ar | 阿拉伯语 |
| as | 阿萨姆语 |
| az | 阿塞拜疆语 |
| ba | 巴什基尔语 |
| be | 白俄罗斯语 |
| bg | 保加利亚语 |
| bn | 孟加拉语 |
| bs | 波斯尼亚语 |
| bo | 藏语 |
| ca | 加泰隆语 |
| cs | 捷克语 |
| cy | 威尔士语 |
| da | 丹麦语 |
| de | 德语 |
| dv | 迪维希语 |
| el | 希腊语 |
| en | 英语 |
| eo | 世界语 |
| es | 西班牙语 |
| et | 爱沙尼亚语 |
| eu | 巴斯克语 |
| fa | 波斯语 |
| fi | 芬兰语 |
| fr | 法语 |
| fy | 弗里西语 |
| ga | 爱尔兰语 |
| gd | 苏格兰盖尔语 |
| gl | 加利西亚语 |
| gu | 古吉拉特语 |
| he | 希伯来语 |
| hi | 印地语 |
| hr | 克罗地亚语 |
| ht | 海地克里奥尔语 |
| hu | 匈牙利语 |
| hy | 亚美尼亚语 |
| id | 印度尼西亚语 |
| is | 冰岛语 |
| it | 意大利语 |
| ja | 日语 |
| ka | 格鲁吉亚语 |
| kk | 哈萨克语 |
| km | 高棉语 |
| kn | 卡纳达语 |
| ko | 韩语 |
| ku | 库尔德语 |
| ky | 柯尔克孜语 |
| la | 拉丁语 |
| lb | 卢森堡语 |
| lo | 老挝语 |
| lt | 立陶宛语 |
| lv | 拉脱维亚语 |
| mk | 马其顿语 |
| ml | 马拉雅拉姆语 |
| mn | 蒙古语 |
| mr | 马拉地语 |
| ms | 马来语 |
| mt | 马耳他语 |
| my | 缅甸语 |
| ne | 尼泊尔语 |
| nl | 荷兰语 |
| no | 挪威语 |
| or | 奥里亚语 |
| pa | 旁遮普语 |
| pl | 波兰语 |
| ps | 普什图语 |
| pt | 葡萄牙语 |
| ro | 罗马尼亚语 |
| ru | 俄语 |
| sd | 信德语 |
| si | 僧伽罗语 |
| sk | 斯洛伐克语 |
| sl | 斯洛文尼亚语 |
| so | 索马里语 |
| sq | 阿尔巴尼亚语 |
| sr-Cyrl | 塞尔维亚语 |
| su | 巽他语 |
| sv | 瑞典语 |
| sw | 斯瓦希里语 |
| ta | 泰米尔语 |
| te | 泰卢固语 |
| tg | 塔吉克语 |
| th | 泰语 |
| tk | 土库曼语 |
| tl | 菲律宾语 |
| tr | 土耳其语 |
| tt | 鞑靼语 |
| ug | 维语 |
| uk | 乌克兰语 |
| ur | 乌尔都语 |
| uz | 乌兹别克语 |
| vi | 越南语 |
| yi | 意第绪语 |
| yo | 约鲁巴语 |
| zh-CHS | 简体中文 |
| zh-CHT | 繁体中文 |
API错误代码列表
| 状态码 | 状态码含义 |
|---|---|
| 0 | 成功 |
| 1 | 未知错误，请联系客服 |
| 101 | 缺少必填的参数，首先确保必填参数齐全，然后，确认参数书写是否正确。 |
| 108 | 应用ID无效，注册账号，登录后台创建应用并完成绑定，可获得应用ID和应用密钥等信息 |
| 110 | 当前应用ID没有权限访问此服务，需要在控制台给当前应用ID开通此服务 |
| 112 | 请求的服务不存在 |
| 202 | 签名检验失败 |
| 206 | 因为时间戳无效导致签名校验失败 |
| 207 | 重放请求 |
常用语言 Demo
Java 示例
暂无
python3 示例
暂无
go 示例
暂无