API Reference

声音设计 PRO API

Q: 计费方式？

以控制台与文档标价为准。

POST sound-design-pro-api ID 30

声音设计 PRO 用于专业向音频设计/处理类能力，具体参数与效果以接口文档为准。

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

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

概述

专业音频能力
异步/同步以文档为准

适用场景

音频设计
内容配乐处理

调用约定

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

鉴权

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

POST https://xiaoapis.com/api/audio/sounddesignpro
Content-Type: application/json

{
  "key": "YOUR_API_KEY"
}

请求示例

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

详细说明

请求HEADER：

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

接口说明：

声音设计PRO：根据声音文字描述生成专属音色（音色定制/音色创作）。返回的 voice_id 可直接用于「语音合成PRO」。

关联接口：语音合成PRO /api/audio/audiosavepro

计费说明：

按次计费，默认 200 点/次（约 2 元/次）。免费额度以控制台配置为准（文档参考免费 3 次）。超过 1 年未使用的音色ID将被清除。

请求参数说明：

名称	必填	类型	示例值	说明
key	是	string	你的平台密钥	接口密钥，在控制台→密钥管理查看
voice_prompt	是	string	一个可爱的声音，超级可爱的女孩。	声音描述，最大长度500字符，仅支持中文和英文
preview_text	否	string	你好！	预览音频文本，默认「你好！」，最多200字符
language_hints	否	string	zh	语言选择，默认 zh（可选 zh 中文 / en 英文）

返回参数说明：

名称	类型	说明
code	int	状态码
msg	string	状态信息
data	object	结果数据
- voice_id	string	音色ID；超过1年未使用将被清除
- preview_audio	object	预览音频：base64 / format / sample_rate
- preview_url	string	预览音频转存后的本站URL（若保存成功）
- power_cost	number	本次扣点
exec_time	float	执行耗时
ip	string	客户端IP

错误码：

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

返回示例

{"code":200,"msg":"音色创建成功","data":{"voice_id":"sd-8c034e3c82db494fb6e728f04115d944","preview_audio":{"base64":"UklGR...","format":"wav","sample_rate":24000},"preview_url":"https://xiaoapis.com/upload/audio/2026/07/15/sdpreview_xxx.wav","power_cost":200},"exec_time":5.76,"ip":"1.2.3.4"}

错误码

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

常见问题

声音设计 PRO 能做什么？

提供专业向声音设计相关处理，请以当前文档参数与示例为准。

如何接入？

使用 API Key 按文档提交音频与设计参数。

和 TTS 的关系？

TTS 侧重文案转语音；本接口侧重声音设计类处理，可按业务串联。

如何看结果？

根据返回的音频地址或任务状态字段获取产出。

计费方式？