功能描述
图像分割用于识别输入图像中的人体轮廓,与背景进行分离,返回分割后的前景人像图(4通道),适用于单人、多人、复杂背景、各类人体姿态等场景。
应用场景
- 人像摄影:人体分割通过将摄影主体人物从背景中分割出来,将背景虚化,以达到大光圈浅景深效果,突出人物主体。
- 视频会议:在视频会议中,参会者所处环境背景不方便播出,或背景涉及到信息安全时,可将参会者人像从背景中分割出,替换成合适的背景。
- 证件照制作:上传或拍摄一张生活照,可将背景替换成白、蓝或红色背景,成为一张标准的证件照。
输入限制
- 图片格式:JPEG、JPG、PNG(不支持8位、16位、64位PNG)、BMP、WEBP。
- 图像大小:输入图像大小不超过3M。
- 图像分辨率:分辨率要求小于1280×1280像素。
- URL地址中不能包含中文字符。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | SegmentBody | 要执行的操作。取值:SegmentBody。 |
ImageURL | String | 是 | https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/SegmentBody/%E4%BA%BA%E5%83%8F%E5%88%86%E5%89%B2.png | 图片URL地址。 |
Async | Boolean | 否 | false | 是否异步获取结果,默认为false。false:同步获取结果。true:异步获取结果。提交请求后,需要调用GetAsyncJobResult接口获取结果。 |
ReturnForm | String | 否 | mask | 指定返回的图像形式。如果设置为mask,则返回单通道mask。如果不设置或者设置为任意非mask值,则返回四通道png图。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
ImageURL | String | http://xxxx.oss-cn-shanghai.aliyuncs.com/临时地址 | 结果图像URL地址,有效期30分钟。 |
RequestId | String | 30EDCEEA-2806-44C6-AF0B-0988849106FE | 请求ID。 |
示例
先安装相关模块
pip install aliyun-python-sdk-imageseg
示例代码:
#!/usr/bin/env python
#coding=utf-8
from aliyunsdkcore.client import AcsClient
from aliyunsdkcore.acs_exception.exceptions import ClientException
from aliyunsdkcore.acs_exception.exceptions import ServerException
from aliyunsdkimageseg.request.v20191230.SegmentBodyRequest import SegmentBodyRequest
client = AcsClient('<accessKeyId>', '<accessSecret>', 'cn-shanghai')
request = SegmentBodyRequest()
request.set_accept_format('json')
request.set_ImageURL("http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageseg/SegmentBody/SegmentBody1.png")
response = client.do_action_with_exception(request)
# python2: print(response)
print(str(response, encoding='utf-8'))
返回的json值:
{
"success": true,
"data": {
"data": {
"RequestId": "ADB204F2-0E77-4C15-9220-0E2C126BC630",
"Data": {
"ImageURL": "http://viapi-cn-shanghai-dha-segmenter.oss-cn-shanghai.aliyuncs.com/upload/result_humansegmenter/2021-3-23/invi_humansegmenter_016164812955262366360_XAQg3x.png?Expires=1616483095&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRpDvh1&Signature=8bNh7r4e390Bs9cEBWtemeYcqvc%3D"
}
},
"url": "https://imageseg.cn-shanghai.aliyuncs.com/",
"during": 273,
"headers": {
"response": {
"date": "Tue, 23 Mar 2021 06:34:55 GMT",
"content-type": "application/json;charset=utf-8",
"content-length": "334",
"connection": "keep-alive",
"access-control-allow-origin": "*",
"access-control-allow-methods": "POST, GET, OPTIONS",
"access-control-allow-headers": "X-Requested-With, X-Sequence, _aop_secret, _aop_signature",
"access-control-max-age": "172800",
"x-acs-request-id": "ADB204F2-0E77-4C15-9220-0E2C126BC630"
}
}
},
"requestId": "a86e0c84-22d5-4934-b2e1-2a80e1ff5394"
}
视频教程
阿里云高校计划,陪伴两千多所高校在校生云上实践、云上成长。在这里你可以领用免费的cpu资源,还可以参加免费训练营,实践提高:https://developer.aliyun.com/adc/student/