Logo识别 - 阿里云视觉智能开放平台

功能描述

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	检测结果的分类。包括： normal：正常图片 TV：带有台标logo的图片 trademark：带商标logo的图片
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	结果为该分类的概率，取值范围为`[0.00-100.00]`。值越高表示属于该分类的概率越大。
Suggestion	String	pass	建议您执行的操作。包括： pass：图片正常，无需进行其余操作。 review：检测结果不确定，需要进行人工审核。 block：图片违规，建议执行进一步操作。
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&amp;quality=80&amp;size=b9999_10000&amp;sec=1581676601873&amp;di=bfed0d4b5295f2ebb3ed90afaefb0865&amp;imgtype=0&amp;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小时后会被系统自动清理删除。