声纹特征创建

创建音频声纹特征。

POSThttps://asr.ilivedata.com/api/v1/isv/audio/features/create

请求参数

请求头

以下请求头均为必需。

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
`featureId`	`String`	必需	音频唯一标识，不可重复

请求示例

{
  "url": "https://example.com/test.mp3",
  "featureId": "10000"
}

请求签名

按照帮助中心的请求签名计算 Authorization，使用以下接口参数。

签名参数	值
`HTTPMethod`	`POST`
`HostHeaderInLowercase`	`asr.ilivedata.com`
`HTTPRequestURI`	`/api/v1/isv/audio/features/create`

HTTP 响应

Content-Type: application/json;charset=UTF-8

响应字段

字段	类型	说明
`errorCode`	`Number`	errorCode码
`errorMessage`	`String`	错误消息
`featureId`	`String`	透传请求中的参数featureId
`embedding`	`Double[]`	音频向量数据

响应示例

以下向量示例省略了部分元素。

{
  "errorCode": 0,
  "errorMessage": "OK",
  "featureId": "10000",
  "embedding": [
    0.071899415,
    -0.070053105,
    -0.034217835,
    -0.02532959,
    -0.1187439,
        .
        .
        .
        .
        .
        .
    0.06555176,
    0.03401184,
    -0.099823,
    -0.06680298
  ]
}

错误码

HTTP 状态码	错误码	错误消息
200	0	此字段省略
401	1102	Unauthorized Client
401	1106	Missing Access Token
401	1107	Invalid Token
401	1108	Expired Token
401	1110	Invalid Client
405	1004	Method Not Allowed
411	1007	Not Content Length
400	1002	API Not Found
400	1003	Bad Request
400	1413	File too large, duration can not greater than 60s.
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
400	3001	FeatureId duplicate with exist one.