接口说明
功能描述
广告素材分析能力可以对素材图片中的人物（明星、素人、CG 人物）、场景等打上标签信息，可支持数千个内容标签，覆盖范围广。
- 阿里云视觉智能开放平台视觉 AI 能力 API 接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。
应用场景
- 广告分析：对互联网广告内容及投放效果的数据进行分析，为用户投放和分析广告提供参考。
- 精准投放：利用素材标签、用户画像实现广告内容的精准投放。
- 素材检索：能够快速检索定位指定类型的素材。
特色优势
- 分析能力强：分析处理后对包含明星、素人、CG 人物等复杂场景进行准确打标。
- 精准打标：可将物体、人物相关标签同步返回，并精准标记标签位置。
接入指引
-
注册阿里云账号：打开阿里云官网，在阿里云官网右上角，单击立即注册，按照操作提示完成账号注册。
-
创建 AccessKey：请确保您已创建 AccessKey，如果您使用的是子账号 AccessKey，您需要给子账号赋予 AliyunVIAPIFullAccess 权限，具体操作，请参见 RAM 授权。
-
在线调试（可选）：您可以通过OpenAPI Explorer在线调试能力，查看完整的调用示例代码及 SDK 依赖信息，也可以下载完整的工程。
-
开发接入步骤：
- 在 SDK 总览中选择您要接入使用的 SDK 语言。
- 在对应语言的 SDK 文档中找到 AI 类目为图像识别（imagerecog）的 SDK 包进行安装。
- 参考文档中提供的示例代码进行适当修改后调用。
-
示例代码：该能力常用语言的示例代码，请参见广告素材分析示例代码，常用语言查询异步任务结果的示例代码，请参见查询异步任务结果示例代码。
-
客户端直接调用：该能力常用的客户端调用方式包括以下几种。
输入限制
- 图像格式：JPEG、JPG、PNG、BMP。
- 图像大小：不超过 3 MB。
- 图像分辨率：大于 5×5 像素。
- URL 地址中不能包含中文字符。
计费说明
关于广告素材分析的计费方式及报价，请参见计费介绍。
调用步骤
该能力为异步能力，需分两步进行调用。 第一步调用 TaggingAdImage 接口提交任务，请求成功后，得到一个任务 ID。 第二步调用 GetAsyncJobResult 接口查询结果，根据任务 ID 查询任务执行状态和结果。如果任务还在处理中，可稍等一段时间后再进行查询。
流控信息
请求参数
| 字段名称 | 字段详情 |
|---|---|
ImageURLstring | 图像 URL 地址。推荐使用上海地域的 OSS 链接，对于文件在本地或者非上海地域 OSS 链接的情况，请参见文件 URL 处理。 示例值:https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/DetectImageElements/xxxx.png |
返回参数
| 字段名称 | 字段详情 |
|---|---|
RequestIdstring | 请求 ID。 示例值:572974F0-1014-5C60-97EE-DBFFC0FF7616 |
Dataobject | 返回的结果数据内容。展开详情 |
Messagestring | 提交异步任务后的提示信息。 示例值:该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。 |
返回说明
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 标签取值
查询结果
该接口为异步接口，当前并未返回真实的请求结果，您需要通过返回的 RequestId 调用 GetAsyncJobResult 接口来获取该接口的真实请求结果。详情请参见 GetAsyncJobResult 。
SDK 参考
阿里云视觉 AI 图像识别类目下的广告素材分析能力推荐使用 SDK 调用，支持多种编程语言，调用时请选择 AI 类目为图像识别（imagerecog）的 SDK 包，文件参数通过 SDK 调用可支持本地文件及任意 URL，具体可参见 SDK 总览。
示例代码
该能力常用语言的示例代码，请参见广告素材分析示例代码，常用语言查询异步任务结果的示例代码，请参见查询异步任务结果示例代码。
返回示例
错误码
变更历史
| 变更时间 | 变更内容概要 | 操作 | |
|---|---|---|---|
| 2022-10-17 | |||
| 2021-08-04 |