人像查询接口
更新时间：2025-07-31
接口说明
接口调用域名：https://open.xiling.baidu.com
接口鉴权和通用字段说明请查阅：接口通用说明
接口列表
查询人像
接口说明
分页查询不同组件可用的数字人人像列表，接口鉴权和通用分页参数查阅：接口通用说明。
接口协议
GET /api/digitalhuman/open/v1/figure/query
GET 请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| systemFigure | boolean | 否 | 是否查询平台的公共人像 1. 为空：查询全部 2. true：返回平台公共人像 3. false：返回可用的定制人像 |
| item | string | 是 | 支持的组件类型（一次只能查一个类型） 1. VIDEO-DH_3D（3D视频组件） 2. VIDEO-DH_2D_LITE（2D小样本视频组件） 3. VIDEO-DH_2D（2D精品视频组件） 4. INTERACTION-CLOUD_DH_3D（3D云交互组件） 5. INTERACTION-CLOUD_DH_2D（2D云交互组件） 6. INTERACTION-LIVE_2D（2D直播） |
| pageNo | int | 否 | 页码，默认为1，最大100 |
| pageSize | int | 否 | 每页容量，默认10，最大1000 |
返回参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| figureId | string | 是 | 人像ID |
| name | string | 是 | 数字人名称 |
| customizeType | string | 否 | 定制类型 |
| systemFigure | boolean | 是 | 是否是平台公共人像 |
| gender | string | 是 | 性别：1.MALE 2.FEMALE |
| keepBackground | boolean | 否 | 是否保留底板视频背景 |
| taskSubmitTime | string | 否 | 任务提交时间 |
| templateImg | string | 是 | 数字人缩略图 |
| templateVideoUrl | string | 否 | 底板视频URL |
| resolutionWidth | int | 是 | 底板视频宽 |
| resolutionHeight | int | 是 | 底板视频高 |
| maskVideoUrl | string | 否 | mask视频URL |
| pictureUrl | string | 否 | 参考图片地址（生成式数字人有） |
| pose | string | 否 | 姿势与机位： 1.站姿全身 2.坐姿全身 3.坐姿半身 |
| background | string | 否 | 背景： 1.透明 2.户外 3.室内 |
| tags | list | 否 | 标签 样例： 1.日常休闲 2.职业商务 3.文化传统 4.节日氛围 5.运动户外 6.时尚潮流 7.带动作 等 |
| age | string | 否 | 年龄：1.少年 2.青年 3.中年 4.老年 |
请求示例
Plain
1GET /api/digitalhuman/open/v1/figure/query?systemFigure=true&item=INTERACTION-LIVE_2D&pageNo=1&pageSize=1返回示例
JSON
1{
2 "code": 0,
3 "message": {
4 "global": "success"
5 },
6 "result": {
7 "pageNo": 1,
8 "pageSize": 1,
9 "totalCount": 60,
10 "result": [
11 {
12 "figureId": "306295",
13 "name": "江砚",
14 "systemFigure": true,
15 "gender": "FEMALE",
16 "resolutionWidth": 1080,
17 "resolutionHeight": 1920,
18 "templateImg": "https://star-light-lite.cdn.bcebos.com/figure/video/fig-rfkt0b9qs237r8k520250611_201908main.png",
19 "pose": "站姿全身",
20 "background": "透明",
21 "age": "青年",
22 "tags": [
23 "文化传统",
24 "带动作"
25 ]
26 }
27 ]
28 },
29 "requestId": "984a1198-c735-4ba4-8235-40fbfd5cacb9",
30 "success": true
31}