帮助与文档 > 产品文档 > 自然语言翻译服务 > API文档 > 语种识别
语种识别

语种识别简介

概念解释

输入一段文本,识别出文本的语种。

说明

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
-- 返回示例
{
    "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 调用示例

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 示例

暂无