生成式数字人形象定制接口
更新时间:2025-06-26
接口说明
- 调用生成式形象定制任务接口,提交人像图片,返回人像ID
- 接收任务结束的回调通知,或使用人像ID
查询人像定制任务状态 - 定制的生成式人像适用于视频合成场景
- 生成式数字人分为【稳定版】和【灵动版】。生成式具有不确定性,可能存在眼神外瞟、镜头移动、手部变形等情况。
【稳定版】身体呈现自然动态,手部几乎无大幅度动作,效果更稳定。参考视频
【灵动版】身体呈现自然动态,手部大概率出现摊手动作,效果更灵动。 参考视频
接口调用域名:https://open.xiling.baidu.com
接口鉴权和通用字段说明请查阅:接口通用说明
调用本接口需要在平台购买生成式数字人克隆组件商品并绑定到应用。
接口列表
提交形象定制任务
接口说明
创建数字人训练任务,返回人像ID
接口协议
POST /api/digitalhuman/open/v1/figure/generative/train
Header Content-Type: application/json;charset=utf-8
请求参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
name | string | 是 | 数字人名称 命名要求: 1. 账户内名称唯一 2. 不超过20个字符 |
customizeType | string | 是 | 定制类型 1. 稳定版:GENERATE_NO_ACTION 2. 灵动版:GENERATE_ACTION |
gender | string | 是 | 性别 1. MALE(男) 2. FEMALE(女) |
figureImageUrl | string | 是 | 参考图像 1. 支持传入图片Base64编码或图片URL 2. 图片格式支持.jpg / .jpeg / .png 3. 图片文件大小不能超过10MB 4. 图片分辨率不小于720*720px 5. 图片宽高比要在1:2 ~ 2:1之间 |
callbackUrl | string | 否 | 接口调用方接受任务回调通知的url,规则和接口说明参考 接口通用说明,回调消息定义如下表。 |
回调参数
- type: FIGURE_2D_LITE_GENERATE
- data:
参数名 | 类型 | 是否必填 | 描述 |
---|---|---|---|
figureId | string | 是 | 人像ID |
status | string | 是 | 状态 1. LINE_UP(排队中) 2. ACTIONING(动作生成中) 3. GENERATING(开始训练) 4. SUCCESS(成功) 5. FAILED(失败) |
failedCode | int | 否 | 失败错误码 |
failedMessage | string | 否 | 失败错误信息 |
返回参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
figureId | string | 是 | 人像ID,用于调用人像查询接口查询人像状态 |
请求示例
JSON
1{
2 "name": "数字人test2025",
3 "customizeType": "GENERATE_NO_ACTION", // 无动作
4 "figureImageUrl": "https://open-api-test.bj.bcebos.com/%E7%94%9F%E6%88%90%E5%BC%8F%E6%B5%8B%E8%AF%95%2FSlide%2016_9%20-%201.png",
5 "gender": "MALE"
6}
返回示例
JSON
1{
2 "code": 0,
3 "message": {
4 "global": "success"
5 },
6 "result": {
7 "figureId": "2153"
8 },
9 "requestId": "b978a051-fafe-4623-bfa5-1c07566e88ac",
10 "success": true
11}
错误码
错误码 | 描述 |
---|---|
10006 | 参数校验不通过 |
10011 | 没有购买形象定制的组件商品 |
10020 | 图片内容有安全风险 |
10021 | IP被封禁,请稍后再试或者联系客服 |
21000 | 训练任务内部异常,请重新提交或联系客服处理 |
21001 | 形象包训练任务提交异常 |
21002 | 找不到人像ID |
21003 | 人像查询异常 |
50001 | 额度预扣除失败 |
50002 | 余额不足 |
其他 | 内部异常,请重新提交或联系客服处理 |
查询人像
接口说明
分页查询定制的数字人人像列表,接口鉴权和通用分页参数查阅:接口通用说明。
接口协议
GET /api/digitalhuman/open/v1/figure/lite2d/query
GET 请求参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
figureId | string | 否 | 指定人像ID查询,为空则查询该账号下所有人像 |
systemFigure | boolean | 否 | 是否查询平台的公共人像 1. 为空:查询全部 2. true:返回平台公共人像 3. false:返回定制人像 |
trainSuccess | boolean | 否 | 是否查询训练完成,状态可用的人像 1. 为空:不进行过滤 2. true:只返回可用人像(平台公共人像+训练成功状态的定制人像) 3. false:只返回排队中、训练中或训练失败的定制人像 |
pageNo | int | 否 | 页码,默认为1 |
pageSize | int | 否 | 每页容量,默认10 |
返回参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
figureId | string | 是 | 人像ID |
name | string | 是 | 数字人名称 |
customizeType | string | 是 | 定制类型 |
systemFigure | boolean | 是 | 是否是平台公共人像 |
gender | string | 是 | 性别 |
taskSubmitTime | string | 是 | 任务提交时间 |
templateImg | string | 是 | 数字人缩略图 |
pictureUrl | string | 是 | 参考图片地址(入参figureImageUrl对应的图片) |
templateVideoUrl | string | 是 | 训练视频URL |
resolutionWidth | int | 是 | 训练视频像宽 |
resolutionHeight | int | 是 | 训练视频像高 |
status | string | 是 | 状态 1. LINE_UP(排队中) 2. ACTIONING(动作生成中) 3. GENERATING(开始训练) 4. SUCCESS(成功) 5. FAILED(失败) |
failedCode | int | 否 | 失败错误码 |
failedMessage | string | 否 | 制作失败原因 |
请求示例
Plain
1GET /api/digitalhuman/open/v1/figure/lite2d/query?figureId=931
返回示例
JSON
1{
2 "code": 0,
3 "message": {
4 "global": "success"
5 },
6 "result": {
7 "pageNo": 1,
8 "pageSize": 100,
9 "totalCount": 87,
10 "result": [
11 {
12 "figureId": "267303",
13 "name": "数字人test2025-dong12",
14 "customizeType": "GENERATE_NO_ACTION",
15 "systemFigure": false,
16 "gender": "MALE",
17 "templateVideoUrl": "https://meta-human-editor-test.bj.bcebos.com/vid-rfcsnigdkfrszx8d.mp4",
18 "resolutionWidth": 1080,
19 "resolutionHeight": 1920,
20 "status": "SUCCESS",
21 "templateImg": "https://star-light-lite.cdn.bcebos.com/figure/video/fig-rfcrbxtg7ir6dura20250603_161448main.png",
22 "taskSubmitTime": "2025-06-03 16:13:24",
23 "failedCode": 0,
24 "pictureUrl": "https://open-api-test.bj.bcebos.com/%E7%94%9F%E6%88%90%E5%BC%8F%E6%B5%8B%E8%AF%95%2FSlide%2016_9%20-%201.png"
25 }
26 ]
27 },
28 "requestId": "fd48ba29-12ec-47b4-a959-69db7a5a1cbc",
29 "success": true
30}