API Reference

Voice cloning Pro API

POST audio-copy-pro-api ID 29

Higher-fidelity voice cloning for production voiceover and brand voices.

POST https://xiaoapis.com/api/audio/audiocopypro

Get an API key Console / try it Open Markdown

Overview

音色复刻
异步任务
对接后续合成

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/audio/audiocopypro
Content-Type: application/json

{
  "key": "YOUR_API_KEY"
}

Request example

https://xiaoapis.com/api/audio/audiocopypro?key=你的密钥

Details

请求HEADER：

名称	值
Content-Type	application/x-www-form-urlencoded;charset=utf-8 或 application/json

接口说明：

声音复刻PRO用于将原人声克隆为可复用的音色ID。克隆成功后，将返回的 voice 传入「语音合成PRO」即可用该音色朗读文本。

关联接口：语音合成PRO /api/audio/audiosavepro、声音设计PRO /api/audio/sounddesignpro

计费说明：

按次计费，默认 200 点/次（约 2 元/次）。免费额度以控制台配置为准（文档参考免费 3 次）。

请求参数说明：

名称	必填	类型	示例值	说明
key	是	string	你的平台密钥	接口密钥，在控制台→密钥管理查看
audio_url	是	string	https://xx.mp3	音频URL（5秒-60秒，推荐10-30秒）。支持 mp3、wav、m4a；采样率须≥16kHz；文件大小10MB以内；支持单/双声道。语种：中文普通话、地方官话、英文、法语、德语、日语、韩语、俄语、葡萄牙语、泰语、印尼语、越南语等

录音友情提示：

请确保音频内容清晰流畅不卡顿
录制过程确保环境安静，没有明显环境噪音
录制过程中只能有一个人的声音，避免其它人声
不要长时间不说话，保证语速平稳
不要声音语调时高时低，保持音量均衡
不得进行混响特效处理，不得带背景音乐和音效
须为原音录制，不得对音频切分、合并或剪辑

朗读文本参考：

知识分享：早上醒来，窗外的鸟儿在歌唱。阳光透过树叶，洒在温暖的床单上。

情感博主：当我们遇到挫折，父母总是第一个伸出援手，给予我们鼓励和支持。

返回参数说明：

名称	类型	说明
code	int	状态码
msg	string	状态信息
data	object	结果数据
- voice	string	音色ID；超过1年未使用的音色ID将被清除
- power_cost	number	本次扣点
exec_time	float	执行耗时
ip	string	客户端IP

错误码：

错误码	类型	说明
403	int	没有权限（密钥无效等）
400	int	参数传递不正确 / 业务失败
500	int	服务器内部错误

Response example

{"code":200,"msg":"声音克隆成功","data":{"voice":"voice-68e021aa448346fb8cc0575a163229eb","power_cost":200},"exec_time":2.579,"ip":"1.2.3.4"}

Error codes

错误码	类型	说明
403	int	没有权限（密钥无效等）
400	int	参数传递不正确 / 业务失败
500	int	服务器内部错误

FAQ

和普通声音克隆有何区别？

PRO 为更高规格产品线，参数与计费可能不同，请对照各自文档。

如何调用？

按文档提交样本音频与 Key，异步获取复刻结果。

复刻结果如何用于合成？

将返回的音色标识传入语音合成 PRO 等后续接口。

素材要求？

公网可访问、清晰人声；格式与时长见文档。

适合谁？

对音色相似度与稳定性要求更高的商业配音场景。

Full console doc (with the debugger):/doc/29