API Reference

声音复刻 PRO API

POST audio-copy-pro-api ID 29

声音复刻 PRO 提供更高规格的音色复刻能力，用于专业配音与品牌声音场景。

POST http://apis.xiaobao.ink/api/audio/audiocopypro

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

概述

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

适用场景

专业配音
品牌音色
批量口播

调用约定

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

鉴权

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

POST http://apis.xiaobao.ink/api/audio/audiocopypro
Content-Type: application/json

{
  "key": "YOUR_API_KEY"
}

请求示例

http://apis.xiaobao.ink/api/audio/audiocopypro?key=你的密钥

详细说明

请求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	服务器内部错误

返回示例

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

错误码

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

常见问题

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

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

如何调用？

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

复刻结果如何用于合成？

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

素材要求？

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

适合谁？

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

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