在线调试
您可以在 API Explorer 中调试该接口，可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。
请求说明
请求示例
HTTP 方法：POST
请求URL： https://aip.baidubce.com/rest/2.0/image-classify/v1/body_seg
URL参数：
| 参数 | 值 |
|---|---|
| access_token | 通过API Key和Secret Key获取的access_token，参考“Access Token获取” |
Header如下：
| 参数 | 值 |
|---|---|
| Content-Type | application/x-www-form-urlencoded |
Body中放置请求参数，参数详情如下：
请求参数
| 参数 | 是否必选 | 类型 | 可选值范围 | 说明 |
|---|---|---|---|---|
| image | 是 | string | - | 图像数据，base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M。图片的base64编码是不包含图片头的，如(data:image/jpg;base64,)，支持图片格式：jpg、bmp、png，最短边至少50px，最长边最大4096px |
| type | 否 | string | labelmap,scoremap,foreground |
可以通过设置type参数，自主设置返回哪些结果图，避免造成带宽的浪费 1）可选值说明： labelmap - 二值图像，需二次处理方能查看分割效果 scoremap - 人像前景灰度图 foreground - 人像前景抠图，透明背景 2）type 参数值可以是可选值的组合，用逗号分隔；如果无此参数默认输出全部3类结果图 |
请求代码示例
提示一：使用示例代码前，请记得替换其中的示例Token、图片地址或Base64信息。
提示二：部分语言依赖的类或库，请在代码注释中查看下载地址。
人像分割 curl -i -k 'https://aip.baidubce.com/rest/2.0/image-classify/
v1/body_seg?access_token=【调用鉴权接口获取的token】' --data 'image=【图片Base64编码，
需UrlEncode】' -H 'Content-Type:application/x-www-form-urlencoded'
返回说明
返回参数
| 字段 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
| labelmap | 否 | string | 分割结果图片，base64编码之后的二值图像，需二次处理方能查看分割效果 |
| scoremap | 否 | string | 分割后人像前景的scoremap，归一到0-255，不用进行二次处理，直接解码保存图片即可。Base64编码后的灰度图文件，图片中每个像素点的灰度值 = 置信度 * 255，置信度为原图对应像素点位于人体轮廓内的置信度，取值范围[0, 1] |
| foreground | 否 | string | 分割后的人像前景抠图，透明背景，Base64编码后的png格式图片，不用进行二次处理，直接解码保存图片即可。将置信度大于0.5的像素抠出来，并通过image matting技术消除锯齿 |
| person_num | 是 | int32 | 检测到的人体框数目 |
| person_info | 否 | object[] | 人体框信息 |
| +height | 否 | float | 人体区域的高度，注意当值为0时 数据类型为int |
| +left | 否 | float | 人体区域离左边界的距离，注意当值为0时 数据类型为int |
| +top | 否 | float | 人体区域离上边界的距离，注意当值为0时 数据类型为int |
| +width | 否 | float | 人体区域的宽度，注意当值为0时 数据类型为int |
| +score | 否 | float | 人体框的概率分数，取值0-1，，注意当值为0时 数据类型为int |
返回示例
{
"log_id": 2451426617428943180,
"labelmap": "iVBORw0KGg",
"scoremap": "iVBORw0KGg"
"foreground": "iVBORw0KGg",
"person_num": 2,
"person_info": [
{
"height": 420.9641110897064,
"width": 365.67474365234375,
"top": 3.704406976699829,
"score": 0.9801973104476929,
"left": 229.32940673828125
},
{
"height": 371.6713676452637,
"width": 167.91799926757812,
"top": 49.91801834106445,
"score": 0.4228516221046448,
"left": 470.4878234863281
}
],
}
