智能多媒体服务

  • 智能多媒体服务 > API 文档 > Open API >versa 智能填充服务

    versa 智能填充服务

    最近更新时间: 2021-04-25 15:04:00

    智能填充服务(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元

    以上内容是否对您有帮助?
  • Qvm free helper
    Close