1 使用说明

1.1 使用流程

1、形象定制：本文档为照片数字人形象定制接口文档，服务端调用数字人开放平台“形象定制-照片数字人”接口，上传人像照片获取形象包文件。已生成形象包需要通过SDK驱动使用，不可单独使用。

2、SDK调用：客户端或页面集成端渲染交互组件-照片数字人SDK加载形象包，本地驱动渲染数字人。支持音频和文本驱动。音频可以使用真人音频或自行接入的第三方TTS的音频。文本驱动时 SDK 内部会调用数字人开放平台 TTS 服务驱动数字人。

1.2 照片要求

注意：输入的照片需符合以下规范，否则形象包渲染效果可能异常

• 图片格式：png，jpg
• 分辨率：建议人脸区域不超过256*256px
• 照片要求：

1、照片清晰，光线自然。

2、人脸无遮挡、五官无遮挡。

3、直面镜头，人脸各方向转角控制在15°以内，不能出现侧脸、歪头、低头、仰头等情况。

4、不露牙齿，人脸表情尽量放松，避免抿嘴、张嘴等情况，允许小幅度微笑。

5、避免人物头部穿戴复杂头饰、帽子。

6、避免出现丸子头、马尾等高颅顶发型。

7、避免人物头发过于蓬松。

8、避免使用动漫人物等单线条唇形，需保证人物图片具备正常的真人唇型，否则无法保证效果。

1.3 购买入口：

组件商店：https://xiling.cloud.baidu.com/open/widgetStore/list

2 接口说明

接口调用地址：https://open.xiling.baidu.com 使用图片训练人像包

1. 调用人像包训练接口，提交图片，返回任务ID
2. 调用人像包查询接口，提交任务ID，获取训练信息，包含状态及人像包地址等

接口鉴权和通用字段说明请查阅：接口通用说明

3 接口列表

3.1 提交人像训练接口

3.1.1 接口说明

调用人像包训练接口，提交图片，返回任务ID

3.1.2 接口协议

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

3.1.3 请求参数

3.1.4 回调参数

• type: PICTURE_FIGURE_ADD
• data:

• 参数名	类型	是否必填	描述
  taskId	string	是	任务ID
  status	string	是	状态：
  failedCode	int	否	失败错误码
  failedMessage	string	否	失败错误信息
  figureUrl	string	否	形象包文件地址，文件会保存 7 天

• SUCCESS（合成成功）
• FAILED（合成失败）

3.1.5 返回参数

3.1.6 请求示例

{
    "requestId": "xxxx11",
    "figureImageUrl": "https://meta-human-editor-prd.cdn.bcebos.com/ca1d70b6f73d44bebd2aba1f3deb60bb/draftThumbnail/dt-qfdkzu6nhawzayqb5.png",
    "callbackUrl": "http://api-gateway:8080/api/digitalhuman/internal/api-gateway/v1/callback/vp/test"
}

3.1.7 返回示例

{
    "code": 0,
    "message": {
        "global": "success"
    },
    "result": {
        "taskId": "fig-qgti819vzahqxpb3",
    },
    "requestId": "xxxx11",
    "success": true
}

3.1.8 错误码

3.2 查询任务

3.2.1 接口说明

使用任务ID查询任务状态

3.2.2 接口协议

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

3.2.3 GET 请求参数

3.2.4 返回参数

• SUBMIT（已提交待合成）
• GENERATING（合成中）
• SUCCESS（合成成功）
• FAILED（合成失败）

3.2.5 请求示例

GET /api/digitalhuman/open/v1/figure/image/task?taskId=abc123&requestId=123e4567-e89b-12d3-a456-426614174000

3.2.6 返回示例

{
    "code": 0,
    "message": {
        "global": "success"
    },
    "result": {
        "taskId": "fig-qgti819vzahqxpb3",
        "status": "GENERATING",
        "failedCode": 0,
        "failedMessage": "",
        "figureUrl": null,
        "createTime": "2024-07-18T08:17:56",
        "updateTime": "2024-07-18T08:17:56"
    },
    "requestId": "fdc66116-762d-4a82-a082-e83357a3167e",
    "success": true
}