本文档介绍图像识别(imagerecog)类目下的Logo识别RecognizeLogo的语法及示例。
服务说明
Logo识别(RecognizeLogo)服务将于2023年3月20日起停止更新,后续不再支持新用户开通接入服务,新用户请使用内容审核类目中的图片Logo检测服务。2023年3月20日之后,会继续支持老用户,老用户如果对Logo识别服务使用有疑问,可通过搜索钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。
功能描述
Logo识别能力可以对提交的图片进行检测,识别图片中包含的logo信息(主要是台标和商标)。
输入限制
- 图像格式:PNG、JPG、JPEG、BMP、GIF、WEBP。
- 图像大小:不超过10 MB。如您有大图需求,请通过钉钉群(23109592)联系我们。
- 图像分辨率:建议不低于256×256像素,像素过低可能会影响识别效果。
- URL地址中不能包含中文字符。
检测说明
- 最长检测时间是6秒,如果在该时间限制内没有完成检测,系统会强制返回超时错误码。
- 图像下载时间限制为3秒,如果下载时间超过3秒,返回下载超时。
- 图像检测接口响应时间依赖图像的下载时间。请保证被检测图像所在的存储服务稳定可靠,建议您使用阿里云OSS存储或者CDN缓存等。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | RecognizeLogo | 系统规定参数。取值:RecognizeLogo。 |
Tasks.N.ImageURL | String | 是 | http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imagerecog/RecognizeLogo/RecognizeLogo1.jpg | 待检测图像的URL。推荐使用上海地域的OSS链接,对于文件在本地或者非上海地域OSS链接的情况,请参见文件URL处理。 说明 对于该接口,系统会自动将OSS链接地址转成内网地址然后再下载文件,所以调用该接口并不会产生OSS流量计费。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 915D534B-F2AF-47A1-B6ED-398AEEC22AD3 | 请求ID。 |
Data | Object | 返回的结果数据内容。 |
|
Elements | Array of Element | 返回结果元素。 |
|
ImageURL | String | http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imagerecog/RecognizeLogo/RecognizeLogo1.jpg | 对应请求中的URL。 |
TaskId | String | img4wOvPu9L4vx4woAw1Kc4dD-1vuK3u | 该检测任务的ID。 |
Results | Array of Result | 返回结果。调用成功时(code=200),返回结果中包含一个或多个元素。每个元素是个结构体。 |
|
Suggestion | String | pass | 建议您执行的操作。包括:
|
LogosData | Array of LogoData | 图片中含有logo时,返回识别出来的logo信息。 |
|
Type | String | TV | 识别出的logo类型,取值为TV或trademark。 |
W | Float | 124 | logo区域宽度。 |
H | Float | 106 | logo区域高度。 |
Y | Float | 59 | 以图片左上角为坐标原点,logo区域左上角到x轴距离。 |
Name | String | 优酷英文 | 识别出的logo名称。 |
X | Float | 107 | 以图片左上角为坐标原点,logo区域左上角到y轴距离。 |
Label | String | TV | 检测结果的分类。包括:
|
Rate | Float | 99.86 | 结果为该分类的概率,取值范围为 |
示例
请求示例
http(s)://imagerecog.cn-shanghai.aliyuncs.com/?Action=RecognizeLogo //更多关于访问域名(Endpoint)信息,请参见:https://help.aliyun.com/document_detail/143103.html
&Tasks.1.ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imagerecog/RecognizeLogo/RecognizeLogo1.jpg
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<RecognizeLogoResponse>
<RequestId>7D615CDA-8FA9-55CB-93FA-A5B31A920E14</RequestId>
<Data>
<Elements>
<TaskId>img4wOvPu9L4vx4woAw1Kc4dD-1vuK3u</TaskId>
<Results>
<Suggestion>block</Suggestion>
<Rate>99.33</Rate>
<LogosData>
<Type>TV</Type>
<W>164</W>
<H>24</H>
<X>757</X>
<Y>29</Y>
<Name>优酷英文</Name>
</LogosData>
<Label>TV</Label>
</Results>
<ImageURL>http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imagerecog/RecognizeLogo/RecognizeLogo1.jpg</ImageURL>
</Elements>
</Data>
</RecognizeLogoResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "7D615CDA-8FA9-55CB-93FA-A5B31A920E14",
"Data" : {
"Elements" : {
"TaskId" : "img4wOvPu9L4vx4woAw1Kc4dD-1vuK3u",
"Results" : {
"Suggestion" : "block",
"Rate" : 99.33,
"LogosData" : {
"Type" : "TV",
"W" : 164,
"H" : 24,
"X" : 757,
"Y" : 29,
"Name" : "优酷英文"
},
"Label" : "TV"
},
"ImageURL" : "http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imagerecog/RecognizeLogo/RecognizeLogo1.jpg"
}
}
}
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。