FaceInfo
人脸信息
被如下接口引用：DescribeMaterialList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| X | Integer | 否 | 人脸框的横坐标 示例值：271 |
| Y | Integer | 否 | 人脸框的纵坐标 示例值：153 |
| Width | Integer | 否 | 人脸框的宽度 示例值：772 |
| Height | Integer | 否 | 人脸框的高度 示例值：634 |
FaceRect
人脸框信息
被如下接口引用：FuseFace, FuseFaceUltra。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| X | Integer | 是 | 人脸框左上角横坐标。 示例值：1 |
| Y | Integer | 是 | 人脸框左上角纵坐标。 示例值：1 |
| Width | Integer | 是 | 人脸框宽度。 示例值：30 |
| Height | Integer | 是 | 人脸框高度。 示例值：30 |
FuseParam
融合参数
被如下接口引用：FuseFace。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ImageCodecParam | ImageCodecParam | 否 | 图片编码参数 示例值：{} |
FusionUltraParam
高精度融合参数
被如下接口引用：FuseFaceUltra。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| WarpRadio | Float | 否 | 拉脸强度。主要用于调整生成结果人脸脸型更像素材模板还是用户人脸。取值越大越像用户人脸。 取值范围：0-1之间。默认取值0.7。 该参数仅对SwapModelType（模型类型）取值1-5生效 示例值：0.1 |
| EnhanceRadio | Float | 否 | 人脸增强强度。对整个人脸进行增强，增加清晰度，改善质量。当生成的人脸不够清晰，质感不够好的时候可以设置。取值越大增强强度越大。 取值范围：0-1之间。默认取值0.5。 该参数仅对SwapModelType（模型类型）取值1-5生效 示例值：0.8 |
| MpRadio | Float | 否 | 磨皮强度。当生成脸的图像面部显脏时，可进行设置。 取值范围：0-1之间。默认取值0.5。 该参数仅对SwapModelType（模型类型）取值1-5生效 示例值：0.8 |
| BlurRadio | Float | 否 | 人脸模糊开关（暂不支持） 当生成人脸比较清晰时，将人脸模糊到接近模板的清晰度的程度 该参数仅对SwapModelType（模型类型）取值1-5生效 示例值：1 |
| TeethEnhanceRadio | Float | 否 | 牙齿增强开关，默认取值为1 牙齿增强，修复牙齿。当生成牙齿不好（如牙齿裂开）可以打开此开关 0：牙齿增强关闭 1：牙齿增强打开 该参数仅对SwapModelType（模型类型）取值1-5生效 示例值：1 |
| MakeupTransferRadio | Float | 否 | 妆容迁移开关，默认取值为0。 将素材模板的妆容迁移到融合结果上。即：如果希望妆容效果与模板图保持一致，可以打开此开关。 0：妆容迁移关闭 1：妆容迁移打开 该参数仅对SwapModelType（模型类型）取值1-5生效 示例值：0 |
ImageCodecParam
图片编码参数
被如下接口引用：FuseFace。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| MetaData | Array of MetaData | 否 | 元数据是描述媒体文件的附加信息。通过添加自定义的元数据，可以将一些附加信息嵌入到文件中。这些信息可以用于版权、描述、标识等目的，并在后续的媒体处理或管理过程中使用。 个数不能大于1。 示例值：[] |
LogoParam
logo参数
被如下接口引用：FuseFace, FuseFaceUltra。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| LogoRect | FaceRect | 是 | 标识图片位于融合结果图中的坐标，将按照坐标对标识图片进行位置和大小的拉伸匹配。 Width、Height <= 2160。 示例值：{} |
| LogoUrl | String | 否 | 标识图片Url地址 ●base64 和 url 必须提供一个，如果都提供以 url 为准。 ●支持图片格式：支持jpg或png 专业版：base64 编码后大小不超过10M。 非专业版：base64 编码后大小不超过5M。 示例值：string |
| LogoImage | String | 否 | 输入图片base64。 ●base64 和 url 必须提供一个，如果都提供以 url 为准。 ●支持图片格式：支持jpg或png 专业版：base64 编码后大小不超过10M。 非专业版：base64 编码后大小不超过5M。 示例值：string |
MaterialFaces
人脸信息
被如下接口引用：DescribeMaterialList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| FaceId | String | 否 | 人脸序号 示例值：string |
| FaceInfo | FaceInfo | 否 | 人脸框信息 示例值：{} |
MergeInfo
人脸图片和待被融合的素材模板图的人脸位置信息。
被如下接口引用：FuseFace, FuseFaceUltra。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Image | String | 否 | 输入图片base64。 ●base64 和 url 必须提供一个，如果都提供以 url 为准。 ●素材图片限制：图片中面部尺寸大于34 * 34；图片尺寸大于64 * 64。（图片编码之后可能会大30%左右，建议合理控制图片大小）。 ●支持图片格式：支持jpg或png 示例值：string |
| Url | String | 否 | 输入图片url。 ●base64 和 url 必须提供一个，如果都提供以 url 为准。 ●素材图片限制：图片中面部尺寸大于34 * 34；图片尺寸大于64 * 64。（图片编码之后可能会大30%左右，建议合理控制图片大小）。 ●支持图片格式：支持jpg或png 示例值：string |
| InputImageFaceRect | FaceRect | 否 | 上传的图片人脸位置信息（人脸框） Width、Height >= 30。 示例值：{} |
| TemplateFaceID | String | 否 | 素材人脸ID，不填默认取最大人脸。 示例值：string |
| TemplateFaceRect | FaceRect | 否 | 模板中人脸位置信息(人脸框)，不填默认取最大人脸。此字段仅适用于图片融合自定义模板素材场景。 Width、Height >= 30。 |
MetaData
MetaData数据结构，Key/Value格式
被如下接口引用：FuseFace。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| MetaKey | String | 是 | MetaData的Key，字符长度不能超过32 示例值：string |
| MetaValue | String | 是 | MetaData的Value，字符长度不能超过256 示例值：string |
PublicMaterialInfos
素材信息
被如下接口引用：DescribeMaterialList。
| 名称 | 类型 | 描述 |
|---|---|---|
| MaterialId | String | 素材Id 示例值：mt_1858693821665306272 |
| MaterialStatus | Integer | 素材状态 字段取值: 0 审核中 1 人工审核通过 2 人工审核失败 3 申诉中 11 申诉成功 12 申诉失败 21 机器审核通过 22 机器审核失败 31 视频素材预处理成功，素材可用 32 视频素材预处理失败 33 角色不在视频中 示例值：21 |
| CreateTime | String | 创建时间 示例值：2023-11-19 10:08:34 |
| UpdateTime | String | 修改时间 示例值：2023-11-19 10:08:36 |
| MaterialFaceList | Array of MaterialFaces | 人脸信息 示例值：[{FaceId: "100", FaceInfo: {X: 57, Y: 57, Width: 123, Height: 169}}] |
| MaterialName | String | 素材名 示例值：测试素材 |
| AuditResult | String | 审核原因 示例值："审核不通过" |
