必须分清api接口类型：搜索接口【/search】返回带排序的网页快照列表，适合rag或爬虫替代；问答接口【/answer】直接输出带引用的自然语言答案，需必填context参数，适合对话机器人。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要快速接入秘塔AI搜索能力，必须先分清API接口类型——搜索接口返回原始检索结果，问答接口直接输出结构化答案，二者调用方式、返回结构和计费逻辑完全不同。
核心功能定位差异
搜索接口（【/search】）本质是“增强版搜索引擎”，它返回带排序的网页快照列表、标题、摘要、URL及置信度评分，适合需要自主筛选信源或构建RAG知识库的场景；问答接口（【/answer】）本质是“AI摘要引擎”，它跳过结果列表，直接调用MetaLLM模型对Top 5网页做融合推理，输出带引用锚点的自然语言回答，适合客服自动回复、报告生成等终端直出场景。
如果你在写爬虫替代方案，选/search；如果要做“用户问一句，系统答一段”的对话机器人，必须用/answer。
输入参数关键区别
方法一：搜索接口要求显式指定检索范围
必须传入 【query】 字符串，可选传入 【site】（限定域名）、【file_type】（如pdf）、【time_range】（如"last_week"）。不传 site 时默认全网搜索，但无法控制结果是否含广告页或低质站点。
方法二：问答接口强制启用上下文理解
除 query 外，【context】 参数为必填数组，格式为[{"role":"user","content":"上一轮问题"}]。若忽略此字段，接口将降级为普通搜索并返回空 answer 字段——这是开发者踩坑最多的地方。
方法三：两者都支持 citation 开关，但行为不同
search 接口开启 enable_citation 后，仅在摘要末尾添加 [1][2] 上标；answer 接口开启后，会在答案句末自动插入带超链接的来源标注，点击即可跳转原文对应段落。
响应结构与解析路径
第一步：检查 response.status_code 是否为 200
第二步：读取 response.json() 的顶层键名
搜索接口返回固定五字段：【results】（数组）、query、cost、used_tokens、timestamp；问答接口返回三字段：【answer】（字符串）、references（数组）、cost。若 response 中没有 answer 键，说明你误调了 search 接口却期待问答结果。
第三步：提取 answer 内容时注意流式响应标识
问答接口默认启用 streaming，response.headers 中含 content-type: text/event-stream；若需同步阻塞获取完整答案，必须在请求头添加 X-Disable-Streaming: true，否则可能只收到前50字符就断连。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
