versa 人像分割服务
人物分割服务（mkr_seg_human）能够帮您有效的把图片中人物与背景单独分离开。
本服务由上海懿天网络科技有限公司（以下简称versa）提供。启用服务后，您的文件将在您主动请求的情况下被提供给马卡龙以供其计算使用。七牛不能保证结果的正确性，请您自行评估后选择是否启用。服务价格请您参考具体的服务价格，您使用本服务产生的费用由七牛代收。启用服务则表示您知晓并同意以上内容。
注意
- 服务地域：华东、华南。
- 单张图片大小不超过 500KB。
- 资源的 Mime 文件格式仅支持图片类型：image/*，如：image/jpeg、image/png。
- 请求接口为标准的HTTP/HTTPS 协议。
- 此服务有 QPS 限制，如需更高 QPS，请提交工单。
如何开启
如果您的文件存储在七牛云，则需先开启本服务。点此进入七牛开发者平台，点击右上角开始使用按钮。
如果您的文件存储在其他地方，则直接调用本接口。
图片存储在七牛使用方法
请求
请求语法
GET <DownloadURI>?mkr_seg_human
Host: <DownloadHost>
请求参数
| 头部名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| DownloadURI | string | N | 用于人物分割的图片链接 |
响应
响应语法
HTTP/1.1 200 OK
X-Reqid: <reqid>
Date: <respTime>
Content-Length: <contentLength>
Content-Type: application/json; charset=utf-8
{
// ...segment human data...
}
示例
在Web浏览器中输入以下图片地址：
https://dora-doc.qiniu.com/people_sheep.jpeg?mkr_seg_human
返回结果（内容经过格式化以便阅读）
{
"mask_url: "https://static01.versa-ai.com/images/segment/2019/11/13/0acfec48-05eb-11ea-988d-0a58ac1a3a48.png",
"request_id: "1a04cb18e6a82d8f446118f34bb98519",
"target_url: "https://static01.versa-ai.com/images/detect/2019/11/13/0ac7720c-05eb-11ea-988d-0a58ac1a3a48.png"
}
公共头响应头参数说明
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| request_id | string | Y | 服务器请求ID |
| target_url | string | Y | 原始图片中分割出的人物图片 |
| mask_url | string | Y | 原始图片中分割出的人物图片的灰度图 |
错误码说明
| code | message | 说明 |
|---|---|---|
| 201 | No Access Request | 无访问权限 |
| 202 | The Request API is Limit Rate | 请求API被限流 |
| 1002 | API Service Param Request Error | API服务参数请求异常（参数异常请求） |
| 1003 | Human Segment Error | 人物分割服务异常 |
| 1004 | Too Many People Segment | 人物分割服务调用人数过多 |
| 1005 | No characters detected | 未检测到人物 |
| 1006 | Request Picture Exception Or Exceed Maximum Size Limit | 图片异常或超过最大size限制 |
图片不存储在七牛使用方法
请求
请求语法
POST http://mkr_seg_human.apistore.qiniu.com/handler?cmd=mkr_seg_human&url= HTTP/1.1
Host: mkr_seg_human.apistore.qiniu.com
Authorization: Qiniu <AccessToekn>
示例
POST http://mkr_seg_human.apistore.qiniu.com/handler?cmd=mkr_seg_human&url=https://www.baidu.com/img/bd_logo1.png HTTP/1.1
Host: mkr_seg_human.apistore.qiniu.com
Authorization: Qiniu aWQ6lF1Zxxse43jB6V7lsdfaadf:7cWZPxxxxxasdffed60zkI8=
Content-Type: application/x-www-form-urlencoded; charset=utf-8
请求头部
| 头部名称 | 是否必选 | 说明 |
|---|---|---|
| Host | 是 | 值必须为 mkr_seg_human.apistore.qiniu.com |
| Authorization | 是 | 参考 HTTP鉴权 |
响应语法
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{
// ...response data...
}
响应头部
| 头部名称 | 是否必选 | 说明 |
|---|---|---|
| Content-Type | 是 | MIME 类型，固定为 application/json |
响应内容
如果请求成功，返回包含如下内容的 JSON 字符串（已格式化，便于阅读):
{
"mask_url": "https://static01.versa-ai.com/images/segment/2019/12/03/f598826c-15bd-11ea-988d-0a58ac1a3a48.png",
"request_id": "d42a1f5230747ed9ca2b4354a5092350",
"target_url": "https://static01.versa-ai.com/images/detect/2019/12/03/f5928934-15bd-11ea-988d-0a58ac1a3a48.png"
}
服务价格
| 调用量（ 次/月） | 单价（元／次） |
|---|---|
| ≤5万 | 0.051 |
| ≤30万 | 0.046 |
| ≤100万 | 0.042 |
| 100万条以上 | 0.037 |
计费示例
某公司2019年5月使用该服务，共发起30万次请求，则当月使用该服务的费用为250000*0.046+50000*0.051=14050.0元
文档反馈
(如有产品使用问题，请 提交工单)
售前 
售后 