API Reference

声音克隆 API

POST voice-clone-api ID 9

销豹声音克隆 API 基于样本音频克隆音色，异步返回任务结果，可与语音合成、数字人接口组合使用。

POST https://xiaoapis.com/api/aihuman/clonevoice

获取 API Key 工作台 / 调试打开 Markdown

概述

样本音频克隆
异步任务
回调 / 任务查询
JSON 返回

适用场景

定制口播音色
品牌声音资产
数字人驱动前的音色准备

调用约定

网关 · https://apis.xiaobao.ink
鉴权 · 请求携带 key（Query 或 JSON Body，以本接口为准）
回包 · JSON；请同时校验业务码与 HTTP 状态，不要只看 200

鉴权

请求需携带平台 API Key（查询参数 key 或 JSON 字段 key，以本接口说明为准）。在控制台 API Key 管理创建密钥。

POST https://xiaoapis.com/api/aihuman/clonevoice
Content-Type: application/json

{
  "key": "YOUR_API_KEY"
}

请求示例

https://xiaoapis.com/api/aihuman/clonevoice?key=你的密钥

详细说明

请求参数说明：

名称	必填	类型	示例值	说明
audio_url	是	string	https://xxx.mp3	原音频url
name	否	string	UU的声音	声音名称
lang	否	string	zh-cn	语言，用哪种语言克隆的，仅能合成哪种语言的音频。 zh-cn：中文 en：英文 fr：法语 de：德语 ja：日语 ko：韩语 ru：俄语 pt：葡萄牙语 th：泰语 id：印尼语 vi：越南语默认值: zh-cn
notify	是	string	http://xxx.com	回调地址，用于接收任务结果，任务结果数据会通过 POST 请求发送到该地址

返回参数说明：

名称	类型	说明
code	int	状态码
msg	string	状态信息
data	array	请求结果数据集（成功的时候有值）
- task_id	string	任务id
exec_time	float	执行耗时
user_ip	string	客户端IP

回调参数说明：

名称	类型	说明
task_id	string	任务id
status	int	1成功 2失败
voice_id	string	音色id，仅成功时有
demo_url	string	demo音频，仅成功时有值（文件仅短暂留存，请转存
message	string	失败原因，仅失败时有值

返回示例

{  "code": 200,  "data": {    "task_id": "string"  },  "msg": "string"}

常见问题

什么是声音克隆 API？

声音克隆 API 用一段样本音频生成可复用的音色标识，供后续 TTS 或口播链路使用。

声音克隆 API 怎么调用？

向接口提交公网可访问的样本音频地址与 API Key，创建任务后通过查询接口或回调获取结果。

克隆完成后怎么用？

将返回的音色相关标识传入语音合成等后续接口（字段名以文档为准），即可用该音色朗读文案。

对样本音频有什么要求？

需为公网可访问地址，格式与时长限制以接口文档为准；建议清晰、少杂音。

是同步还是异步？

声音克隆一般为异步任务，返回 task_id 后需轮询或等待回调。

可以和数字人一起用吗？

可以。常见链路是：克隆音色 → TTS 出音频 → 数字人合成视频。

完整控制台文档（含调试台）：/doc/9