支持检测图像中的前景主体并识别轮廓，实现精细化背景分割抠图能力，对于镂空主体及复杂背景均有良好效果。目前默认开启审核。
| 名称 | 内容 |
|---|---|
图片要求 | 1. 图片格式：JPG、JPEG、PNG、BMP等常见格式，建议使用JPG格式。 |
| 名称 | 内容 |
|---|---|
| 接口地址 | https://visual.volcengineapi.com |
| 请求方式 | POST |
| Content-Type | application/x-www-form-urlencoded |
请求参数
（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 | 接口名，取值：HumanSegment |
| Version | 必选 | String | 版本号，取值：2020-08-26 |
（3）Body参数
业务请求参数
| 参数 | 可选/必选 | 类型 | 说明 |
|---|---|---|---|
| image_base64 | 必选（二选一，优先生效） | String | 图片文件，base64编码 |
| image_url | 必选（二选一） | String | 图片文件URL |
| refine | 可选（0或1） | int | 对图像边缘进行精细抠图 |
| return_foreground_image | 可选（0或1） | int | 是否返回前景人像图（透明背景） |
（1）通用输出参数
请参考通用返回字段及错误码
（2）业务输出参数
| 字段 | 类型 | 说明 | 备注 |
|---|---|---|---|
| mask | string | 返回通用分割图片的Base64编码 | |
| foreground_image | string | 人像前景图的base64编码。若return_foreground_image传入1，会返回此字段，否则不会。 |
（3）输出示例
{ "code":10000, "data":{ "mask": "", }, "message":"Success", "request_id":"6838889517957515275", "time_elapsed":"41.897331ms" }
备注
接口支持通过refine参数配置是否进行边缘精细抠图，0为不进行（默认），1为进行。进行抠图操作会增加接口耗时。
接口支持通过return_foreground_image参数配置是否返回返回前景人像图，0为不返回（默认），1为返回。返回前景人像图会增加接口耗时和带宽消耗。
（1）通用错误码
请参考通用返回字段及错误码
（2）业务错误码
| HttpCode | 错误码 | 错误消息 | 描述 |
|---|---|---|---|
| 200 | 10000 | 无 | 请求成功 |
| 400 | 60802 | "Human Segment Error" | 人体分割服务错误 |
| 400 | 60803 | "Invalid Input Image: image refine error" | 抠图服务错误 |