请求方式	PUT
请求地址	`https://api.coze.cn/v1/audio/voiceprint_groups/:group_id`
权限	`updateVoiceprintGroup` 确保调用该接口使用的个人令牌开通了 `updateVoiceprintGroup` 权限，详细信息参考鉴权方式。
接口说明	更新声纹组的名称或描述。

请求参数

参数	取值	说明
Authorization	Bearer $Access_Token	用于验证客户端身份的访问令牌。你可以在扣子编程中生成访问令牌，详细信息，参考准备工作。
Content-Type	application/json	解释请求正文的方式。

Path

参数	类型	是否必选	示例	说明
group_id	Integer	必选	751430381173789****	待更新的声纹组的 ID。你可以通过查看声纹组列表 API 查看声纹组 ID。

Body

参数	类型	是否必选	示例	说明
name	String	可选	音箱2的声纹组	更新后的声纹组名称，最长 20 个字符。
desc	String	可选	音箱2的声纹组	更新后的声纹组描述，最长 500 个字符。

返回参数

参数	类型	示例	说明
code	Long	0	调用状态码。0 表示调用成功，其他值表示调用失败，你可以通过 msg 字段判断详细的错误原因。
msg	String	“”	状态信息。API 调用失败时可通过此字段查看详细错误信息。状态码为 0 时，msg 默认为空。
detail	Object of ResponseDetail	{ “logid”: “202410242028595CCF353CEC86A8*****” }	本次请求的详细信息。

ResponseDetail

参数	类型	示例	说明
logid	String	20241210152726467C48D89D6DB2****	本次请求的日志 ID。如果遇到异常报错场景，且反复重试仍然报错，可以根据此 logid 及错误码联系扣子团队获取帮助。详细说明可参考获取帮助和技术支持。

示例

请求示例

curl --location --request PUT 'https://api.coze.cn/v1/audio/voiceprint_groups/7513864977188***' \
--header 'Authorization: Bearer pat_OYDacMzM3WyOWV3Dtj2bHRMymzxP****' \
--header 'Content-Type: application/json'
{
  "name": "音箱2的声纹组",
  "desc": "音箱2的声纹组"
}

返回示例

{
  "code": 0,
  "msg": "",
  "detail": {
    "logid": "20250609164004CE42B51AC168FD***"
  }
}

错误码

如果成功调用扣子编程的 API，返回信息中 code 字段为 0。如果状态码为其他值，则表示接口调用失败。此时 msg 字段中包含详细错误信息，你可以参考错误码文档查看对应的解决方法。