API Reference

Public avatar list API

Q: 形象会增加吗？

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

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

List public avatar videos (video_url) you can use for HD avatar rendering without uploading your own footage.

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

Get an API key Console / try it Open Markdown

Overview

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

Use cases

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

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.

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

{
  "key": "YOUR_API_KEY"
}

Request example

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

Details

接口说明：

返回平台维护的公共数字人形象列表。每条含公网可访问的 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 地址等）

Response example

{"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"}}}

Error codes

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

FAQ

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

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

封面从哪来？

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

返回的地址怎么用？

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

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

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

可以筛选吗？

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

会扣费吗？

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

形象会增加吗？