智能多媒体服务

  • 智能多媒体服务 > API 文档 > Open API >versa 实例分割服务

    versa 实例分割服务

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

    实例分割服务(mkr_seg_ins)能够有效的将图片中不同实例分别与背景分离。

    本服务由上海懿天网络科技有限公司(以下简称versa)提供。启用服务后,您的文件将在您主动请求的情况下被提供给马卡龙以供其计算使用。七牛不能保证结果的正确性,请您自行评估后选择是否启用。服务价格请您参考具体的服务价格,您使用本服务产生的费用由七牛代收。启用服务则表示您知晓并同意以上内容。

    注意

    • 服务地域:华东、华南。
    • 单张图片大小不超过 500KB。
    • 资源的 Mime 文件格式仅支持图片类型:image/*,如:image/jpeg、image/png。
    • 请求接口为标准的HTTP/HTTPS 协议。
    • 此服务有 QPS 限制,如需更高 QPS,请提交工单。

    如何开启

    如果您的文件存储在七牛云,则需先开启本服务。点此进入七牛开发者平台,点击右上角开始使用按钮。
    如果您的文件存储在其他地方,则直接调用本接口。

    图片存储在七牛使用方法

    请求

    请求语法

    GET <DownloadURI>?mkr_seg_ins
    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 separate data...
    }
    

    示例

    在Web浏览器中输入以下图片地址:

    https://dora-doc.qiniu.com/people_horse.jpeg?mkr_seg_ins/14,16 
    

    返回结果(内容经过格式化以便阅读)

    {	
    	request_id: "1d8675e063e33e4ae342de5c4e211b92",
    	result: [
    		{
    			description: "马",
    			key: "14",
    			target: [
    				{
    					url: "https://static01.versa-ai.com/images/segment/2019/11/22/d7a4943e-0cdb-11ea-85eb-0a58ac1a4d09.png"
    				},
    				{
    					url: "https://static01.versa-ai.com/images/segment/2019/11/22/d7d6f80c-0cdb-11ea-85eb-0a58ac1a4d09.png"
    				},
    				{
    					url: "https://static01.versa-ai.com/images/segment/2019/11/22/d806ad68-0cdb-11ea-85eb-0a58ac1a4d09.png"
    				},
    				{
    					url: "https://static01.versa-ai.com/images/segment/2019/11/22/d83542ea-0cdb-11ea-85eb-0a58ac1a4d09.png"
    				}
    			]
    		},
    		{
    			description: "人物",
    			key: "16",
    			target: [
    				{
    					url: "https://static01.versa-ai.com/images/segment/2019/11/22/d864428e-0cdb-11ea-85eb-0a58ac1a4d09.png"
    				},
    				{
    					url: "https://static01.versa-ai.com/images/segment/2019/11/22/d8949c86-0cdb-11ea-85eb-0a58ac1a4d09.png"
    				},
    				{
    					url: "https://static01.versa-ai.com/images/segment/2019/11/22/d8c4d928-0cdb-11ea-85eb-0a58ac1a4d09.png"
    				},
    				{
    					url: "https://static01.versa-ai.com/images/segment/2019/11/22/d8f4331c-0cdb-11ea-85eb-0a58ac1a4d09.png"
    				}
    			]
    		}
    	]
    }
    

    公共头响应头参数说明

    名称 类型 是否必填 描述
    request_id string Y 服务器请求ID
    result JSON对象 Y API(业务)相关的返回数据。出错情况下,该字段可能为空。一般来说,该字段为一个JSON结构体或数组,参见下表

    响应返回的 result 参数说明

    名称 类型 是否必填 描述
    description string Y 实例分割的名称
    key string Y 实例分割类型,编码表见下文档下《分割类别说明》
    target string Y 实例分割之后的图片地址

    实例分割类型说明

    编码 说明
    2 飞机
    4
    7 巴士
    8 轿车
    9
    11 奶牛
    13
    14
    15 摩托车
    16 人物
    18

    错误码说明

    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_ins.apistore.qiniu.com/handler?cmd=mkr_seg_ins/14,16&url= HTTP/1.1
    	Host: mkr_seg_ins.apistore.qiniu.com
    	Authorization: Qiniu <AccessToekn>
    

    示例

    	POST http://mkr_seg_ins.apistore.qiniu.com/handler?cmd=mkr_seg_ins/14,16&url=http://7xlv47.com0.z2.glb.clouddn.com/people_horse.jpeg HTTP/1.1
    	Host: mkr_seg_ins.apistore.qiniu.com
    	Authorization: Qiniu aWQ6lF1Zxxse43jB6V7lsdfaadf:7cWZPxxxxxasdffed60zkI8=
    	Content-Type: application/x-www-form-urlencoded; charset=utf-8
    

    请求头部

    头部名称 是否必选 说明
    Host 值必须为 mkr_seg_ins.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": "11f85b1f8cb048eb6ff045d95d5821ca",
    	"result": [
    	{
    		"description": "马",
    		"key": "14",
    		"target": [
    			{
    				"url": "https://static01.versa-ai.com/images/segment/2019/12/03/3910eee4-15be-11ea-a3ed-0a58ac1a073b.png"
    			},
    			{
    				"url": "https://static01.versa-ai.com/images/segment/2019/12/03/394611aa-15be-11ea-a3ed-0a58ac1a073b.png"
    			},
    			{
    				"url": "https://static01.versa-ai.com/images/segment/2019/12/03/397c333e-15be-11ea-a3ed-0a58ac1a073b.png"
    			},
    			{
    				"url": "https://static01.versa-ai.com/images/segment/2019/12/03/39b35e2c-15be-11ea-a3ed-0a58ac1a073b.png"
    			}
    			]
    	},
    	{
    		"description": "人物",
    		"key": "16",
    		"target": [
    		{
    			"url": "https://static01.versa-ai.com/images/segment/2019/12/03/39e892d6-15be-11ea-a3ed-0a58ac1a073b.png"
    		},
    		{
    			"url": "https://static01.versa-ai.com/images/segment/2019/12/03/3a1fc4c2-15be-11ea-a3ed-0a58ac1a073b.png"
    		},
    		{
    			"url": "https://static01.versa-ai.com/images/segment/2019/12/03/3a5a5da8-15be-11ea-a3ed-0a58ac1a073b.png"
    		},
    		{
    			"url": "https://static01.versa-ai.com/images/segment/2019/12/03/3a902fa0-15be-11ea-a3ed-0a58ac1a073b.png"
    		}
    		]
    	}
    	]
    }
    

    服务价格

    调用量( 次/月) 单价(元/次)
    ≤5万 0.083
    ≤30万 0.078
    ≤100万 0.073
    100万条以上 0.068

    计费示例

    某公司2019年5月使用该服务,共发起30万次请求,则当月使用该服务的费用为250000*0.078+50000*0.083=23650.0元

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