最近更新时间:2024.01.24 17:28:33
首次发布时间:2023.11.10 15:58:13
针对单人写真场景的定制版本,支持对画质和美颜程度的调节,不支持多人及选脸融合,如有此类需求建议使用公测版本。
支持对模版图和素材图中的人像进行图片融合操作,返回融合后的图片。
名称 | 内容 |
---|---|
图片要求 | 图片格式:JPG(JPEG), PNG, BMP 等常见格式, 建议使用JPG格式. 目标图片要求: 1. 图片像素尺寸:最小 128 x 128 像素,最大 4096 x 4096 像素 2. 不支持黑白图片 3. 图片文件大小:目标图片需小于 5 MB 4. 人脸像素尺寸:为了保证融合效果,推荐图片中人脸框(正方形)边长的最小值不低于200像素。 5. 人脸质量:人脸质量越高,则融合效果越好。 6. 影响人脸质量的因素包括:对人脸五官的遮挡、不当的光照(强光、暗光、逆光)、过大的人脸角度(推荐 yaw ≤ ±20°, pitch ≤ ±20°)等。 模版要求: 1. 素材需要有版权, 有肖像权, 没有法律或者政策风险的. 相关风险请注意评估. 2. 注意对于脸部比较特殊的素材, 如眼睛过大等卡通风格的图片,效果可能不佳 3. 模板图片需小于 5 MB,图片像素宽高不宜过大, 模板图最长边强制不能超过 4096. 4. 图片中脸部像素面积不宜过小(至少200*200, 过小换脸会不清晰), 也不宜过大(脸部面积像素大小和速度正相关, 过大会影响速度). 5. 注意图片质量, 保证脸部足够清晰, 不应该有因为压缩导致的噪声, 否则会降低结果图质量 6. 为了更好的效果,模板图脸部应该尽可能正脸,yaw角度要求最高(建议正负10度内),pitch角度其次(建议正负20度内),roll角度(正负30度内)。 |
名称 | 内容 |
---|---|
接口地址 | https://visual.volcengineapi.com |
请求方式 | POST |
Content-Type | application/json |
请求参数
(1)header请求参数
公共请求参数
以下请求参数列表仅列出了接口请求参数和必要公共参数,完整公共参数列表见 公共参数
名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
X-Date | String | 是 | 使用UTC时间,精确到秒。请使用格式:YYYYMMDD'T'HHMMSS'Z' ,例如:20201103T104027Z |
Authorization | String | 是 | HMAC-SHA256:签名方法 |
X-Security-Token | String | 否 | 指安全令牌服务(Security Token Service,STS) 颁发的临时安全凭证中的SessionToken,使用长期密钥时无需填写该参数。 |
(2)Query请求参数
业务请求参数
参数 | 可选/必选 | 类型 | 说明 |
---|---|---|---|
Action | 必选 | String | 接口名,取值:FaceswapAI |
Version | 必选 | String | 版本号,取值:2022-08-31 |
(3)Body参数
业务请求参数
参数 | 可选/必选 | 类型 | 说明 |
---|---|---|---|
req_key | 必选 | String | 算法名称,取固定值为faceswap_ai |
binary_data_base64 | 必选(二选一,优先生效) | Array of String | List长度为2,输入两张图,将第一张图人脸融入第二张图,即第一张为目标图第二张为模板图 |
image_urls | 必选(二选一) | Array of String | List长度为2,输入两张图,将第一张图人脸融入第二张图,即第一张为目标图第二张为模板图 |
do_risk | 可选 | Boolean | 是否需要审核。True为需要,False不需要 |
gpen | 必选 | Float | 高清效果,支持[0, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1] |
skin | 必选 | Float | 美化效果,支持[0, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1] |
tou_repair | 可选 | int | 特殊处理,[0, 1] |
备注:美颜写真感更强的话,推荐高清效果参数在0.6~0.8,美化效果参数在0.4~0.8;与素材图片更相似的话,推荐高清效果参数0.6~0.8,美化效果参数在0.1~0.4。具体效果建议根据图片模板情况,多次调节参数对比后进行参数固定。
(4)请求示例
{ "req_key": "faceswap_ai", //"binary_data_base64": ["/9xxx","/9xxx"], "image_urls": ["http://","http://"], "do_risk": true, "gpen": 0.9, "skin": 0.1, }
(1)通用输出参数
请参考通用返回字段及错误码
(2)业务输出参数
data 字段说明
字段 | 类型 | 说明 | 备注 |
---|---|---|---|
binary_data_base64 | Array of String | 输出处理后的图片Base64数组(单张图) |
(3)输出示例
{ "code":10000, "data":{ "binary_data_base64": ["/9xxx"],//生成图base64 }, "message":"Success", "request_id":"xxx", "status":10000, "time_elapsed":"xxx" }
(1)通用错误码
请参考通用返回字段及错误码
(2)业务错误码
http code | 错误码 | 错误信息 | 说明 |
---|---|---|---|
200 | 10000 | Success | 成功 |