有奖捉虫:云通信与企业服务文档专题,速来> HOT

功能描述

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

授权说明

授权策略中 action 设置为 ci:CreateRecognizeLogoJob 。查看所有 action

服务开通

使用该功能需提前开通数据万象,并绑定存储桶。详情请参见 绑定存储桶

使用限制

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

费用说明

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

请求语法

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(详情请参见 请求签名 文档)。
通过子账号使用时,需要授予相关的权限,详情请参见 授权粒度详情 文档。

请求内容

参数名称
描述
类型
是否必选
ObjectKey
对象文件名,例如:folder/document.jpg。
String
ci-process
数据万象处理能力,Logo 识别固定为 RecognizeLogo。
String
detect-url
您可以通过填写 detect-url 处理任意公网可访问的图片链接。不填写 detect-url 时,后台会默认处理 ObjectKey ,填写了 detect-url 时,后台会处理 detect-url 链接,无需再填写 ObjectKeydetect-url 示例:http://www.example.com/abc.jpg ,需要进行 UrlEncode,处理后为http%25253A%25252F%25252Fwww.example.com%25252Fabc.jpg
String
ignore-error
当此参数为1时,针对文件过大等导致处理失败的场景,会直接返回原图而不报错。
int
注意
通过 ObjectKey 进行商品抠图为内网操作,不会产生额外的外网流量。
通过 detect-url 进行商品抠图,会产生图片所在源站对应的外网流量。

请求头

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

请求体

该请求无请求体。

响应

响应头

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

响应体

该响应体返回为 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]。值越高概率越大。
String
Location
LogoInfo
图中识别到 Logo 的坐标。
Container
Location 节点内容:
节点名称(关键字)
父节点
描述
类型
Point
Location
Logo 坐标点(X 坐标,Y 坐标)。
String

实际案例

案例一:对存储桶内的图片进行 Logo 识别

内容识别相关接口需要携带签名访问,并与获取参数以“&”连接,示例如下:
https://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?q-sign-algorithm=<signature>?ci-process=RecognizeLogo
说明
<signature>为签名部分,获取方式请参考 请求签名

响应示例

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>

案例二:对第三方图片进行 Logo 识别

将第三方图片(链接为http://www.example.com/abc.jpg)在下载时进行 Logo 识别,示例如下:
https://examples-1251000004.cos.ap-shanghai.myqcloud.com/?q-sign-algorithm=<signature>?ci-process=RecognizeLogo&detect-url=http%25253A%25252F%25252Fwww.example.com%25252Fabc.jpg