智能多媒体服务

  • 智能多媒体 > API Reference > Open API >versa 人像分割服务

    versa 人像分割服务

    最近更新时间:2019-12-04 17:10:03

    人物分割服务(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浏览器中输入以下图片地址:

    http://7xlv47.com0.z0.glb.clouddn.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元

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