API Reference

公共数字人形象列表 API

Q: 形象会增加吗？

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

REQUEST public-digital-human-avatars-api ID 53

销豹公共数字人形象列表 API 返回平台维护的人物参考视频 video_url，可直接用于数字人高清合成，无需自备形象素材。

REQUEST https://xiaoapis.com/api/aihuman/public_avatars

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

概述

公网 video_url
封面（视频第 3 帧）
按性别/关键词筛选
查询不扣费
可扩展目录

适用场景

快速试跑数字人链路
无自有形象时的默认素材
Agent 自动选形象成片

调用约定

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

鉴权

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

REQUEST https://xiaoapis.com/api/aihuman/public_avatars
Content-Type: application/json

{
  "key": "YOUR_API_KEY"
}

请求示例

https://xiaoapis.com/api/aihuman/public_avatars?key=你的密钥

详细说明

接口说明：

返回平台维护的公共数字人形象列表。每条含公网可访问的 video_url，可直接作为 AI数字人高清合成的 video_url。无需自备人物视频即可试跑整条链路。查询不扣费。

请求方法：支持 GET 与 POST。

后续可继续在目录中追加新形象；接入方以本接口返回为准。

请求HEADER：

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

请求参数说明：

名称	必填	类型	示例值	说明
gender	否	string	female	按性别筛选：female / male
keyword	否	string	新闻	按名称、风格、标签模糊筛选；亦可用参数名 q
id	否	string	news_anchor_female	精确取某一形象

返回参数说明：

名称	类型	说明
total	int	列表条数
list	array	形象列表
list[].id	string	形象唯一标识
list[].name	string	展示名称
list[].gender	string	female / male
list[].style	string	风格简述
list[].video_url	string	人物参考视频公网地址，可直接传给 create
list[].tags	array	标签
usage	object	使用提示（create 地址等）

返回示例

{"code":200,"msg":"查询成功","data":{"total":3,"list":[{"id":"news_anchor_female","name":"新闻主播","gender":"female","style":"职业女性·专业","video_url":"https://wikixiaobao.oss-accelerate.aliyuncs.com/uploads/video/20260921/202609211043306cd031836.mp4","tags":["新闻","主播","商务","女"],"sort":10},{"id":"daily_natural_female","name":"日常自然","gender":"female","style":"日常·自然","video_url":"https://wikixiaobao.oss-accelerate.aliyuncs.com/uploads/video/20260921/20260921120938441b78699.mp4","tags":["日常","自然","女"],"sort":20},{"id":"news_anchor_male","name":"男生新闻主播","gender":"male","style":"男性·新闻主播","video_url":"https://wikixiaobao.oss-accelerate.aliyuncs.com/uploads/video/20260921/20260921105256763f36229.mp4","tags":["新闻","主播","男"],"sort":30}],"usage":{"create":"https://xiaoapis.com/api/aihuman/create","hint":"将 list[].video_url 作为 create 接口的 video_url"}}}

错误码

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

常见问题

什么是公共数字人形象列表？

平台维护的一批可直接使用的数字人参考视频目录，接口返回公网 video_url 和封面 cover。

封面从哪来？

每条形象返回 cover。未单独配置时，平台截取参考视频第 3 帧作为封面，保存到本地后给出公网地址。

返回的地址怎么用？

将 list[].video_url 作为数字人高清合成接口的 video_url，再配合 TTS 或自有音频即可出片。

需要自己上传人物视频吗？

试跑或无自有素材时不需要；有品牌形象时可改用自有公网视频地址。

可以筛选吗？

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

会扣费吗？

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

形象会增加吗？