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

更新音色（CosyVoice 复刻音色）

POST

/api/v1/cosyvoice-update-voice

用新的音频重新复刻已有音色。

音频来源二选一：url 或 multipart/form-data 上传字段 file。

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

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "voice_id": "cosyvoice-v3-flash-yuntts-ad3b7d73544141479eb23682ba7af282",
    "url": "https://new-audio-url.wav"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/cosyvoice-update-voice' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "voice_id": "cosyvoice-v3-flash-yuntts-ad3b7d73544141479eb23682ba7af282",
    "url": "https://new-audio-url.wav"
}'

返回响应

🟢200

application/json

更新成功

Bodyapplication/json

示例

{
    "code": 200,
    "message": "音色更新成功",
    "data": {}
}

修改于 2026-10-14 13:59:45

创建音色（CosyVoice：复刻 / 设计）

删除音色（CosyVoice）