智能搜索生成

更新时间：2025-11-04

能力描述

概述：可根据用户输入query搜索全网实时信息后，并进行智能总结回答。

计费：每日免费额度为100次，支持按量后付费（为不影响使用体验，可先去开通后付费），默认优先抵扣免费资源。智能搜索生成的免费额度以及总调用上限，与百度搜索共享，且每个账号每天最多使用100,000次，如有更多调用需求请您联系我们进行开通，费用详情请查看计费说明。

使用方式： API、组件、MCP、SDK

在线调试

百度智能云千帆提供了API在线调试平台，平台集成了快速检索、查看开发文档、查看在线调用的请求内容和返回结果、复制和下载示例代码等功能，帮助开发者快速调试接口。

接口定义

URL	/v2/ai_search/chat/completions
Method	POST
Content-Type	application/json
Authorization	请求签名(Bearer <AppBuilder API Key>)

请求结构

POST /v2/ai_search/chat/completions HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <AppBuilder API Key>
Content-Type: application/json
{
    "messages": [
        {
            "content": "近日油价调整消息。",
            "role": "user"
        }
    ],
    "stream": false,
    "model": "ernie-3.5-8k",
    "instruction": "##",
    "enable_corner_markers": true,
    "enable_deep_search": true
}

请求参数

除公共头域外，无其它特殊头域。

body参数

参数名称	类型	是否必须	描述
messages	array<Message>	是	搜索输入； array的长度需要是奇数, role必须是user-assistant-user交替，以user开始以user结束;在百度搜索时，仅支持单论输入，若传入多轮输入，则以用户传入最后的content为输入查询。
model	string	是	支持的模型。从千帆ModelBuilder官网查看账户开通的模型，ModelBuilder账号欠费会导致调用失败。目前支持模型选项如下： 1.ernie-4.5-turbo-32k 2.ernie-4.5-turbo-128k 3.deepseek-v3 4.deepseek-r1-250528 5.deepseek-v3.1-250821 6.deepseek-v3.1-think-250821 7.qwen3-235b-a22b-instruct-2507 8.qwen3-235b-a22b-thinking-2507 9. ... 可选模型见完整列表
search_source	string	否	使用的搜索引擎版本。可选值：baidu_search_v1、baidu_search_v2 兼容性考虑默认为baidu_search_v1。 V2相比于V1：提升了性能表现，提升了数据内容的丰富度，更适用于结合大模型使用的场景，建议使用V2。
resource_type_filter	array<SearchResource>	否	单次搜索最大返回数量。 search_source为baidu_search_v1时：默认为返回网页top 10搜索结果，{"type": "web","top_k": 10}]，每种搜索类型支持返回的数量范围为：1~10。示例： [{"type": "image","top_k": 4}, {"type": "video","top_k": 4}, {"type": "web","top_k": 4}] 当search_source为baidu_search_v2时: 仅支持设置网页、视频搜索模态，top_k最大取值为20。 [{"type": "web","top_k": 4}, {"type": "video","top_k": 4}] 特别的，如需单次返回更多链接，可在智能搜索生成中开启深度搜索
search_recency_filter	string	否	根据网页发布时间进行筛选。枚举值: week：最近7天 month：最近30天 semiyear：最近180天 year：最近365天
search_filter	SearchFilter	否	根据SearchFilter下的子条件做检索过滤，使用方法见SearchFilter表详情。仅search_source为baidu_search_v2时生效。
model_appid	string	否	模型调用AppID。
instruction	string	否	人设指令，用于设定输出风格等。默认值："" 注意：字符长度需要小于等于4000
temperature	float	否	模型采样参数。较高的数值会使输出更加随机，而较低的数值会使其更加集中和确定。值范围：(0, 1] 默认值：1e-10 注意：该值越大，模型输出越多样，也越不稳定
top_p	float	否	模型采样参数。影响输出文本的多样性，取值越大，生成文本的多样性越强。值范围：(0, 1] 默认值：1e-10 注意：该值越大，模型输出越多样，也越不稳定
prompt_template	string	否	面向高阶用户开放自定义prompt模版，普通用户不需要设置，支持添加的变量包括： query：经过改写等处理后的query original_query：用户原始query history：对话历史 context_out：搜索结果（如果传入个性化知识，则是个性化知识 + 搜索结果） instruction：人设 time：当前时间其中变量query或original_query（至少一个）、context_out必须出现在prompt_template中，其他变量可选。样例："搜索结果： {{context_out}} 用户query： {{query}} "。
search_mode	string	否	控制是否进行智能联网搜索。默认为 auto。可选值： auto：自动判断是否需要搜索 required：必须执行搜索 disabled：禁用搜索功能仅模型回答
enable_reasoning	boolean	否	是否开启深度思考，仅对DeepSeek-R1、文心X1模型生效，开启后，在总结前会进行模型推理和思考并输出相关内容。默认值：true 可选值： true：开启 false：不开启
enable_deep_search	boolean	否	是否开启深搜索。 - 深搜索会产生10次以内的智能搜索生成服务调用默认值：false 可选值： true：开启，每种搜索类型最多返回100个搜索结果。 false：不开启，每种搜索类型最多返回10个搜索结果。
max_search_query_num	int	否	当开启深搜索时，用于搜索的最大子query个数，默认为10.
additional_knowledge	array<Knowledge>	否	调用方提供的定制化知识内容集合，与公开的联网搜索结果构成合集，注入到模型中进行问答总结。知识注入的条数和长度，与模型有关，限制最大10条。可以配合 priority（优先级参数）使用，让本地搜索结果在能回答问题时优先被采用。当前支持三个优先级：-1、0、1，数值越小优先级越高，回答时会优先选择高优先级的内容。其中，百度搜索结果的优先级为 0。
safety_level	string	否	query安全检查等级，可选值包括：standard、strict，默认为standard standard：标准安全等级 strict：严格安全等级
enable_web_page_safety	boolean	否	是否开启网页安全检查，默认为true
max_completion_tokens	int	否	最大输出Token值，默认2048。不同模型支持的最大输出token请参考：模型列表。
response_format	string	否	输出内容样式，可选值包括text、rich_text 1.text：文本输出 2.rich_text: 图文混排输出，在美食、旅游、动植物百科、人物场景下，输出嵌入markdown图片的回答。选择rich_text时推荐使用ernie-4.5-turbo-32k、ernie-4.5-turbo-128k、deepseek-v3.1-250821模型。输出样例：北京烤鸭是北京传统美食 [北京烤鸭](image_url)
enable_corner_markers	boolean	否	用于设置在最后生成的总结内容正文时，是否返回角标用于标记模型输出内容的参考来源。值含义： true：开启角标 false：隐藏角标默认值：true
max_refer_search_items	int	否	调节用于模型问答总结的最大搜索条数，默认是全部搜索结果。
enable_followup_queries	boolean	否	针对用户问题和大模型回答结果，给出推荐的追问。默认为false 可选值：true: 开启追问 false：不开启追问
stream	boolean	否	是否为流式请求。值含义： true：使用HTTP SSE流式响应 false：以非流式结果返回默认值为false；
config_id	string	否	指定使用该配置id下的领域知识注入、网页黑名单、问答干预策略等配置，详细说明。
enable_entity_selection_search	boolean	否	是否开启划词搜索，默认为false，不开启。开启之后将自动针对大模型返回内容抽取实体，挂载百度百科词条链接。开启划词搜索后，会使用百科词条服务的能力。当免费额度用完后需要付费，计费详情请参考官方组件。
search_items_postprocess	SearchItemsPostprocess	否	是否启用切片重排策略，默认值为 None，表示不启用。启用后，将根据配置参数对搜索结果进行切片，并按相关性筛选出最优切片传递给大模型，以降低响应时延。
enable_processing_state	boolean	否	首token返回之前输出关键过程信息，仅在流式场景下生效

Message对象

参数名称	类型	是否必须	描述
role	string	是	角色设定，可选值： user：用户 assistant：模型
content	string	是	content为文本时, 对应对话内容，即用户query问题，说明： 1. 不能为空。 2. 多轮对话中，用户最后一次输入message对应的content不能为空字符，如空格、"\n"、“\r”、“\f”等。

SearchFilter

参数名称	类型	是否必须	描述
match	object	否	条件查询。
+ site	array<string>	否	支持设置指定站点的搜索条件，即仅在设置的站点中进行内容搜索。目前支持设置20个站点。示例：["tieba.baidu.com"]
range	object	否	范围查询，参考范围查询(range)详情。
+ page_time	object	否	假设下述的now时间是2024-07-16。
++ gte	string	否	时间查询参数，大于或等于。值为"now-1w/d"，含义：2024-07-16前一周、向下做舍入，即大于2024-07-09 00:00:00，包含2024-07-09完整天。
++ gt	string	否	时间查询参数，大于。值为"now-1w/d"，含义：2024-07-16前一周、向上做舍入，即大于2024-07-09 23:59:59，不包含2024-07-09完整天。
++ lte	string	否	时间查询参数，小于或等于。值为"now-1w/d"，含义：2024-07-16前一周、向上做舍入，即小于2024-07-09 23:59:59，包含2024-07-09完整天。
++ lt	string	否	时间查询参数，小于。值为"now-1w/d"，含义：2024-07-16前一周、向下做舍入，即小于2024-07-09 00:00:00，不包含2024-07-09完整天。

范围查询(range)

可以用于数值型、日期型的字段。语法格式如下：

"range": {
     "{field}": {
          "gte": "{lowerBound}",
          "gt": "{lowerBound}",
          "lte": "{upperBound}",
          "lt": "{upperBound}"
       }
  }

实体(field)
pageTime：发布时间的实体名，表示针对pageTime做范围查询。此处pageTime对应响应数据中的page_time字段。网页发布时间的筛选功能只适用于可利用与可展现库，其他结果如视频等不召回。

查询范围(lowerBound\upperBound)

1.指定日期

指定搜索日期范围，格式：YYYY-MM-DD，例如：

"range": {
      "page_time": {
        "gte": "2025-11-01",
        "lte": "2025-11-04"
      }
    }

2.固定套餐

支持的时间单位：y（年）、M（月）、w（周）、d（日）。目前提供如下固定套餐，其他值非法。其中，"now"表示当前时间，在now后可以添加数学表达式：“-1w”表示减1周；“-1M”表示减1月；“-1y”表示减1年；“/d”表示归一化到当前天的起始\结束时间。

- now/d
- now-1w/d：一周
- now-2w/d：两周
- now-1M/d：一个月
- now-3M/d：三个月
- now-6M/d：六个月
- now-1y/d：一年

参数限制说明：

lte使用注意：range范围会参与检索系统的cache key计算，lte在做向上归一舍入后，由于cache可能导致结果时效性落后于match指定的lte值。
起始(lowerBound)和截止（upperBound）时间必需同时存在，否则该功能不生效。
gte和gt只传其中一个即可，都传只生效gt；lte和lt只传其中一个即可，都传只生效lt。

示例如下：

查询当天前7天(不含当天)发布的网页结果：

"query": {
    "filter": { 
         "range": {
             "page_time": {
                 "gte": "now-1w/d"
                 "lt": "now/d"
              }
         }
     }
}

SearchResource对象

参数名称	类型	是否必须	描述
type	string	是	搜索资源类型。 baidu_search_v1时，可选值： video: 视频 image: 图片 web：网页 baidu_search_v2时，可选值： video: 视频 web：网页
top_k	int	是	指定模态最大返回个数。

Knowledge对象

参数名称	类型	是否必须	描述
priority	int	否	搜索结果的优先级: 数字值越小，优先级越高。取值范围：(-1,1) 默认值为0；举例： -1是优先级最高，如果与百度搜索结果优先级相同，优先使用定制化知识点，默认值为0
data	Data	是	数据对象

Knowledge.Data对象

参数名称	类型	是否必须	描述
content	string	是	知识点内容
title	string	否	知识点标题
url	string	否	知识点URL地址
release_date	string	否	发布日期

SearchItemsPostprocess

参数名称	类型	是否必须	描述
window_size	int	否	控制切片的大小，默认值400字符，推荐值[300-400]。
stride_size	int	否	控制下一个切片相对于上一个切片起始位置的偏移量，默认值300字符，推荐值[300-400]。
max_slice	int	否	用于大模型总结的最大切片个数，默认值4。

响应头域

除公共头域外，无其它特殊头域。

响应参数

字段	类型	说明
request_id	string	请求ID。
code	string	错误码，当发生异常时返回。
message	string	错误消息，当发生异常时返回。
choices	array<Choice>	模型生成的 completion 的选择列表
usage	Usage	token开销
is_safe	boolean	用户输入query是否设计安全问题。
references	array<Reference>	模型回答参考引用内容
followup_queries	array<str>	追问问题
entities	array<Entities>	实体百科词条信息，只有当请求参数word_selection_search=true并且识别到返回文本内容中出现了对应实体之后，才会返回该内容

Choice对象

字段	类型	说明
finish_reason	string	模型停止生成token的原因。返回值: stop：模型自然停止生成。 length：输出长度达到了模型上下文长度限制。
index	int	该completion在选择列表中的索引。
message	Message	非流式模型生成的completion消息。
delta	Delta	流式返回的completion增量。

Choice.Message对象

字段	类型	说明
content	string	completion内容
reasoning_content	string	仅适用于 deepseek思考系列模型。内容为 assistant 消息中在最终答案之前的推理内容
role	string	固定值assistant

Choice.Delta对象

字段	类型	说明
content	string	completion内容
reasoning_content	string	仅适用于 deepseek思考系列模型。内容为 assistant 消息中在最终答案之前的推理内容
role	string	固定值assistant
processing_state	ProcessingState	执行状态

Choice.Delta.ProcessingState对象

字段	类型	说明
action	string	执行动作: query_understanding search_begin search_finish
description	string	执行动作描述: 正在理解问题正在搜索网页已搜索X个网页

Reference对象

字段	类型	说明
icon	string	网站图标地址
id	int	引用编号1、2、3
title	string	网页标题
url	string	网页地址
web_anchor	string	网站锚文本或网站标题
website	string	站点名称
content	string	网页内容，显示200字以内的相关信息原文片段
date	string	网页日期
type	string	检索资源类型： web:网页 image:图像内容 video:视频内容
image	ImageDetail	图片详情
video	VideoDetail	视频详情

Reference.ImageDetail对象

字段	类型	说明
url	string	图片链接
height	string	图片高度
width	string	图片宽度

Reference.VideoDetail对象

字段	类型	说明
url	string	视频链接
height	string	视频高度
width	string	视频宽度
size	string	视频大小，单位Bytes
duration	string	视频长度，单位秒
hover_pic	string	视频封面图

Usage对象

字段	类型	说明
prompt_tokens	int	prompt（输入）token数
completion_tokens	int	completion（输出）token数
total_tokens	int	总token数

Entities对象

字段	类型	说明
keyword	string	实体名称
offset	int	实体首字偏移量，实体的第一个字符相对于整个回答的偏移量
length	int	实体字数
lemma_title	string	百度词条名称
lemma_url	string	百度词条链接
lemma_id	integer	百度词条id

请求curl 示例

curl --location 'https://qianfan.baidubce.com/v2/ai_search/chat/completions' \
--header 'X-Appbuilder-Authorization: Bearer <AppBuilder API Key>' \
--header 'Content-Type: application/json' \
--data '{
  "messages": [
    {
      "content": "北京有哪些景点",
      "role": "user"
    }
  ],
  "search_source": "baidu_search_v1",
  "resource_type_filter": [
      {"type": "image","top_k": 4},
      {"type": "video","top_k": 4},
      {"type": "web","top_k": 4}
  ],
  "search_recency_filter": "year",
  "stream": false,
  "model": "ernie-3.5-8k",
  "enable_deep_search": false,
  "enable_followup_query": false,
  "temperature": 0.11,
  "top_p": 0.55,
  "search_mode": "auto",
  "enable_reasoning": true
}'

正确响应示例

{
    "choices": [
        {
            "finish_reason": "stop",
            "index": 0,
            "message": {
                "content": "北京的景点非常丰富，其中包括：\n1. 故宫博物院（紫禁城）：是世界上现存规模最大、保存最为完整的木质结构古建筑群之一，也是明清两代的皇家宫殿。\n2. 八达岭长城：是万里长城的重要组成部分，也是明长城的一个隘口，雄伟壮观，历史底蕴深厚。\n3. 颐和园：是清朝时期的皇家园林，以昆明湖、万寿山为基址，以杭州西湖为蓝本，汲取江南园林的设计手法而建成的一座大型山水园林，被誉为“皇家园林博物馆”。\n4. 北京天安门广场：是世界最大的城市广场，见证了许多重大历史时刻。\n5. 天坛公园：是明清皇帝祭天的地方，建筑独特，寓意“天圆地方”。\n6. 圆明园：是清代大型皇家园林，虽遭破坏，但仍能感受到昔日的辉煌与沧桑。\n7. 香山公园：是北京西郊的山林公园，景色秀丽，秋季红叶更是美不胜收。\n8. 恭王府：是规模宏大的王府建筑群，建筑精美。\n9. 什刹海：包括前海、后海等，有老北京的韵味，可乘船赏景。\n10. 奥林匹克公园：体现了“科技、绿色、人文”的理念，有鸟巢、水立方等标志性建筑。\n\n除了这些，北京还有许多其他值得一游的景点，如法海寺、龙庆峡、古北水镇、红螺寺等。",
                "role": "assistant"
            }
        }
    ],
    "is_safe": true,
    "references": [
        {
            "content": "1. 故宫（紫禁城）地址：东城区景山前街4号。门票：60元（旺季）/40元（淡季）开放时间：8:30-17:00（周一闭馆）。 为什么必去？故宫是世界现存最大、最完整的木质结构古建筑群，600年明清皇家历史的见证者，每一砖一瓦都藏着故事。必玩体验：中轴线游览（太和殿、乾清宫、御花园）感受皇家气派。打卡网红角落：延禧宫的西洋楼、红墙拍照（建议穿汉服）。珍宝馆+钟表馆（另收费），...",
            "date": "2025-4-24",
            "icon": "https://pic.rmb.bdstatic.com/bjh/user/f1c77bf4fc9f3651df29e52acde36e94.jpeg",
            "id": 1,
            "image": null,
            "title": "北京必玩景点TOP10|2025最新攻略,带你玩转帝都!",
            "type": "web",
            "url": "https://baijiahao.baidu.com/s?id=1830291819430711070&wfr=spider&for=pc",
            "video": null,
            "web_anchor": "老六爱玩"
        },
        {
            "content": "北京景点攻略 如果你是第一次去北京旅游可要千万要收藏好了",
            "date": "2024-06-01 03:18",
            "icon": "https://appbuilder.bj.bcebos.com/baidu-search-rag-pro/icon/default.png",
            "id": 2,
            "image": {
                "height": "674",
                "url": "http://img0.baidu.com/it/u=1145656209,2145532403&fm=253&fmt=auto&app=138&f=JPEG?w=500&h=674",
                "width": "500"
            },
            "title": "北京景点攻略 如果你是第一次去北京旅游可要千万要收藏好了",
            "type": "image",
            "url": "http://mbd.baidu.com/newspage/data/dtlandingsuper?nid=dt_5388334462984511033",
            "video": null,
            "web_anchor": "全网资源"
        },
        {
            "content": "哪些北京京郊的景点 外地同学值得自驾车去 跟着UP主出行看世界 /生活/出行/北京旅游避坑指南/北京去哪玩好/干货实用攻略/自驾游北京攻略/亲子游/周边游/周末去哪玩/北京旅游攻略/保姆级攻略 哪些北京京郊景点值得外地同学自驾车去 北京公义 大八山面 北京京郊大部分景点都在六环外 办理六环外的进京证就行 当然您要办理六环内的更好一些 下面就给您推荐一些京郊自驾游 外地同学值得去的景点(北京同学也值...",
            "date": "2025-5-23",
            "icon": "https://appbuilder.bj.bcebos.com/baidu-search-rag-pro/icon/bilibili.ico",
            "id": 3,
            "image": null,
            "title": "哪些北京京郊的景点 外地同学值得自驾车去",
            "type": "web",
            "url": "https://www.bilibili.com/video/BV1hE421K7K1",
            "video": null,
            "web_anchor": "哔哩哔哩"
        },
        {
            "content": "北京旅游必去的十大景点推荐",
            "date": "2024-06-19 13:00",
            "icon": "https://appbuilder.bj.bcebos.com/baidu-search-rag-pro/icon/default.png",
            "id": 4,
            "image": {
                "height": "1067",
                "url": "http://img2.baidu.com/it/u=80406124,3208002747&fm=253&fmt=auto&app=138&f=JPEG?w=800&h=1067",
                "width": "800"
            },
            "title": "北京旅游必去的十大景点推荐",
            "type": "image",
            "url": "http://www.douyin.com/note/7382074689126010131",
            "video": null,
            "web_anchor": "全网资源"
        },
        {
            "content": "北京景区排名必玩十大景点?有世界最大城市广场,有大型皇家园林 北京景区排名必玩十大景点?有世界最大城市广场,有大型皇家园林 北京景区 城市广场 旅游攻略 旅游资讯 皇家园林 北京有很多值得一去的景点推荐10个:1.故宫: 位于北京中心明清皇宫建筑辉煌藏品丰富 尽显皇家风范 2.颐和园 清朝皇家园林有山有水融合江南园林风格 风景如画 3.八达岭长城:在延庆万里长城重要部分 雄伟壮观历史底蕴深厚 4....",
            "date": "2025-5-22",
            "icon": "https://ss0.baidu.com/6ONWsjip0QIZ8tyhnq/it/u=76251347,1123177279&fm=195&app=88&f=PNG?w=200&h=200",
            "id": 5,
            "image": null,
            "title": "北京景区排名必玩十大景点?有世界最大城市广场,有大型...",
            "type": "web",
            "url": "https://haokan.baidu.com/v?pd=wisenatural&vid=14103857872992752240",
            "video": null,
            "web_anchor": "好看视频"
        },
        {
            "content": "北京必去十大景点 新手必看‼️附旅游攻略.熬夜整理出来的必打",
            "date": "2024-06-15 20:25",
            "icon": "https://appbuilder.bj.bcebos.com/baidu-search-rag-pro/icon/default.png",
            "id": 6,
            "image": {
                "height": "1342",
                "url": "http://img1.baidu.com/it/u=17130128,3218194790&fm=253&fmt=auto&app=138&f=JPEG?w=800&h=1342",
                "width": "800"
            },
            "title": "北京必去十大景点 新手必看‼附旅游攻略.熬夜整理出来的必打",
            "type": "image",
            "url": "http://www.douyin.com/note/7380319151006436646",
            "video": null,
            "web_anchor": "全网资源"
        },
        {
            "content": "揭秘！北京好玩的十大景点排行榜，你去过几个？北京，这座古老又现代的城市，藏着无数好玩的地方。想知道哪些景点能跻身北京好玩的地方排行榜前十名吗？接下来，我们就为你揭开谜底，带你领略京城最值得一去的精华景点，让你的北京之行不留遗憾。1. 故宫博物院 故宫，旧称紫禁城，是中国明清两代的皇家宫殿，也是世界上现存规模最大、保存最为完整的木质结构古建筑群之一。走进故宫，仿佛穿越回了古代，红墙黄瓦、飞檐斗拱，处...",
            "date": "2025-5-4",
            "icon": "https://pic.rmb.bdstatic.com/bjh/user/84f5641182eb2b574909828a3fa8f9b0.jpeg",
            "id": 7,
            "image": null,
            "title": "揭秘!北京好玩的十大景点排行榜,你去过几个?",
            "type": "web",
            "url": "https://baijiahao.baidu.com/s?id=1830726637146162329&wfr=spider&for=pc",
            "video": null,
            "web_anchor": "炫拍客旅途志"
        },
        {
            "content": "北京必去十大景点新手必看.亲亲记滴点赞收藏! 1 no.1",
            "date": "2024-08-17 11:00",
            "icon": "https://appbuilder.bj.bcebos.com/baidu-search-rag-pro/icon/default.png",
            "id": 8,
            "image": {
                "height": "1067",
                "url": "http://img0.baidu.com/it/u=3343386837,4291065808&fm=253&fmt=auto&app=138&f=JPEG?w=800&h=1067",
                "width": "800"
            },
            "title": "北京必去十大景点新手必看.亲亲记滴点赞收藏! 1 no.1",
            "type": "image",
            "url": "http://www.douyin.com/note/7403937889005882650",
            "video": null,
            "web_anchor": "全网资源"
        }
    ],
    "request_id": "ad524989-be46-48fd-b2ec-344683b28305",
    "usage": {
        "completion_tokens": 295,
        "prompt_tokens": 1919,
        "total_tokens": 2214
    }
}

错误响应示例

{
    "requestId": "00000000-0000-0000-0000-000000000000",
    "code": 216003,
    "message": "Authentication error: ( [Code: InvalidHTTPAuthHeader; Message: Fail to parse apikey authorization; RequestId: ea6ffeca-a136-401b-ba30-61c910c02ead] )"
}

OpenAI SDK调用智能搜索生成

智能搜索生成V2版本使用与 OpenAI 兼容的 API 格式，通过修改配置，您可以使用 OpenAI SDK 来访问智能搜索生成。

前提条件

确保已安装最新版OpenAI SDK。

调用示例

# Please install OpenAI SDK first: `pip3 install openai`

from openai import OpenAI

client = OpenAI(api_key="bce-v3/ALTAK***Altc/051c6***d238ce", # 千帆AppBuilder平台的ApiKey      
base_url="https://qianfan.baidubce.com/v2/ai_search") # 智能搜索生成V2版本接口

response = client.chat.completions.create(
    model="deepseek-r1",
    messages=[
        {"role": "user", "content": "今天有哪些体育新闻"}
    ],
    stream=False
)

print(response.choices[0].message.content)

Cursor中使用智能搜索生成MCP组件

通过Cursor Chat直接使用，可在Cursor中直接体验智能搜索生成组件的深度搜索与智能总结能力，高效准确地获取答案。

操作步骤

第一步：获取百度AI搜索MCP配置信息

百度AI搜索MCP配置信息获取：登录控制台，单击侧边栏MCP广场，找到百度AI搜索，进入详情页可直接复制Streamable Http 协议配置信息

AppBuilder API Key获取方式：登录控制台，单击侧边栏API Key，单击创建API Key，服务选择千帆AppBuilder，并配置你的产品权限策略，然后单击确定。

第二步:在Cursor中添加Server

Cursor设置界面-> MCP-> Add new MCP Server -> 填写server信息。

注意，Cursor最新版本需要通过配置mcp.json文件来添加MCP Server。示例如下：

{
 "mcpServers": {
    "aisearch-mcp-server": {
      "type": "streamableHttp",
      "description": "搜索实时信息，支持使用大模型进行总结回复。",
      "baseUrl": "https://qianfan.baidubce.com/v2/ai_search/mcp",
      "headers": {
        "Authorization": "Bearer xxxx"
      }
    }
  }
}

第三步:在Cursor中使用智能搜索生成组件

前往Cursor新版本的chat、旧版本的composer中，即可与agent对话。

在Cursor中，我们向Agent提问：今天体育新闻？这时智能搜索生成服务将为用户搜索今天最新的体育新闻，并在Cursor中将总结好的内容返回给用户。

错误码

错误码	描述
400	客户端请求参数错误。
500	服务端执行错误。
501	调用模型服务超时。
502	模型流式输出超时。
其它	详见模型返回错误码。

计费说明

百度搜索