API Reference
Voice cloning API
POST
voice-clone-api
ID 9
Clone a voice from a sample audio file. The job is async and can be used with text-to-speech and avatar APIs.
POST
https://xiaoapis.com/api/aihuman/clonevoice
Overview
- 样本音频克隆
- 异步任务
- 回调 / 任务查询
- JSON 返回
Use cases
- 定制口播音色
- 品牌声音资产
- 数字人驱动前的音色准备
Conventions
- Gateway ·
https://xiaoapis.com - Auth · send
key(query or JSON body, as this API specifies) - Response · JSON. Check the business code and the HTTP status, not only HTTP 200
Authentication
Send the platform API key (query parameter key or JSON field key, as this page specifies). Create one in API key management.
POST https://xiaoapis.com/api/aihuman/clonevoice
Content-Type: application/json
{
"key": "YOUR_API_KEY"
}
Request example
https://xiaoapis.com/api/aihuman/clonevoice?key=你的密钥
Details
请求参数说明：
| 名称 | 必填 | 类型 | 示例值 | 说明 |
|---|---|---|---|---|
| audio_url | 是 | string | https://xxx.mp3 | 原音频url |
| name | 否 | string | UU的声音 | 声音名称 |
| lang | 否 | string | zh-cn | 语言，用哪种语言克隆的，仅能合成哪种语言的音频。 默认值: 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 | 失败原因，仅失败时有值 |
Response example
{ "code": 200, "data": { "task_id": "string" }, "msg": "string"}
FAQ
什么是声音克隆 API？
声音克隆 API 用一段样本音频生成可复用的音色标识，供后续 TTS 或口播链路使用。
声音克隆 API 怎么调用？
向接口提交公网可访问的样本音频地址与 API Key，创建任务后通过查询接口或回调获取结果。
克隆完成后怎么用？
将返回的音色相关标识传入语音合成等后续接口（字段名以文档为准），即可用该音色朗读文案。
对样本音频有什么要求？
需为公网可访问地址，格式与时长限制以接口文档为准；建议清晰、少杂音。
是同步还是异步？
声音克隆一般为异步任务，返回 task_id 后需轮询或等待回调。
可以和数字人一起用吗？
可以。常见链路是：克隆音色 → TTS 出音频 → 数字人合成视频。
Related APIs
Full console doc (with the debugger):/doc/9