智能多媒体服务 > 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元

以上内容是否对您有帮助？