增加黑名单
更新时间：2025-08-14
POST
https://qianfan.baidubce.com/v2/ai_search/url_black_list
往黑名单中添加URL，用于检测和拦截访问，防止用户访问恶意或受限制的网站。
权限说明
调用本API，需使用API Key鉴权方式。Authorization的值为Bearer <API Key>。获取API Key流程，请查看授权。
注意事项
- 按照用户id（鉴权token对应的用户id）来区分过滤规则，某个用户id配置的规则，仅对该用户生效
- 调用网页黑名单接口的用户id要和调用问答接口的用户id保持一致
- 网页过滤发生在百度搜索之后，过滤掉的网页，不参与模型问答总结
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
black_item
object {1}
黑名单url内容
必选
显示子属性
隐藏子属性
url
string
按照url进行前缀匹配过滤，对应以下两种情况：
- 如果url设置为，https://unsafe.com/ ，则该站点下的所有网页均会被过滤
- 如果url设置为，https://zhidao.baidu.com/question/1.html， 则仅会过滤https://zhidao.baidu.com/question/1.html网页
必选
config_id
string
策略配置id，需要提前调用配置接口创建id
可选
请求结构
POST /v2/ai_search/url_black_list HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"black_item": {
"url": "https://zhidao.baidu.com/question/1506466702568519979.html"
}
}示例代码
curl
curl --location 'https://qianfan.baidubce.com/v2/ai_search/url_black_list' \
--header 'Authorization: Bearer <API Key>' \
--header 'X-Appbuilder-Authorization: <token>' \
--data '{
"black_item": {
"url": "https://zhidao.baidu.com/question/1***79.html"
}
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
request_id
string
请求request_id
必选
code
string
错误代码，当发生异常时返回
可选
message
string
错误消息，当发生异常时返回
可选
JSON
{"request_id": "123"}