versa 智能填充服务
智能填充服务（mkr_inpainting）能够有效的将图像中的指定区域进行修复重建或者去除图像中的多余物体。
本服务由上海懿天网络科技有限公司（以下简称versa）提供。启用服务后，您的文件将在您主动请求的情况下被提供给马卡龙以供其计算使用。七牛不能保证结果的正确性，请您自行评估后选择是否启用。服务价格请您参考具体的服务价格，您使用本服务产生的费用由七牛代收。启用服务则表示您知晓并同意以上内容。
注意
-
服务地域：华东、华南。
-
单张图片大小不超过 500KB。
-
资源的 Mime 文件格式仅支持图片类型：image/*，如：image/jpeg、image/png。
-
请求接口为标准的HTTP/HTTPS 协议。
-
此服务有 QPS 限制，如需更高 QPS，请提交工单。
如何开启
如果您的文件存储在七牛云，则需先开启本服务。点此进入七牛开发者平台，点击右上角开始使用按钮。
如果您的文件存储在其他地方，则直接调用本接口。
图片存储在七牛使用方法
请求
请求语法
GET <DownloadURI>?mkr_inpainting
Host: <DownloadHost>
请求参数
| 头部名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| DownloadURI | string | N | 用于智能填充的图片链接 |
响应
响应语法
HTTP/1.1 200 OK
Content-Type: application/json
{
// ...inpainting matting data...
}
示例一
对原图指定区域进行修复，指定方式：将需要修复部分以外的区域的透明度设置为100%（alpha值设为0）。
将图片上传到七牛存储，获取存储链接作为智能填充的输入源，加上mkr_inpainting，获取处理结果。
示例二
先对原图进行人像分割或者实物分割处理，来去除图像中多余物体，如下：
https://dora-doc.qiniu.com/people_sheep.jpeg?mkr_seg_human
点击返回结果的 target_url ，将去除物体的图片上传到七牛存储，获取存储链接作为智能填充的输入源，在Web浏览器中输入以下图片地址
https://dora-doc.qiniu.com/bbd8bf24-0cd0-11ea-988d-0a58ac1a3a48.png?mkr_inpainting
返回结果（内容经过格式化以便阅读）
{
request_id: "13bcd78b3da4d7227983603da4e94624",
target_url: "https://static01.versa-ai.com/images/inpainting/2019/11/22/24582f96-0cd4-11ea-9544-0a58ac1a150f.jpg"
}
公共头响应头参数说明
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| request_id | string | Y | 服务器请求ID |
| target_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 | Transfer Image Error | 智能融合服务异常 |
| 1004 | Too Many People Transfer Image | 智能融合服务调用人数过多 |
| 1005 | No characters detected | 未检测到人物 |
| 1006 | Request Picture Exception Or Exceed Maximum Size Limit | 请求图片异常或超过最大size限制 |
图片不存储在七牛使用方法
请求
请求语法
POST http://mkr_inpainting.apistore.qiniu.com/handler?cmd=mkr_inpainting&url= HTTP/1.1
Host: mkr_inpainting.apistore.qiniu.com
Authorization: Qiniu <AccessToekn>
示例
POST http://mkr_inpainting.apistore.qiniu.com/handler?cmd=mkr_inpainting&url=https://dora-doc.qiniu.com/bbd8bf24-0cd0-11ea-988d-0a58ac1a3a48.png HTTP/1.1
Host: mkr_inpainting.apistore.qiniu.com
Authorization: Qiniu aWQ6lF1Zxxse43jB6V7lsdfaadf:7cWZPxxxxxasdffed60zkI8=
Content-Type: application/x-www-form-urlencoded; charset=utf-8
请求头部
| 头部名称 | 是否必选 | 说明 |
|---|---|---|
| Host | 是 | 值必须为 mkr_inpainting.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 字符串（已格式化，便于阅读):
{
"request_id": "21988ae6d13ab0f50c0e184e91fac60d",
"target_url": "https://static01.versa-ai.com/images/inpainting/2019/12/03/a17569d8-15be-11ea-9eb3-0a58ac1a1254.jpg"
}
服务价格
| 调用量（ 次/月） | 单价（元／次） |
|---|---|
| ≤5万 | 0.043 |
| ≤30万 | 0.038 |
| ≤100万 | 0.033 |
| 100万条以上 | 0.028 |
计费示例
某公司2019年5月使用该服务，共发起30万次请求，则当月使用该服务的费用为250000*0.038+50000*0.043=11650.0元
文档反馈
(如有产品使用问题，请 提交工单)
售前 
售后 