语种检测接口
更新时间:
检测音频语种并返回置信度。
POSThttps://asr.ilivedata.com/api/v1/language/detect
请求参数
请求头
以下请求头均为必需。
Header
值
说明
Content-Type
application/json; charset=UTF-8
请求体格式
Accept
application/json; charset=UTF-8
响应格式
X-AppId
—
控制台「服务配置」中的项目编号
X-TimeStamp
—
请求发起时的 UTC 时间,采用 W3C 格式。
格式示例:2026-09-30T02:30:00Z,实际请求需使用当前时间。
Authorization
—
签名值,计算方式见下文「请求签名」
请求体
参数
类型
必需
说明
url
String
非必需
音频url,当audio参数为空时,该字段为必需
audio
String
非必需
Base64格式的音频文件数据,当url参数为空时,该字段为必需
alternativeLanguages
Array
可选
候选语种数组,最多支持传入4个候选语种 支持语种
请求示例
{
"url": "https://example.com/test.mp3",
"alternativeLanguages": [
"en-US",
"th-TH",
"id-ID"
]
}
请求签名
按照帮助中心的请求签名计算 Authorization,使用以下接口参数。
签名参数
值
HTTPMethod
POST
HostHeaderInLowercase
asr.ilivedata.com
HTTPRequestURI
/api/v1/language/detect
HTTP 响应
Content-Type: application/json;charset=UTF-8
响应字段
字段
类型
说明
errorCode
Number
0表示成功
errorMessage
String
错误消息
language
String
语言-地区
confidence
Number
置信度
响应示例
{
"errorCode": 0,
"language": "zh-CN",
"confidence": 0.9
}
错误码
HTTP 状态码
错误码
错误消息
200
0
此字段省略
405
1004
Method Not Allowed
411
1007
Not Content Length
400
1002
API Not Found
400
1003
Bad Request
400
2000
Missing Parameter
400
2001
Invalid Parameter
400
2002
Invalid Request
400
2102
Input Too Long
400
2103
Detection Failed
400
2109
Speech Recognition Failed
400
2110
File is invalid
400
2111
Failed to download file
400
2112
TaskId is invalid
401
1102
Unauthorized Client
401
1106
Missing Access Token
401
1107
Invalid Token
401
1108
Expired Token
401
1110
Invalid Client
检测音频语种并返回置信度。
POST
https://asr.ilivedata.com/api/v1/language/detect请求参数
请求头
以下请求头均为必需。
| Header | 值 | 说明 |
|---|---|---|
Content-Type |
application/json; charset=UTF-8 |
请求体格式 |
Accept |
application/json; charset=UTF-8 |
响应格式 |
X-AppId |
— | 控制台「服务配置」中的项目编号 |
X-TimeStamp |
— | 请求发起时的 UTC 时间,采用 W3C 格式。 格式示例: 2026-09-30T02:30:00Z,实际请求需使用当前时间。 |
Authorization |
— | 签名值,计算方式见下文「请求签名」 |
请求体
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
url |
String |
非必需 | 音频url,当audio参数为空时,该字段为必需 |
audio |
String |
非必需 | Base64格式的音频文件数据,当url参数为空时,该字段为必需 |
alternativeLanguages |
Array |
可选 | 候选语种数组,最多支持传入4个候选语种 支持语种 |
请求示例
{
"url": "https://example.com/test.mp3",
"alternativeLanguages": [
"en-US",
"th-TH",
"id-ID"
]
}
请求签名
按照帮助中心的请求签名计算 Authorization,使用以下接口参数。
| 签名参数 | 值 |
|---|---|
HTTPMethod |
POST |
HostHeaderInLowercase |
asr.ilivedata.com |
HTTPRequestURI |
/api/v1/language/detect |
HTTP 响应
Content-Type: application/json;charset=UTF-8
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
errorCode |
Number |
0表示成功 |
errorMessage |
String |
错误消息 |
language |
String |
语言-地区 |
confidence |
Number |
置信度 |
响应示例
{
"errorCode": 0,
"language": "zh-CN",
"confidence": 0.9
}
错误码
| HTTP 状态码 | 错误码 | 错误消息 |
|---|---|---|
| 200 | 0 | 此字段省略 |
| 405 | 1004 | Method Not Allowed |
| 411 | 1007 | Not Content Length |
| 400 | 1002 | API Not Found |
| 400 | 1003 | Bad Request |
| 400 | 2000 | Missing Parameter |
| 400 | 2001 | Invalid Parameter |
| 400 | 2002 | Invalid Request |
| 400 | 2102 | Input Too Long |
| 400 | 2103 | Detection Failed |
| 400 | 2109 | Speech Recognition Failed |
| 400 | 2110 | File is invalid |
| 400 | 2111 | Failed to download file |
| 400 | 2112 | TaskId is invalid |
| 401 | 1102 | Unauthorized Client |
| 401 | 1106 | Missing Access Token |
| 401 | 1107 | Invalid Token |
| 401 | 1108 | Expired Token |
| 401 | 1110 | Invalid Client |