跳到正文
平台 / 文档 / 公共音色列表 API
注册 控制台 →

API Reference

公共音色列表 API

REQUEST public-voices-api ID 58

销豹公共音色列表 API 返回平台维护的系统音色 voice_id，可直接用于语音合成（voice_type=public），无需先克隆。

REQUEST https://apis.xiaobao.ink/api/aihuman/public_voices
获取 API Key 工作台 / 调试 打开 Markdown

概述

  • 返回 voice_id
  • 试听 demo_url
  • 按性别/关键词筛选
  • 查询不扣费

适用场景

  • 快速配音
  • 数字人口播上游
  • Agent 自动选音色
调用约定
  • 网关 · https://apis.xiaobao.ink
  • 鉴权 · 请求携带 key（Query 或 JSON Body，以本接口为准）
  • 回包 · JSON；请同时校验业务码与 HTTP 状态，不要只看 200

鉴权

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

REQUEST https://apis.xiaobao.ink/api/aihuman/public_voices
Content-Type: application/json

{
  "key": "YOUR_API_KEY"
}

请求示例

https://apis.xiaobao.ink/api/aihuman/public_voices?key=你的密钥

详细说明

接口说明：

返回平台维护的公共音色列表。每条含 voice_id 与描述字段，可直接作为 语音合成 的 voice_id（并设置 voice_type=public）。无需先做声音克隆即可配音。查询不扣费。

请求方法：支持 GET 与 POST。

后续可继续在目录中追加新音色；接入方以本接口返回为准。文档页顶部会动态展示当前公共音色目录（含试听）。

请求HEADER：

名称值
Content-Typeapplication/json 或 application/x-www-form-urlencoded（POST 时）

请求参数说明：

名称必填类型示例值说明
gender否stringfemale按性别筛选：female / male
keyword否string悠悠按名称、风格、描述、标签模糊筛选；亦可用参数名 q
voice_id否stringc5469fea1ca07847精确取某一音色；亦可用参数名 id

返回参数说明：

名称类型说明
totalint列表条数
listarray音色列表
list[].voice_idstring音色 ID，传给 TTS
list[].namestring展示名称
list[].genderstringfemale / male
list[].langstring语言，如 zh-cn
list[].stylestring风格简述
list[].descriptionstring音色文字描述，便于选型
list[].demo_urlstring试听音频公网地址
list[].tagsarray标签
usageobject使用提示（tts 地址等）

返回示例

{"code":200,"msg":"查询成功","data":{"total":5,"list":[{"voice_id":"c5469fea1ca07847","name":"悠悠","gender":"female","lang":"zh-cn","style":"女声·亲切","description":"亲切自然的女声，语气柔和、吐字清晰，适合日常口播、产品介绍与短视频旁白。","demo_url":"https://wikixiaobao.oss-accelerate.aliyuncs.com/uploads/digital_human/voice/20260509/2ff8775941da6a8be38a7028cf0382ce_1778295258.wav","tags":["女","亲切","口播"],"sort":10},{"voice_id":"c5469fea5f76c4bf","name":"磁性男士","gender":"male","lang":"zh-cn","style":"男声·磁性","description":"低沉有磁性的男声，质感稳重，适合品牌解说、广告配音与专业旁白。","demo_url":"https://wikixiaobao.oss-accelerate.aliyuncs.com/uploads/digital_human/voice/20260509/975294e26d8c2894c42f458449c9ee02_1778296333.wav","tags":["男","磁性","解说"],"sort":20},{"voice_id":"c5469fea610b1ba8","name":"故事解读","gender":"male","lang":"zh-cn","style":"男声·叙事","description":"沉稳叙事男声，节奏适中、适合讲故事，可用于故事讲述、知识解读与长文朗读。","demo_url":"https://wikixiaobao.oss-accelerate.aliyuncs.com/uploads/digital_human/voice/20260509/6b28c94190242046e31c2d43534d69e5_1778296353.wav","tags":["男","故事","解读"],"sort":30},{"voice_id":"c5469fea627d2d6c","name":"阳光男生","gender":"male","lang":"zh-cn","style":"男声·阳光","description":"清爽阳光的男声，语气轻松有活力，适合生活类口播、青春向短视频与日常分享。","demo_url":"https://wikixiaobao.oss-accelerate.aliyuncs.com/uploads/digital_human/voice/20260509/4db777fd7fb9bee0010cb6cf32ab769e_1778296375.wav","tags":["男","阳光","口播"],"sort":40},{"voice_id":"c5469fea64412d85","name":"热情娜娜","gender":"female","lang":"zh-cn","style":"女声·热情","description":"热情活泼的女声，感染力强，适合带货口播、促销介绍与活力向内容。","demo_url":"https://wikixiaobao.oss-accelerate.aliyuncs.com/uploads/digital_human/voice/20260509/f443f03396f943c6d93a767baa41e5aa_1778296406.wav","tags":["女","热情","口播"],"sort":50}],"usage":{"tts":"https://apis.xiaobao.ink/api/aihuman/tts","hint":"将 list[].voice_id 作为 tts 的 voice_id，并设置 voice_type=public"}}}

错误码

HTTP 响应状态码说明
200查询成功
400接口未开启或未入库
401认证失败，请检查 key

常见问题

什么是公共音色列表？

平台维护的一批系统音色目录，接口返回 voice_id，可直接用于语音合成。

voice_id 怎么用？

调用 TTS 时传入 list[].voice_id，并设置 voice_type=public。

一定要先克隆声音吗？

不必。公共音色可直接配音；只有需要「像某人说话」时才走声音克隆。

可以筛选吗？

支持按 gender（female/male）、keyword 或 voice_id 筛选。

会扣费吗？

本列表查询不扣费；后续 TTS、数字人合成仍按对应接口计费。

音色会增加吗？

会。目录可扩展，以本接口实时返回为准。

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