本文档介绍Logo识别RecognizeLogo的语法及示例。
功能描述
RecognizeLogo可以对提交的图片进行检测,识别图片中包含的logo信息(主要是台标和商标)。
前提条件
输入限制
- 图片格式:PNG、JPG、JPEG、BMP、GIF、WEBP。
- 图片大小:不超过10MB。如您有大图需求,请提工单申请。
- 图片像素:建议不低于256×256像素,像素过低可能会影响识别效果。
- 图片URL地址中不能包含中文字符。
检测说明
- 最长检测时间是6秒,如果在该时间限制内没有完成检测,系统会强制返回超时错误码。
- 图片下载时间限制为3秒,如果下载时间超过3秒,返回下载超时。
- 图片检测接口响应时间依赖图片的下载时间。请保证被检测图片所在的存储服务稳定可靠,建议您使用阿里云OSS存储或者CDN缓存等。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | RecognizeLogo |
要执行的操作。取值:RecognizeLogo。 |
Tasks.N.ImageURL | String | 是 | https://xxx.jpg |
待检测图像的URL。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL。 说明 对于该接口,系统会自动将OSS链接地址转成内网地址然后再下载文件,所以调用该接口并不会产生OSS流量计费。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Data | Struct |
返回的结果数据内容。 |
|
Elements | Array of Element |
返回结果元素。 |
|
ImageURL | String | https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1581676601873&di=bfed0d4b5295f2ebb3ed90afaefb0865&imgtype=0&src=http%3A%2F%2Fi2.hdslb.com%2Fbfs%2Farchive%2Fef0efdecb6cf68c75c965f5660c12215c5c2787b.jpg |
对应请求中的URL。 |
Results | Array of Result |
返回结果。调用成功时(code=200),返回结果中包含一个或多个元素。每个元素是个结构体。 |
|
Label | String | TV |
检测结果的分类。包括:
|
LogosData | Array of LogoData |
图片中含有logo时,返回识别出来的logo信息。 |
|
H | Float | 106 |
logo区域高度。 |
Name | String | 江苏台 |
识别出的logo名称。 |
Type | String | TV |
识别出的logo类型,取值为TV或trademark。 |
W | Float | 124 |
logo区域宽度。 |
X | Float | 107 |
以图片左上角为坐标原点,logo区域左上角到y轴距离。 |
Y | Float | 59 |
以图片左上角为坐标原点,logo区域左上角到x轴距离。 |
Rate | Float | 99.86 |
结果为该分类的概率,取值范围为 |
Suggestion | String | pass |
建议您执行的操作。包括:
|
TaskId | String | img1U@gSds24HA5eFyejlCLz5-1s834d |
该检测任务的ID。 |
RequestId | String | 915D534B-F2AF-47A1-B6ED-398AEEC22AD3 |
请求ID。 |
示例
请求示例
http(s)://imagerecog.cn-shanghai.aliyuncs.com/?Action=RecognizeLogo
&Tasks.1.ImageURL=https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1581676601873&di=bfed0d4b5295f2ebb3ed90afaefb0865&imgtype=0&src=http%3A%2F%2Fi2.hdslb.com%2Fbfs%2Farchive%2Fef0efdecb6cf68c75c965f5660c12215c5c2787b.jpg
&<公共请求参数>
正常返回示例
XML
格式
<RequestId>915D534B-F2AF-47A1-B6ED-398AEEC22AD3</RequestId>
<Data>
<Elements>
<TaskId>img1U@gSds24HA5eFyejlCLz5-1s834d</TaskId>
<Results>
<Rate>99.86</Rate>
<LogosData>
<Type>TV</Type>
<W>124</W>
<X>107</X>
<H>106</H>
<Y>59</Y>
<Name>江苏台</Name>
</LogosData>
<Label>TV</Label>
</Results>
<ImageURL>https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1581676601873&di=bfed0d4b5295f2ebb3ed90afaefb0865&imgtype=0&src=http%3A%2F%2Fi2.hdslb.com%2Fbfs%2Farchive%2Fef0efdecb6cf68c75c965f5660c12215c5c2787b.jpg</ImageURL>
</Elements>
</Data>
JSON
格式
{
"RequestId": "915D534B-F2AF-47A1-B6ED-398AEEC22AD3",
"Data": {
"Elements": [
{
"TaskId": "img1U@gSds24HA5eFyejlCLz5-1s834d",
"Results": [
{
"Rate": 99.86,
"LogosData": [
{
"Type": "TV",
"W": 124,
"X": 107,
"H": 106,
"Y": 59,
"Name": "江苏台"
}
],
"Label": "TV"
}
],
"ImageURL": "https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1581676601873&di=bfed0d4b5295f2ebb3ed90afaefb0865&imgtype=0&src=http%3A%2F%2Fi2.hdslb.com%2Fbfs%2Farchive%2Fef0efdecb6cf68c75c965f5660c12215c5c2787b.jpg"
}
]
}
}
错误码
关于Logo识别的错误码,详情请参见常见错误码。
SDK参考
阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。
在文档使用中是否遇到以下问题
更多建议
匿名提交