广告素材质量审核
更新时间:2026-03-27
概述
支持基于输入的文本、图片或视频内容,对广告素材进行自动标签识别与标注,便于内容分类与管理。
接口定义
| URL | https://qianfan.baidubce.com/v2/tools/ad_material_review |
|---|---|
| Method | POST |
Headers
| 字段 | 值 |
|---|---|
| Authorization | Bearer {ApiKey} |
| Content-Type | application/json |
| X-Appbuilder-Request-Id | UUID # 非必填项,最好传一个,因为链路追踪会用到该字段 |
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| parameters | dict | 是 | 调用传参,具体见下文Parameters对象定义 |
Parameters对象
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| texts | str[] | 否 | 文案文本,当前支持一个文本,传多只会按第一个处理 |
| pic_urls | str[] | 否 | 图片URL列表,当前支持三张图url,传多只会按前三个处理 |
| video_urls | str[] | 否 | 视频URL,当前支持一个视频url,传多只会按第一个处理 |
| pic_ground_urls | str[] | 否 | 落地页URL,当前支持一个落地页url,传多只会按第一个处理 |
备注:参数 texts、pic_urls、video_urls、pic_ground_urls 中,至少需有一个不为空。
请求示例
Bash
1curl --request POST \
2 --url https://qianfan.baidubce.com/v2/tools/ad_material_review \
3 --header 'authorization: Bearer xxxxxx' \
4 --header 'content-type: application/json' \
5 --data '{
6 "parameters": {
7 "texts": ["领带"],
8 "pic_urls": ["https://image-c.weimobwmc.com/ol-6NpxG/7ca49d22c9584aba9140972990aeaff3.png"],
9 "video_urls": ["https://image-c.weimobwmc.com/ol-6NpxG/7ca49d22c9584aba9140972990aeaff3.mp4"],
10 "pic_ground_urls": ["https://image-c.weimobwmc.com/ol-6NpxG/index.html"],
11 }
12}'
响应参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| requestId | string | 是 | 请求ID |
| code | string | 否 | 错误代码,当发生异常时返回 |
| message | string | 否 | 错误消息,当发生异常时返回 |
| status | string | 是 | 当前对话状态: done:对话结束。 error:执行过程发生错误。 |
| content | list[Content] | 否 | 当前工具返回内容的主要payload,List[Content],每个 Content 包括了当前 event 的元素。 |
Content对象
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | string | 是 | 代表event 类型。固定值:text |
| text | dict object | 是 | 代表当前 event 元素的内容。 |
| event | dict | 是 | 标识返回内容的结构、顺序、状态,具体见下文Event对象定义。 |
text 对象定义
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| info | string | 是 | 输出的text类型的文本内容 |
Event对象
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| status | string | 是 | 事件执行状态。枚举值: |
error:错误。 done:执行完成。| |error_code|string|否|错误码。| |error_message|string|否|错误细节。|
响应示例
YAML
1{
2 "code": "",
3 "message": "",
4 "status": "done",
5 "content": [
6 {
7 "type": "text",
8 "text": {
9 "info": '{"score": {"textQuality": 2, "materialAesthetics": 1, "landingPageQuality": 0, "relevance": 2}, "reason":
10{"landingPageQuality": "原因", "textQuality": "原因", "materialAesthetics": "原因", "relevance": "原因"}}'
11 },
12 "event": {
13 "status": "done",
14 "error_code": "",
15 "error_message": ""
16 }
17 }
18 ],
19 "requestId": ""
20}
info字段定义:
| 类:字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| textQuality(score) | number | 是 | 文案质量打分(示例中当前评分为2)。 |
| materialAesthetics(score) | number | 是 | 素材美观度打分(示例中当前评分为1)。 |
| landingPageQuality(score) | number | 是 | 落地页质量打分(示例中当前评分为0)。 |
| relevance(score) | number | 是 | 相关性打分(示例中当前评分为2)。 |
| textQuality(reason) | string | 否 | 文案质量评分原因,用于说明textQuality(score)字段评分的具体依据、理由,对应数据格式中reason下的textQuality字段。 |
| materialAesthetics(reason) | string | 否 | 素材美观度评分原因,用于说明materialAesthetics(score)字段评分的具体依据、理由,对应数据格式中reason下的materialAesthetics字段。 |
| landingPageQuality(reason) | string | 否 | 落地页质量评分原因,用于说明landingPageQuality(score)字段评分的具体依据、理由,对应数据格式中reason下的landingPageQuality字段(示例中标注为“原因”)。 |
| relevance(reason) | string | 否 | 相关性评分原因,用于说明relevance(score)字段评分的具体依据、理由,对应数据格式中reason下的relevance字段。 |
| 返回字段 | 含义 |
|---|---|
| 0 | 低 |
| 1 | 中 |
| 2 | 高 |
异常响应参数
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| requestID | str | 是 | 请求ID |
| code | str | 否 | 0 表示成功,其他都是异常 |
| message | str | 否 | 错误消息 |
| detail | str | 否 | 异常详情信息 |
评价此篇文章
