# 声纹分离接口

声纹分离接口辅助于转写大模型的发音人分离功能，通过将(10s，1min)中范围的音频注册为声纹id，然后在使用转写大模型能力时，同时上传声纹id , 以此达到发音人分离的极致效果。

# 1. 用户声纹注册接口

功能：注册声纹特征。

# 请求地址

https://office-api-personal-dx.iflyaisol.com/res/feature/v1/register

# 请求头

参数名	值	说明
`Content-Type`	`application/json`	请求体为JSON格式
`signature`	`string`	基于请求参数生成的签名

# 请求参数 (Query + Body)

Query参数

参数名	是否必传	取值范围	说明
`appId`	是	string	应用ID
`accessKeyId`	是	string	访问密钥ID
`dateTime`	是	`yyyy-MM-dd'T'HH:mm:ss±HHmm`	带时区的请求时间
`signatureRandom`	是	string	随机字符串

Body参数

参数名	是否必传	类型	说明
`audio_data`	是	string	用于提取声纹特征等音频，音频时长不超过 1min，不低于 10s，经过标准 base64 编码的数据；
`audio_type`	是	string	音频类型:raw 、speex、opus-ogg raw对应的pcm 格式音频
`uid`	否	String	用户id

# 请求示例

{
    "audio_data": "zzxAAAJOAZZZZZAAAAAAAAA...",
    "audio_type": "raw"
}

# 返回参数

参数名	说明
`code`	返回码，`000000`表示成功
`desc`	描述信息
`data`	结果对象，为JSON字符串格式
`data.feature_id`	新生成的声纹特征ID
`data.status`	状态码，`1`表示成功
`sid`	请求会话ID

# 返回示例

{
    "code": "000000",
    "desc": "success",
    "data": "{\"feature_id\":\"20250918230019446ygDeLdBoiC08RTKG\",\"status\":1}",
    "sid": "b4f76122d531419cb5cf33c590f75a39"
}

# 2. 用户声纹更新接口

功能：更新已注册用户的声纹特征。

# 请求地址

https://office-api-personal-dx.iflyaisol.com/res/feature/v1/update

# 请求头

同注册接口。

# 请求参数 (Query + Body)

Query参数：同注册接口。

Body参数

参数名	是否必传	类型	说明
`audio_data`	是	string	用于提取声纹特征等音频，音频时长不超过 1min，不低于 10s，经过标准 base64 编码的数据；
`audio_type`	是	string	音频类型:raw 、speex、opus-ogg raw对应的pcm 格式音频
`feature_id`	是	string	待更新的声纹特征ID

# 请求示例

{
    "audio_data": "zzxAAAJOAZZZZZAAAAAAAAA...",
    "audio_type": "raw",
    "feature_id": "20250918230019446ygDeLdBoiC08RTKG"
}

# 返回参数

参数名	说明
`code`	返回码，`000000`表示成功
`desc`	描述信息
`data`	结果对象，为JSON字符串格式
`data.status`	状态码，`1`表示成功
`sid`	请求会话ID

# 返回示例

{
    "code": "000000",
    "desc": "success",
    "data": "{\"status\":1}",
    "sid": "3b27245de8ad4c838cb5deaeeab1c1dd"
}

# 3. 用户声纹删除接口

功能：删除一个或多个用户的声纹特征。

# 请求地址

https://office-api-personal-dx.iflyaisol.com/res/feature/v1/delete

# 请求头

同注册接口。

# 请求参数 (Query + Body)

Query参数：同注册接口。

Body参数

参数名	是否必传	取值范围	说明
`feature_ids`	是	string[]	待删除的声纹特征ID数组

# 请求示例

{
    "feature_ids": ["20250918231248655AqK5GyNtf898q2Eg", "feature2"]
}

# 返回参数

参数名	说明
`code`	返回码，`000000`表示成功
`desc`	描述信息
`data`	结果对象，为JSON字符串格式。成功时为`"{}"`
`sid`	请求会话ID

# 返回示例

{
    "code": "000000",
    "desc": "success",
    "data": "{}",
    "sid": "2fd99cfe3b0646928c166b2bcb404fce"
}

# 4. 示例代码

Python Demo (opens new window)

在这篇文章中：