跳到主要内容

提交定制人像数字人

1.接口说明​

请求该接口提供自定义人像数字人的训练素材，创建自定义人像数字人模型训练任务，定制用户自己的人像数字人。

2.请求地址​

https://digitbot.bokecc.com/api/portrait/custom/create

3.请求方式​

POST application/json

4.请求参数​

(1).公共参数，参考服务说明​

(2).接口参数​

①.Query参数：通过URL参数传递。​

参数名类型必需说明
versionString是接口版本号，当前支持版本：1.0.0、1.3.0。

②.Body参数：通过请求Body传递，JSON格式。​

参数名类型必需说明版本说明
typeInteger否人像定制类型，枚举值。0=专属口型人像；2=图片数字人；4=通用口型人像。1.0.0：不支持该参数，定制人像为专属口型人像数字人1.3.0起：该参数必需，定制指定类型的人像数字人
nameString是数字人名称，最长支持20个字符。同一个账号下的人像数字人名称不允许重复。
genderInteger是数字人性别，枚举值。0=女；1=男。
materialUrlString是训练素材地址。包含人物形像的视频文件链接。type=0、4时：训练素材为包含人像的视频文件，支持mp4、mov等格式。type=2时：训练素材为包含人像的图片文件，支持jpeg、jpg、png等格式。
mattingInteger否人像类型，枚举值。0=实景；1=绿幕；2=普通。实景：训练素材视频为实物背景，不需要人像抠图，提取完整的视频帧做为人像图片。绿幕：训练素材视频为绿幕背景，需要人像抠图，生成透明背景的人像图片。普通：训练素材视频为实物背景，需要人像抠图，生成透明背景的人像图片。1.0.0：该参数必需1.3.0起：type=0、4时必需，type=2时无效
facialFeatureInteger否图片数字人面部特征，枚举值。1=真人；2=卡通。type=2时必需。1.0.0：不支持该参数1.3.0起：type=2时必需；type=0、4时无效
callbackUrlString否训练结果回调地址。不传值或地址无效时，不发起回调请求。

5.请求示例​

POST https://digitbot.bokecc.com/api/portrait/custom/create?accountId=xxx&version=1.0.0&hash=xxx&time=xxx HTTP/1.1
{
    "type": 2,
    "name": "测试图片数字人定制",
    "gender": 1,
    "materialUrl": "https://xxxxx.xxxx/xxx.mp4",
    "matting": 1,
    "facialFeature": 1,
    "callbackUrl": "https://xxxxx.xxxxxx/xxxx"
}

6.响应示例​


{
    "id": "xxx"
}

7.响应说明​

字段名类型说明
idString数字人ID。