广告素材质量审核
更新时间:2026-04-30
POST
https://qianfan.baidubce.com/v2/tools/ad_material_review
本接口支持基于输入的文本、图片或视频内容,对广告素材进行自动标签识别与标注,便于内容分类与管理。
权限说明
调用本文API,需使用API Key鉴权方式。使用API Key鉴权调用API流程,具体调用流程,请查看认证鉴权。
请求参数
Headers 参数
除公共头域外,无其它特殊头域
Body 参数
parameters
object {4}
调用传参。
注意:texts、pic_urls、video_urls、pic_ground_urls 中至少需有一个不为空。
必选
显示子属性
隐藏子属性
texts
array
文案文本列表,当前支持一个文本,传多只会按第一个处理。
可选
显示子属性
隐藏子属性
items
string
pic_urls
array
图片URL列表,当前支持三张图URL,传多只会按前三个处理。
可选
显示子属性
隐藏子属性
items
string
video_urls
array
视频URL列表,当前支持一个视频URL,传多只会按第一个处理。
可选
显示子属性
隐藏子属性
items
string
pic_ground_urls
array
落地页URL列表,当前支持一个落地页URL,传多只会按第一个处理。
可选
显示子属性
隐藏子属性
items
string
请求结构
POST /v2/tools/ad_material_review HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"parameters": {
"texts": ["领带"],
"pic_urls": ["https://image-c.weimobwmc.com/ol-6NpxG/7ca49d22c9584aba9140972990aeaff3.png"],
"video_urls": ["https://image-c.weimobwmc.com/ol-6NpxG/7ca49d22c9584aba9140972990aeaff3.mp4"],
"pic_ground_urls": ["https://image-c.weimobwmc.com/ol-6NpxG/index.html"]
}
}
示例代码
请求示例
curl --request POST \
--url https://qianfan.baidubce.com/v2/tools/ad_material_review \
--header 'authorization: Bearer xxxxxx' \
--header 'content-type: application/json' \
--data '{
"parameters": {
"texts": ["领带"],
"pic_urls": ["https://image-c.weimobwmc.com/ol-6NpxG/7ca49d22c9584aba9140972990aeaff3.png"],
"video_urls": ["https://image-c.weimobwmc.com/ol-6NpxG/7ca49d22c9584aba9140972990aeaff3.mp4"],
"pic_ground_urls": ["https://image-c.weimobwmc.com/ol-6NpxG/index.html"]
}
}'
返回响应
Headers 参数
除公共头域外,无其它特殊头域
返回参数
code
string
错误代码,当发生异常时返回。
可选
message
string
错误消息,当发生异常时返回。
可选
status
string
当前对话状态。done:对话结束;error:执行过程发生错误。
可选
content
array
当前工具返回内容的主要payload,每个元素包含当前event的内容。
可选
显示子属性
隐藏子属性
items
object {3}
Content对象,包含当前event的元素。
显示子属性
隐藏子属性
type
string
代表event类型,固定值:text。
可选
text
object {1}
代表当前event元素的内容。
可选
显示子属性
隐藏子属性
info
string
输出的text类型的文本内容。
可选
event
object {3}
标识返回内容的结构、顺序、状态。
可选
显示子属性
隐藏子属性
status
string
事件执行状态。done:执行完成;error:错误。
可选
error_code
string
错误码,当发生错误时返回。
可选
error_message
string
错误细节,当发生错误时返回。
可选
requestId
string
请求ID。
可选
响应示例
{
"code": "",
"message": "",
"status": "done",
"content": [
{
"type": "text",
"text": {
"info": "{\"score\": {\"textQuality\": 2, \"materialAesthetics\": 1, \"landingPageQuality\": 0, \"relevance\": 2}, \"reason\": {\"landingPageQuality\": \"原因\", \"textQuality\": \"原因\", \"materialAesthetics\": \"原因\", \"relevance\": \"原因\"}}"
},
"event": {
"status": "done",
"error_code": "",
"error_message": ""
}
}
],
"requestId": ""
}
评价此篇文章
