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

删除音色（CosyVoice）

POST

/api/v1/cosyvoice-delete-voice

删除远端音色并同步删除本地记录。

只允许删除本账号 voice_source=upload（用户克隆/设计）的音色；官方（official）与社区（community）音色一律拒绝，避免误删远端。

需回查本地 voice_models（platform=cosyvoice）按存储 model 前缀判定上游分支，因为删除响应为空对象、不回显类型。

上游契约：model=voice-enrollment、input.action=delete_voice、参数 voice_id。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "voice_id": "cosyvoice-v3-flash-yuntts-ad3b7d73544141479eb23682ba7af282"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/cosyvoice-delete-voice' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "voice_id": "cosyvoice-v3-flash-yuntts-ad3b7d73544141479eb23682ba7af282"
}'

返回响应

🟢200

application/json

删除成功

Bodyapplication/json

示例

{
    "code": 200,
    "message": "删除成功"
}

修改于 2026-10-14 06:24:56

更新音色（CosyVoice 复刻音色）

语音合成（Qwen3-TTS）