本文档由云音工坊自动生成，如有疑问，请联系客服微信：yuntts ！

删除自定义音色

开发中

POST

https://www.yuntts.com/api/v1/indextts25/delete-voice

删除自定义音色

POST https://www.yuntts.com/api/v1/indextts25/delete-voice

只能删除自己创建的音色；系统音色不能删除。

7.1 请求参数

参数	类型	必填	说明
`voice_id`	String	是	要删除的音色 ID（必须是自己创建的克隆音色）

7.2 返回参数

参数	类型	说明
`data.voice_id`	String	被删除的音色 ID
`data.deleted`	Boolean	固定为 `true`

{
  "code": 200,
  "message": "音色已删除（远端 + 本地）",
  "data": {
    "voice_id": "01a0a970-3c11-7d22-8b55-6c8f1e3a9d22",
    "deleted": true
  }
}

7.3 错误码

HTTP	error	说明
400	`missing_voice_id`	没传 `voice_id`
403	`not_deletable`	系统音色不允许删除
403	`permission_denied`	无权删除别人的音色
404	`voice_not_found`	音色不存在
502	`service_error`	删除失败，可稍后重试

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "voice_id": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.yuntts.com/api/v1/indextts25/delete-voice' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "voice_id": "string"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 200,
    "message": "音色已删除",
    "data": {
        "voice_id": "音色ID",
        "deleted": true
    }
}

修改于 2026-10-03 01:14:15

查询音色列表

语音合成（Qwen-Audio-TTS）

删除自定义音色

删除自定义音色#

7.1 请求参数#

7.2 返回参数#

7.3 错误码#

请求参数

请求示例代码

返回响应

删除自定义音色

7.1 请求参数

7.2 返回参数

7.3 错误码