有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

功能概述

腾讯云数据万象通过 RecognizeLogo 接口实现对图片内电商 Logo 的识别,返回图片中 Logo 的名称、坐标、置信度分值,返回图片中 Logo 的名称、坐标、置信度分值。
注意:
本接口属于 GET 请求,为同步请求方式,需携带签名,具体签名设置请参见 请求签名

授权说明

通过子账号使用时,需要授予 ci:CreateRecognizeLogoJob权限,详情请参见 数据万象 action

服务开通

使用该功能需提前开通数据万象,并绑定存储桶。详情请参见 绑定存储桶
使用该功能需提前通过控制台或接口开通 AI 内容识别服务 。详情请参见 开通 AI 内容识别服务

使用限制

使用该接口时,请先确认相关限制条件。详情请参见 使用限制

费用说明

该接口为付费服务,产生的费用将由数据万象收取,详细计费说明可参见 内容识别费用


请求

请求语法

GET /?ci-process=RecognizeLogo&detect-url=<detect-url> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
说明:
Authorization:Auth String,详情请参见 请求签名 文档。

请求内容

参数名称
描述
类型
是否必选
ci-process
数据万象处理能力,Logo 识别固定为 RecognizeLogo
String
detect-url
待检查图片 url,需要进行 url encode
String

请求头

此接口仅使用公共请求头部,详情请参见 公共请求头部 文档。

请求体

该请求无请求体。

响应

响应头

此接口仅返回公共响应头部,详情请参见 公共响应头部 文档。

响应体

该响应体返回为 application/xml 数据,具体的数据内容如下:
节点名称(关键字)
父节点
描述
类型
RecognitionResult
保存 Logo 识别结果的容器
Container
Response 的内容:
节点名称(关键字)
父节点
描述
类型
Status
RecognitionResult
Logo 识别结果。0表示未识别到,1表示识别到
Int
LogoInfo
RecognitionResult
Logo 识别结果,可能有多个
Container
LogoInfo 节点内容:
节点名称(关键字)
父节点
描述
类型
Name
LogoInfo
Logo 的名称
String
Sorce
LogoInfo
Logo 的置信度,取值范围为[0-100]。值越高概率越大。
Int
Location
LogoInfo
图中识别到 Logo 的坐标
Container
Location 节点内容:
节点名称(关键字)
父节点
描述
类型
Point
Location
Logo 坐标点(X坐标,Y坐标)
String

示例

请求

GET /?ci-process=RecognizeLogo&detect-url=xxx HTTP/1.1
Host: examplebucket-1250000000.cos.ap-chengdu.myqcloud.com
Date: xxxxx
Authorization:XXXXXXXXXXXX

响应

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 414641
Date: xxxxxx
Server: tencent-ci
x-cos-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhfMjc=

<RecognitionResult>
<Status>1</Status>
<LogoInfo>
<Name>xxxxxxxx</Name>
<Sorce>99</Sorce>
<Location>
<Point>100,100</Point>
<Point>100,200</Point>
<Point>200,200</Point>
<Point>200,100</Point>
</Location>
</LogoInfo>
<LogoInfo>
<Name>xxxxxxxx</Name>
<Sorce>95</Sorce>
<Location>
<Point>1000,1000</Point>
<Point>1000,2000</Point>
<Point>2000,2000</Point>
<Point>2000,1000</Point>
</Location>
</LogoInfo>
</RecognitionResult>