本文介绍广告素材分析TaggingAdImage的语法及示例。

功能描述

广告素材分析能力可以对素材图片中的人物(明星、素人、CG人物)、场景等打上标签信息,可支持数千个内容标签,覆盖范围广。

应用场景

  • 广告分析:对互联网广告内容及投放效果的数据进行分析,为用户投放和分析广告提供参考。
  • 精准投放:利用素材标签、用户画像实现广告内容的精准投放。
  • 素材检索:能够快速检索定位指定类型的素材。

特色优势

  • 分析能力强:分析处理后对包含明星、素人、CG人物等复杂场景进行准确打标。
  • 精准打标:可将物体、人物相关标签同步返回,并精准标记标签位置。

前提条件

  • 广告素材分析支持上海和呼和浩特地域(Region),默认不显示呼和浩特地域,如果您想使用呼和浩特地域,请添加钉钉群(23109592)联系技术支持开通呼和浩特白名单。
  • 请确保您已开通图像识别服务,若未开通服务请立即开通

输入限制

  • 图像格式:JPEG、JPG、PNG、BMP。
  • 图像大小:不超过3 MB。
  • 图像分辨率:大于5×5像素。
  • URL地址中不能包含中文字符。

计费说明

关于广告素材分析的计费方式及报价,请参见计费介绍

说明 下方调试接口为付费接口。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String TaggingAdImage

系统规定参数。取值:TaggingAdImage

ImageURL String https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/DetectImageElements/detect-elements-src.png

图像URL地址。当前仅支持上海和呼和浩特地域的OSS链接,如何生成URL请参见生成URL

返回数据

名称 类型 示例值 描述
RequestId String 572974F0-1014-5C60-97EE-DBFFC0FF7616

请求ID。

Data Object

返回的结果数据内容。

TagInfo Map

标签。目前仅输出scene(场景)和human(人)。具体取值请参见下表“TagInfo字段参数说明”。

TagInfo字段参数说明

字段

类型

是否必须

示例值

描述

Cloth_category

string

modern

如果为HumanInfo字段时,被识别的人物服饰标签。具体分类请参见下图“Category标签取值”。 如果为非HumanInfo字段时,可忽略此字段。

Cloth_category_score

float

0.8

如果为HumanInfo字段时,人物服饰标签置信度。取值范围 [0,1.0]。 如果为非HumanInfo字段时,可忽略此字段。

Bbox

list

[77,280,431,569]

表示视频中的元素出现的时间相对位置。

Score

float

0.9

标签置信度。取值范围 [0,1.0]。

Category

string

human-real-celebrity-古天乐

标签名称。具体分类请参见下图“Category标签取值”。

Category标签取值

Category标签取值

示例

请求示例

http(s)://[Endpoint]/?Action=TaggingAdImage
&ImageURL=https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/DetectImageElements/detect-elements-src.png
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<TaggingAdImageResponse>
    <RequestId>572974F0-1014-5C60-97EE-DBFFC0FF7616</RequestId>
    <Data>
        <TagInfo>
            <HumanInfo>
                <Category>human-cartoon</Category>
                <Score>0.8926303386688232</Score>
                <Bbox>247</Bbox>
                <Bbox>69</Bbox>
                <Bbox>615</Bbox>
                <Bbox>285</Bbox>
                <Cloth_category>ancient_costume</Cloth_category>
                <Cloth_category_score>0.7587000727653503</Cloth_category_score>
            </HumanInfo>
            <HumanInfo>
                <Category>human-cartoon</Category>
                <Score>0.7919902272874424</Score>
                <Bbox>181</Bbox>
                <Bbox>769</Bbox>
                <Bbox>653</Bbox>
                <Bbox>1062</Bbox>
                <Cloth_category>ancient_costume</Cloth_category>
                <Cloth_category_score>0.9455268979072571</Cloth_category_score>
            </HumanInfo>
            <HumanInfo>
                <Category>human-cartoon</Category>
                <Score>0.8589029694131511</Score>
                <Bbox>258</Bbox>
                <Bbox>1003</Bbox>
                <Bbox>664</Bbox>
                <Bbox>1253</Bbox>
            </HumanInfo>
            <HumanInfo>
                <Category>human-real-celebrity-张雨绮</Category>
                <Score>0.8367555733614154</Score>
                <Bbox>53</Bbox>
                <Bbox>299</Bbox>
                <Bbox>671</Bbox>
                <Bbox>890</Bbox>
                <Cloth_category>ancient_costume</Cloth_category>
                <Cloth_category_score>0.9510607719421387</Cloth_category_score>
            </HumanInfo>
            <HumanInfo>
                <Category>human-cartoon</Category>
                <Score>0.762352211722046</Score>
                <Bbox>149</Bbox>
                <Bbox>259</Bbox>
                <Bbox>619</Bbox>
                <Bbox>470</Bbox>
                <Cloth_category>ancient_costume</Cloth_category>
                <Cloth_category_score>0.9933518171310425</Cloth_category_score>
            </HumanInfo>
            <sceneInfo>
                <Category>gamescreen-gameeffect</Category>
                <Score>0.8965355645041235</Score>
            </sceneInfo>
            <objectInfo>
                <Category>weapon</Category>
                <Score>0.843801736831665</Score>
                <Bbox>191</Bbox>
                <Bbox>774</Bbox>
                <Bbox>621</Bbox>
                <Bbox>1010</Bbox>
            </objectInfo>
        </TagInfo>
    </Data>
</TaggingAdImageResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "572974F0-1014-5C60-97EE-DBFFC0FF7616",
  "Data" : {
    "TagInfo" : {
      "HumanInfo" : [ {
        "Category" : "human-cartoon",
        "Score" : 0.8926303386688232,
        "Bbox" : [ 247, 69, 615, 285 ],
        "Cloth_category" : "ancient_costume",
        "Cloth_category_score" : 0.7587000727653503
      }, {
        "Category" : "human-cartoon",
        "Score" : 0.7919902272874424,
        "Bbox" : [ 181, 769, 653, 1062 ],
        "Cloth_category" : "ancient_costume",
        "Cloth_category_score" : 0.9455268979072571
      }, {
        "Category" : "human-cartoon",
        "Score" : 0.8589029694131511,
        "Bbox" : [ 258, 1003, 664, 1253 ]
      }, {
        "Category" : "human-real-celebrity-张雨绮",
        "Score" : 0.8367555733614154,
        "Bbox" : [ 53, 299, 671, 890 ],
        "Cloth_category" : "ancient_costume",
        "Cloth_category_score" : 0.9510607719421387
      }, {
        "Category" : "human-cartoon",
        "Score" : 0.762352211722046,
        "Bbox" : [ 149, 259, 619, 470 ],
        "Cloth_category" : "ancient_costume",
        "Cloth_category_score" : 0.9933518171310425
      } ],
      "sceneInfo" : {
        "Category" : "gamescreen-gameeffect",
        "Score" : 0.8965355645041235
      },
      "objectInfo" : {
        "Category" : "weapon",
        "Score" : 0.843801736831665,
        "Bbox" : [ 191, 774, 621, 1010 ]
      }
    }
  }
}

查询任务结果

该接口为异步接口,当前并未返回真实的请求结果,您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见查询异步任务结果

错误码

关于广告素材分析的错误码,详情请参见常见错误码

SDK参考

阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。