重新克隆音色

更新时间: 2025/09/17 09:16:08

音色重克隆用于对试听结果不满意的场景,可以指定原有的音色 ID 发起重克隆,更新克隆音色,总的克隆次数不得超过 10。

  • 支持的音频格式:mp3、m4a、wav。
  • 文件大小限制:10M 以内。
  • 总克隆次数限制:不得超过 10 次。
  • 需要使用 form-data 格式提交请求。

请求信息

请求 URI

POST https://rtc-ai.yunxinapi.com/v1/api/tts/voice-reclone

请求头参数

请求 Header 的参数说明请参考 请求结构

请求体参数

参数名称 类型 是否必选 示例 说明
file File voice_sample.mp3 需要上传的声音文件,目前支持 mp3、m4a、wav 格式,大小在 10M 以内
voiceId String GZ_6FXfkjpzhnZI1 需要重克隆的音色 ID
desc String 睿智的导游音色 音色描述,一般用作音色 ID 的别名,方便记忆
textValidation String 这段时间天气真不错。你今天过得怎么样呢?咱们晚上可以一起去散散步,听听音乐,吹吹风,一起聊聊今天发生的新鲜事。 音频复刻校验音色的参数,未填时使用示例里的文本做校验

请求体示例

shellcurl -X POST https://rtc-ai.yunxinapi.com/v1/api/tts/voice-reclone \
  -H "Content-Type: multipart/form-data" \
  -F "file=@voice_sample.mp3" \
  -F "voiceId=GZ_6FXfkjpzhnZI1" \
  -F "desc=睿智的导游音色" \
  -F "textValidation=这段时间天气真不错。你今天过得怎么样呢?咱们晚上可以一起去散散步,听听音乐,吹吹风,一起聊聊今天发生的新鲜事。"

响应信息

响应参数

参数名称 类型 说明 是否必返回
code Number 状态码,200 表示成功。出错时,错误信息在 errMsg 中
voiceId String 音色 ID
demoAudio String 试听音色链接
errMsg String 错误信息描述

响应体示例

JSON{
    "code": 200,
    "voiceId": "GZ_6FXfkjpzhnZI1",
    "demoAudio": "https://yunxin-vc.nos-jd.163yun.com/146298631/GZ_6FXfkjpzhnZI1.wav"
}
此文档是否对你有帮助?
有帮助
去反馈
  • 请求信息
  • 请求 URI
  • 请求头参数
  • 请求体参数
  • 请求体示例
  • 响应信息
  • 响应参数
  • 响应体示例