2D端渲染形象定制（大屏版）

更新时间：2025-12-22

产品介绍

使用流程

本文档为2D端渲染形象定制接口文档，服务端调用数字人开放平台“形象定制-2D端渲染形象定制”接口上传静默视频、说话视频和通道视频即可获取形象加密包文件。已生成形象加密包需要通过SDK驱动使用，不可单独使用
SDK调用：客户端或页面集成2D数字人交互SDK-Android版加载形象加密包本地驱动渲染数字人。支持音频和文本驱动。音频可以使用真人音频或自行接入的第三方TTS的音频。文本驱动时 SDK 内部会调用数字人开放平台 TTS 服务驱动数字人。

拍摄指南

2D端渲染形象定制拍摄指南

购买入口

组件商店：

接口说明

接口调用域名：https://open.xiling.baidu.com

调用人像包训练接口，提交视频，返回任务ID
调用人像包查询接口，提交任务ID，获取训练信息，包含状态及人像包地址等
接口鉴权和通用字段说明请查阅：接口通用说明

接口列表

提交人像训练接口

接口说明

调用人像包训练接口，提交静默视频、说话视频和通道视频，返回任务ID

接口协议

POST /api/digitalhuman/open/v1/figure/video2d/create
Content-Type: application/json;charset=utf-8

请求

格式

                JSON
                
            

                {
    "name": "$name",
    "templateVideoId": "$fileID or $URL",
    "lipVideoId": "$fileID or $URL",
    "maskVideoId": "$fileID or $URL",
    "callbackUrl": "$callback_URL"
}
            

说明

参数	类型	必填	说明
name	string	是	数字人名称命名要求： 1. 账户内名称唯一 2. 仅可输入中文、字母、数字、中划线、下划线 3. 不超过20个字符
templateVideoId	string	是	素材文件ID支持两种方式： 1. 底板视频素材文件 ID，使用文件上传接口上传视频文件获取文件ID，providerType：OPEN_CUSTOMIZATION_EDGE_2D 2. 支持上传公网URL 视频要求： 1. 拍摄内容：嘴巴闭上，身体为自然状态（头部、身体有轻微的律动），无嘴部动作、不露牙 2. 视频时长：10s～4min（最大） 3. 视频格式：mp4 4. 分辨率：建议1080p 5. 尺寸: 竖屏9:16 6. 帧率: 25FPS 7. 大小：700M以内 8. 高码率（具体数值不做限制）
lipVideoId	string	是	素材文件ID支持两种方式： 1. 唇动视频素材文件 ID，使用文件上传接口上传视频文件获取文件ID，providerType：OPEN_CUSTOMIZATION_EDGE_2D 2. 支持上传公网URL 视频要求： 1. 拍摄内容：人物身体+嘴部为自然说话状态，可以提前准备一个4分钟的演讲稿（自我介绍、讲故事），最好能脱稿，脸部清晰，无遮挡 2. 视频时长：10s～4min（最大） 3. 视频格式：mp4 4. 分辨率：建议1080p 5. 尺寸: 竖屏9:16 6. 帧率: 25FPS 7. 大小：700M以内 8. 高码率（具体数值不做限制）
maskVideoId	string	否	素材文件ID支持两种方式： 1. 底板视频对应的mask视频（人像遮罩视频）文件 ID，mask视频处理说明，使用文件上传接口接口上传视频文件获取文件ID，providerType：OPEN_CUSTOMIZATION_EDGE_2D 2. 支持上传公网URL 视频要求： 1. 内容与动作视频保持一致，用上述动作视频制作导出透明通道视频 2. 视频格式：mp4（最大） 3. 分辨率：建议1080p 4. 尺寸: 竖屏9:16 5. 帧率: 25FPS 6. 大小：700M以内 7. 高码率（具体数值不做限制）
callbackUrl	string	否	接口调用方接受任务回调通知的url，规则和接口说明参考接口通用说明，回调消息定义如下表。

回调参数

参数	类型	必填	说明
taskid	string	是	任务ID
status	string	是	状态：1. SUBMIT（排队中） 2. GENERATING（训练中） 3. SUCCESS（成功） 4. FAILED（失败)
failedCode	int	否	失败错误码
failedMessage	string	否	失败错误信息
figureUrl	string	否	形象加密包文件地址，文件会保存7天，SDK支持相应解密
createTime	string	是	创建时间，示例：2024-04-29T20:28:06

响应

格式

成功

                JSON
                
            

                {
    "code": 0,
    "message": {
        "global": "success"
    },
    "result": {
        "taskId": "v2d-xxx"
    },
    "requestId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "success": true
}
            

失败

                JSON
                
            

                {
    "code": 10006,
    "message": {
        "global": "底板视频无法识别，请检查是否是一个视频文件"
    },
    "result": null,
    "requestId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "success": false
}
            

说明

参数	类型	必填	说明
code	number	是	响应码, 0:成功，非0失败
global	object	是	消息内容
taskId	string	是	任务ID
requestId	string	是	请求Id
success	bool	是	请求是否成功

响应码

code	说明
0	成功
10006	参数基础校验错误，参考global具体消息
20037	视频比例校验失败
20038	模板校验异常，视频时长校验失败
20047	视频格式校验失败
20048	视频帧率校验失败
21001	形象包训练任务提交异常
22009	数字人名称已存在

查询任务

接口说明

使用任务ID查询任务状态

接口协议

GET /api/digitalhuman/open/v1/figure/video2d/task

GET请求参数

参数	类型	必填	说明
taskid	string	否	指定任务ID查询，为空则查询该账号下所有2D端渲染形象定制任务

返回参数

格式

                JSON
                
            

                {
    "code": 0,
    "message": {
        "global": "success"
    },
    "result": {
        "taskId": "v2d-xxxxxxxxxxxxxxxx",
        "status": "SUCCESS",
        "failedCode": 0,
        "figureUrl": "https://***.enc",
        "templateVideoUrl": "https://***.mp4",
        "lipVideoUrl": "https://***.mp4",
        "createTime": "2025-12-16T19:06:41"
    },
    "requestId": "dc40fba5-09fe-4d15-8fc5-f80b9c284dd2",
    "success": true
}
            

说明

参数	类型	必填	说明
code	number	是	响应码
global	string	是	消息内容
taskId	string	是	任务ID
status	string	是	状态： 1. WAIT（排队中） 2. GENERATING（训练中） 3. SUCCESS（训练成功） 4. FAILED（训练失败)
failedCode	int	否	失败错误码
figureUrl	string	否	形象加密包文件地址，文件会保存7天
templateVideoUrl	string	是	底板视频URL
lipVideoId	string	是	唇动视频URL
maskVideoId	string	否	mask视频URL
createTime	string	是	创建时间，示例：2024-04-29T20:28:06
requestId	string	是	请求Id
success	bool	是	请求是否成功

响应码

code	说明
0	成功
10	任务不存在
5016	任务排队超时，已自动结束，请稍后重试

2D端渲染数字人（拍摄指南）

视频组件接入手册

百度智能云

数字员工-开放平台

数字员工-开放平台

2D端渲染形象定制（大屏版）

产品介绍

使用流程

拍摄指南

购买入口

接口说明

接口列表

提交人像训练接口

接口说明

接口协议

请求

格式

说明

回调参数

响应

格式

说明

响应码

查询任务

接口说明

接口协议

GET请求参数

返回参数

格式

说明

响应码