智能搜索生成
能力描述
概述:可根据用户输入query搜索全网实时信息后,并进行智能总结回答。
计费:每日免费额度为100次,支持按量后付费(为不影响使用体验,可先去开通后付费),默认优先抵扣免费资源。智能搜索生成的免费额度以及总调用上限,与百度搜索共享,且每个账号每天最多使用100,000次,如有更多调用需求请您联系我们进行开通,费用详情请查看计费说明。
在线调试
百度智能云千帆提供了API在线调试平台,平台集成了快速检索、查看开发文档、查看在线调用的请求内容和返回结果、复制和下载示例代码等功能,帮助开发者快速调试接口。
接口定义
| URL | /v2/ai_search/chat/completions |
|---|---|
| Method | POST |
| Content-Type | application/json |
| Authorization | 请求签名(Bearer <AppBuilder API Key>) |
请求结构
1POST /v2/ai_search/chat/completions HTTP/1.1
2HOST: qianfan.baidubce.com
3Authorization: Bearer <AppBuilder API Key>
4Content-Type: application/json
5{
6 "messages": [
7 {
8 "content": "近日油价调整消息。",
9 "role": "user"
10 }
11 ],
12 "stream": false,
13 "model": "ernie-3.5-8k",
14 "instruction": "##",
15 "enable_corner_markers": true,
16 "enable_deep_search": true
17}
请求参数
header参数
除公共头域外,无其它特殊头域。
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)
可以用于数值型、日期型的字段。语法格式如下:
1"range": {
2 "{field}": {
3 "gte": "{lowerBound}",
4 "gt": "{lowerBound}",
5 "lte": "{upperBound}",
6 "lt": "{upperBound}"
7 }
8 }
实体(field)
pageTime:发布时间的实体名,表示针对pageTime做范围查询。此处pageTime对应响应数据中的page_time字段。网页发布时间的筛选功能只适用于可利用与可展现库,其他结果如视频等不召回。
查询范围(lowerBound\upperBound)
支持的时间单位:y(年)、M(月)、w(周)、d(日)。目前提供如下固定套餐,其他值非法。其中,"now"表示当前时间,在now后可以添加数学表达式:“-1w”表示减1周;“-1M”表示减1月;“-1y”表示减1年;“/d”表示归一化到当前天的起始\结束时间。
1- now/d
2- now-1w/d:一周
3- now-2w/d:两周
4- now-1M/d:一个月
5- now-3M/d:三个月
6- now-6M/d:六个月
7- now-1y/d:一年
参数限制说明
- lte使用注意:range范围会参与检索系统的cache key计算,lte在做向上归一舍入后,由于cache可能导致结果时效性落后于match指定的lte值。
- 起始(lowerBound)和截止(upperBound)时间必需同时存在,否则该功能不生效。
- gte和gt只传其中一个即可,都传只生效gt;lte和lt只传其中一个即可,都传只生效lt。
示例
查询当天前7天(不含当天)发布的网页结果:
1"query": {
2 "filter": {
3 "range": {
4 "page_time": {
5 "gte": "now-1w/d"
6 "lt": "now/d"
7 }
8 }
9 }
10}
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 示例
1curl --location 'https://qianfan.baidubce.com/v2/ai_search/chat/completions' \
2--header 'X-Appbuilder-Authorization: Bearer <AppBuilder API Key>' \
3--header 'Content-Type: application/json' \
4--data '{
5 "messages": [
6 {
7 "content": "北京有哪些景点",
8 "role": "user"
9 }
10 ],
11 "search_source": "baidu_search_v1",
12 "resource_type_filter": [
13 {"type": "image","top_k": 4},
14 {"type": "video","top_k": 4},
15 {"type": "web","top_k": 4}
16 ],
17 "search_recency_filter": "year",
18 "stream": false,
19 "model": "ernie-3.5-8k",
20 "enable_deep_search": false,
21 "enable_followup_query": false,
22 "temperature": 0.11,
23 "top_p": 0.55,
24 "search_mode": "auto",
25 "enable_reasoning": true
26}'
正确响应示例
1{
2 "choices": [
3 {
4 "finish_reason": "stop",
5 "index": 0,
6 "message": {
7 "content": "北京的景点非常丰富,其中包括:\n1. 故宫博物院(紫禁城):是世界上现存规模最大、保存最为完整的木质结构古建筑群之一,也是明清两代的皇家宫殿。\n2. 八达岭长城:是万里长城的重要组成部分,也是明长城的一个隘口,雄伟壮观,历史底蕴深厚。\n3. 颐和园:是清朝时期的皇家园林,以昆明湖、万寿山为基址,以杭州西湖为蓝本,汲取江南园林的设计手法而建成的一座大型山水园林,被誉为“皇家园林博物馆”。\n4. 北京天安门广场:是世界最大的城市广场,见证了许多重大历史时刻。\n5. 天坛公园:是明清皇帝祭天的地方,建筑独特,寓意“天圆地方”。\n6. 圆明园:是清代大型皇家园林,虽遭破坏,但仍能感受到昔日的辉煌与沧桑。\n7. 香山公园:是北京西郊的山林公园,景色秀丽,秋季红叶更是美不胜收。\n8. 恭王府:是规模宏大的王府建筑群,建筑精美。\n9. 什刹海:包括前海、后海等,有老北京的韵味,可乘船赏景。\n10. 奥林匹克公园:体现了“科技、绿色、人文”的理念,有鸟巢、水立方等标志性建筑。\n\n除了这些,北京还有许多其他值得一游的景点,如法海寺、龙庆峡、古北水镇、红螺寺等。",
8 "role": "assistant"
9 }
10 }
11 ],
12 "is_safe": true,
13 "references": [
14 {
15 "content": "1. 故宫(紫禁城)地址:东城区景山前街4号。门票:60元(旺季)/40元(淡季)开放时间:8:30-17:00(周一闭馆)。 为什么必去?故宫是世界现存最大、最完整的木质结构古建筑群,600年明清皇家历史的见证者,每一砖一瓦都藏着故事。必玩体验:中轴线游览(太和殿、乾清宫、御花园)感受皇家气派。打卡网红角落:延禧宫的西洋楼、红墙拍照(建议穿汉服)。珍宝馆+钟表馆(另收费),...",
16 "date": "2025-4-24",
17 "icon": "https://pic.rmb.bdstatic.com/bjh/user/f1c77bf4fc9f3651df29e52acde36e94.jpeg",
18 "id": 1,
19 "image": null,
20 "title": "北京必玩景点TOP10|2025最新攻略,带你玩转帝都!",
21 "type": "web",
22 "url": "https://baijiahao.baidu.com/s?id=1830291819430711070&wfr=spider&for=pc",
23 "video": null,
24 "web_anchor": "老六爱玩"
25 },
26 {
27 "content": "北京景点攻略 如果你是第一次去北京旅游可要千万要收藏好了",
28 "date": "2024-06-01 03:18",
29 "icon": "https://appbuilder.bj.bcebos.com/baidu-search-rag-pro/icon/default.png",
30 "id": 2,
31 "image": {
32 "height": "674",
33 "url": "http://img0.baidu.com/it/u=1145656209,2145532403&fm=253&fmt=auto&app=138&f=JPEG?w=500&h=674",
34 "width": "500"
35 },
36 "title": "北京景点攻略 如果你是第一次去北京旅游可要千万要收藏好了",
37 "type": "image",
38 "url": "http://mbd.baidu.com/newspage/data/dtlandingsuper?nid=dt_5388334462984511033",
39 "video": null,
40 "web_anchor": "全网资源"
41 },
42 {
43 "content": "哪些北京京郊的景点 外地同学值得自驾车去 跟着UP主出行看世界 /生活/出行/北京旅游避坑指南/北京去哪玩好/干货实用攻略/自驾游北京攻略/亲子游/周边游/周末去哪玩/北京旅游攻略/保姆级攻略 哪些北京京郊景点值得外地同学自驾车去 北京公义 大八山面 北京京郊大部分景点都在六环外 办理六环外的进京证就行 当然您要办理六环内的更好一些 下面就给您推荐一些京郊自驾游 外地同学值得去的景点(北京同学也值...",
44 "date": "2025-5-23",
45 "icon": "https://appbuilder.bj.bcebos.com/baidu-search-rag-pro/icon/bilibili.ico",
46 "id": 3,
47 "image": null,
48 "title": "哪些北京京郊的景点 外地同学值得自驾车去",
49 "type": "web",
50 "url": "https://www.bilibili.com/video/BV1hE421K7K1",
51 "video": null,
52 "web_anchor": "哔哩哔哩"
53 },
54 {
55 "content": "北京旅游必去的十大景点推荐",
56 "date": "2024-06-19 13:00",
57 "icon": "https://appbuilder.bj.bcebos.com/baidu-search-rag-pro/icon/default.png",
58 "id": 4,
59 "image": {
60 "height": "1067",
61 "url": "http://img2.baidu.com/it/u=80406124,3208002747&fm=253&fmt=auto&app=138&f=JPEG?w=800&h=1067",
62 "width": "800"
63 },
64 "title": "北京旅游必去的十大景点推荐",
65 "type": "image",
66 "url": "http://www.douyin.com/note/7382074689126010131",
67 "video": null,
68 "web_anchor": "全网资源"
69 },
70 {
71 "content": "北京景区排名必玩十大景点?有世界最大城市广场,有大型皇家园林 北京景区排名必玩十大景点?有世界最大城市广场,有大型皇家园林 北京景区 城市广场 旅游攻略 旅游资讯 皇家园林 北京有很多值得一去的景点推荐10个:1.故宫: 位于北京中心明清皇宫建筑辉煌藏品丰富 尽显皇家风范 2.颐和园 清朝皇家园林有山有水融合江南园林风格 风景如画 3.八达岭长城:在延庆万里长城重要部分 雄伟壮观历史底蕴深厚 4....",
72 "date": "2025-5-22",
73 "icon": "https://ss0.baidu.com/6ONWsjip0QIZ8tyhnq/it/u=76251347,1123177279&fm=195&app=88&f=PNG?w=200&h=200",
74 "id": 5,
75 "image": null,
76 "title": "北京景区排名必玩十大景点?有世界最大城市广场,有大型...",
77 "type": "web",
78 "url": "https://haokan.baidu.com/v?pd=wisenatural&vid=14103857872992752240",
79 "video": null,
80 "web_anchor": "好看视频"
81 },
82 {
83 "content": "北京必去十大景点 新手必看‼️附旅游攻略.熬夜整理出来的必打",
84 "date": "2024-06-15 20:25",
85 "icon": "https://appbuilder.bj.bcebos.com/baidu-search-rag-pro/icon/default.png",
86 "id": 6,
87 "image": {
88 "height": "1342",
89 "url": "http://img1.baidu.com/it/u=17130128,3218194790&fm=253&fmt=auto&app=138&f=JPEG?w=800&h=1342",
90 "width": "800"
91 },
92 "title": "北京必去十大景点 新手必看‼附旅游攻略.熬夜整理出来的必打",
93 "type": "image",
94 "url": "http://www.douyin.com/note/7380319151006436646",
95 "video": null,
96 "web_anchor": "全网资源"
97 },
98 {
99 "content": "揭秘!北京好玩的十大景点排行榜,你去过几个?北京,这座古老又现代的城市,藏着无数好玩的地方。想知道哪些景点能跻身北京好玩的地方排行榜前十名吗?接下来,我们就为你揭开谜底,带你领略京城最值得一去的精华景点,让你的北京之行不留遗憾。1. 故宫博物院 故宫,旧称紫禁城,是中国明清两代的皇家宫殿,也是世界上现存规模最大、保存最为完整的木质结构古建筑群之一。走进故宫,仿佛穿越回了古代,红墙黄瓦、飞檐斗拱,处...",
100 "date": "2025-5-4",
101 "icon": "https://pic.rmb.bdstatic.com/bjh/user/84f5641182eb2b574909828a3fa8f9b0.jpeg",
102 "id": 7,
103 "image": null,
104 "title": "揭秘!北京好玩的十大景点排行榜,你去过几个?",
105 "type": "web",
106 "url": "https://baijiahao.baidu.com/s?id=1830726637146162329&wfr=spider&for=pc",
107 "video": null,
108 "web_anchor": "炫拍客旅途志"
109 },
110 {
111 "content": "北京必去十大景点新手必看.亲亲记滴点赞收藏! 1 no.1",
112 "date": "2024-08-17 11:00",
113 "icon": "https://appbuilder.bj.bcebos.com/baidu-search-rag-pro/icon/default.png",
114 "id": 8,
115 "image": {
116 "height": "1067",
117 "url": "http://img0.baidu.com/it/u=3343386837,4291065808&fm=253&fmt=auto&app=138&f=JPEG?w=800&h=1067",
118 "width": "800"
119 },
120 "title": "北京必去十大景点新手必看.亲亲记滴点赞收藏! 1 no.1",
121 "type": "image",
122 "url": "http://www.douyin.com/note/7403937889005882650",
123 "video": null,
124 "web_anchor": "全网资源"
125 }
126 ],
127 "request_id": "ad524989-be46-48fd-b2ec-344683b28305",
128 "usage": {
129 "completion_tokens": 295,
130 "prompt_tokens": 1919,
131 "total_tokens": 2214
132 }
133}
错误响应示例
1{
2 "requestId": "00000000-0000-0000-0000-000000000000",
3 "code": 216003,
4 "message": "Authentication error: ( [Code: InvalidHTTPAuthHeader; Message: Fail to parse apikey authorization; RequestId: ea6ffeca-a136-401b-ba30-61c910c02ead] )"
5}
OpenAI SDK调用智能搜索生成
智能搜索生成V2版本使用与 OpenAI 兼容的 API 格式,通过修改配置,您可以使用 OpenAI SDK 来访问智能搜索生成。
前提条件
确保已安装最新版OpenAI SDK。
调用示例
1# Please install OpenAI SDK first: `pip3 install openai`
2
3from openai import OpenAI
4
5client = OpenAI(api_key="bce-v3/ALTAK***Altc/051c6***d238ce", # 千帆AppBuilder平台的ApiKey
6base_url="https://qianfan.baidubce.com/v2/ai_search") # 智能搜索生成V2版本接口
7
8response = client.chat.completions.create(
9 model="deepseek-r1",
10 messages=[
11 {"role": "user", "content": "今天有哪些体育新闻"}
12 ],
13 stream=False
14)
15
16print(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。示例如下:
1{
2 "mcpServers": {
3 "aisearch-mcp-server": {
4 "type": "streamableHttp",
5 "description": "搜索实时信息,支持使用大模型进行总结回复。",
6 "baseUrl": "https://qianfan.baidubce.com/v2/ai_search/mcp",
7 "headers": {
8 "Authorization": "Bearer xxxx"
9 }
10 }
11 }
12}
第三步:在Cursor中使用智能搜索生成组件
前往Cursor新版本的chat、旧版本的composer中,即可与agent对话。
在Cursor中,我们向Agent提问:今天体育新闻?这时智能搜索生成服务将为用户搜索今天最新的体育新闻,并在Cursor中将总结好的内容返回给用户。

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