发布日期:2024年
| 对比维度 | 传统搜索 | 360智搜(AISO) |
|---|---|---|
| 语义召回 | 以短文本关键词匹配为主,语义能力弱 | 支持长文本拆段 + 全文语义召回,更精准匹配 query 语义 |
| 摘要内容 | 提供短片段飘红摘要,语义不完整 | 基于全文动态抽取与 Query最相关的完整语义摘要,不会有句子截断的情况 |
| 内容源 | 主要为公开网页 | 包含: • 互联网网页 • 精品知识库 • 支持暗知识(跨语言、图片、表格) • 超长内容(如论文)的段落级检索 • 支持定向抓取补充垂类内容 |
| 实时信息 | 复杂渲染展示 | 支持查询“今天天气”、“美元汇率”、“苹果股价”等实时数据,支持AI摘要,方便业务与网页结果兼容使用 |
| 搜索功能 | Path | 接口举例 | 接口内容 | 适合场景 |
|---|---|---|---|---|
| 网页(智搜系列) | /v2/mwebsearch | aiso-sr(智搜基础版) | 默认 10条,基于 360so-s1,经过 AI相关度重排,并增加 AI动态抽取的长摘要 (summary_ai字段),对大模型更友好,需要时可输出正文。增加时效性新闻数据,和天气等实时结果。 | 大模型 RAG,语义要求高,需要长摘要等 |
aiso-km-e2(精品库) | 默认 10条,自建精品知识库,专为大模型场景打造,段落语义召回。业务定制时,可按内容类别检索,如旅游(增加参数:category=旅游)、教育等。 | 大模型 RAG,语义要求高,需要长摘要等 | ||
aiso-pro(智搜进阶版) | 默认 10条,智搜基础版+精品库(内部并行请求,结果混排)。 | 大模型 RAG,语义要求高,需要长摘要等 | ||
aiso-max(智搜极致版) | 默认 10条。基于智搜进阶版,带大模型 query改写泛化+内部多 query并行查询能力(多 query并行查询、汇总,融合排序,降低业务开发成本)。 | 需要高质量、更全面内容或者用于提高 AI回答质量的场景。避免用户超长输入带来的结果不佳的情况。 | ||
aiso-news(新闻智搜) | 默认 10条。AI增强(AI重排和 AI摘要)的新闻结果,360so-v-news增强版。 | 主要是近月的新闻,时效性更强 | ||
| 网页(传统搜索) | /v2/mwebsearch | 360so-s1(传统搜索) | 默认 10条:自然结果,提供字段:标题,url,传统飘红摘要等。 | 需要在企业内部业务系统嵌入互联网搜索结果,或者提供全文搜索结果。 |
| 垂类和多模态 | /saas/vertical注:此 path接口为 Post请求。 | 360so-v-ik(文搜图) | 默认 60条,用关键词搜索图片。提供图片的宽、高、图片 url,所在网页 url。 | 全网图片素材库搜索相关图片,获取图片 url、图片所在网页 url、图片简要描述信息。 |
360so-v-ig(图搜图) | 默认 30条,相似图检索。通过 post提交 base64格式的图片数据(小于 5M)或者公网图片 URL,或者此接口可以不传 q参数。 | 全网图片素材库搜索相关图片,获取图片 url、图片所在网页 url、图片简要描述信息。 | ||
360so-v-news(新闻垂搜) | 默认 10条。搜索近期新闻,传统飘红摘要。 | 近一年的新闻,适合需要汇总更早新闻的场景 | ||
360so-v-hotspot(热点资讯) | 默认50条。返回某一领域的热点资讯。 | 需要知道今天ai相关领域都有哪些热点。 | ||
| AI搜索 | /v1/search/aisearch注:此接口为 Post请求。 | aisearch(带总结) | 基于aiso-max,可以直接生成答案回答用户提问,支持流式和非流式。 | 直接回答问题,输出大模型总结答案。 |
注:垂类和网页搜索的 path不同,且垂类为 post请求。
| Header参数 | 必须 | 类型 | 说明 |
|---|---|---|---|
| Authorization | 是 | string | 在api平台 https://ai.360.com/open/zh/platform/account/keys 创建的 apikey |
| User-Agent | 是 | string | 调用接口使用的客户端及其环境。如Mozilla/5.0 等 |
| X-forwarded-for | 否 | string | 最终用户的真实IP;可以用于服务端处理local类请求。比如 杭州的用户查询“今天天气”,可以出杭州的天气等。值: <client>,<proxy1>,<proxy2> 从用户方发起,各个链路模块追加在末尾。 |
| Content-Type | 否 | string | application/json |
| URL参数 | 必须 | 类型 | 说明 |
|---|---|---|---|
| sid | 是 | string | session id 单次请求的唯一 id,保障每个请求都不一样,方便 case 分析时进行各服务模块协查追溯。sid 一般由 md5(cid+q+ 毫微妙时间戳 + 机器 ip+ 执行请求的线程 id 等)生成,或者使用 uuid。 排查具体请求的 case,请随错误信息一并提供对应请求的 sid,以便链路排查。 |
| q | 是 | string | 查询词。仅 360so-v-ig 接口因为 post 传图,可以为空。 注:受 urlencode 协议影响,如果查询含加号需要以%2b 的方式替代。如:3+5 用 3%2B5 |
| ref_prom | 是 | string | 接口名称,取值为小写,取值为用户开通调用权限的套餐之一:360so-s1;aiso-sr;360so-v-ik;等 |
| fresh_day | 否 | int | 只检索最近多少天的内容。新闻默认值 30,其它网页搜索、图搜默认值 0 表示无限制。 |
| date_range | 否 | string | 只检索指定范围的内容,半角逗号分隔符指定时间周期,如 2025-01-01,2025-01-30。优先级低于发 fresh_day,即 fresh_day 值有效时,忽略次参数值。新闻,大搜,图搜同步支持。 |
| 参数 | 类型 | 说明 |
|---|---|---|
| sid | string | session id 单次请求的唯一 id,保障每个请求都不一样,方便 case 分析时进行各服务模块协查追溯。sid 一般由 md5(用户 tag+q+ 毫微妙时间戳 + 机器 ip+ 执行请求的线程 id 等)或者通用 uuid 生成。 排查具体请求的 case,请随原始错误信息 (非用户内部封装过的) 一并提供对应请求的 sid,以便链路排查。 |
| q | string | 查询词。 注:受 urlencode 协议影响,如果查询含加号需要以%2b 的方式替代。如:3+5 用 3%2B5 |
| ref_prom | string | 接口名称,取值为小写,取值为开通的套餐之一:360so-s1;aiso-sr;等 |
| 参数 | 类型 | 说明 |
|---|---|---|
| user_id | string | 用户级别的 ID,用于区分调用源。对于通过百炼之类的平台方调用接口的,用户 id 为平台下游企业用户区分码。对于直接访问的企业用户,用户 id 可以是自己的一个固定 tag。比如 a 企业的所有请求,都可以赋值 user_id=a;企业直接不一样即可; |
| client_ip | string | 终端用户的 IP。对于一些‘今天天气’之类有隐含地理位置需求的 query,需要获取访问者的所在城市,用当地的天气信息来回答。比如在杭州查询 '今天天气' ,实时信息应该返回杭州当天的天气。所以对于业务而言,除了遵循 X-Forwarded-For 规范之外 (见 5.3),也可以在 client_ip 指定终端 ip,以 其所在地作为默认的请求地理位置。 |
| 参数 | 类型 | 说明 |
|---|---|---|
| count | int | 指定返回的结果条数。默认值 10,最大值 20。注:结果会进行风控过滤,或者罕见关键词的查询,有可能少于目标值。 |
| summary_len | int | aiso 系列接口有效,智能摘要的长度,作用于 summary_ai 字段,建议 300-1000。默认值 500。如果有业务因为 token 等考虑,需要更短的摘要,可以设置为 300。最小值 120,最大值 3000。 注意,这是个倾向值,不是绝对截断值。比如设置 200,但是模型发现有一句内容长度超过 200 但跟 query 强相关,最终输出长度也有可能超过 200。值不是设置得特别小的话,大部分情况还是可以约束在控制范围内。 |
| 参数 | 类型 | 说明 |
|---|---|---|
| fresh_day | int | 只检索最近多少天的内容。新闻默认值 30,其它网页搜索、图搜默认值 0 表示无限制。 |
| date_range | string | 只检索指定范围的内容,半角逗号分隔符指定时间周期,如 2025-01-01,2025-01-30 或者 2025-01-01 18:01:02,2025-01-30 20:03:06优先级低于发 fresh_day,即 fresh_day 值有效时,忽略此参数值。 |
| freshness | int | aiso 网页接口结果的时效性额外增权程度。取值 0-2,默认值 0。 表示排序策略过程中,强化时效性方向的加权,值大则加权比重也大。具体策略由引擎内部自己决定。 |
| 参数 | 类型 | 说明 |
|---|---|---|
| trusted_sources | int | 指定可信 内容源查询。检索网页或者精品库内容时生效(sr,pro,max,s1,e2 接口)。取值范围 1-3,其他值无效。表示仅从可信来源中检索,详见 4.3.4。 |
| exclude_aigc | string | true 时,表示输出结果剔除离线 agic 的内容 (包含 ai 首条,ai 问答等)。用于做大模型生成的场景可用,杜绝时效性、幻觉相关问题,或 aigc 套娃出现内容生成的回路。 |
| just_box | string | true 时,表示只请求实时信息。对于只需要天气、汇率等实时信息 (参见 5.3 章节) 的请求,可以在请求 aiso-sr 接口时使用此参数表明仅请求 box_enhance 相关的内容,来减少其它内容源的计算延时,提升业务的延时体验。 |
| category | string | 仅在调用精品库 aiso-km-e2 接口时,作为可选参数,用于指定查询的内容分类,一次查询多分类时分类之间使用半角逗号分隔。如"category=旅游"或者"category=旅游,教育" ,支持的分类值可参考‘5.1.4.1’章节。内容分类是站点级别,人工标注或者模型自动根据网站内容打的标签列表,一个网站可能有多个标签。注:aiso-pro、aiso-max 含有精品库和大搜内容,也可对精品库来源内容生效。 |
| site | string | 仅在调用精品库 aiso-km-e2 接口时,作为可选参数,用于指定查询的目标站点,如 site=a.com 。同时指定多个站点时,使用半角逗号分隔,如 site=a.cn,b.cn,n.cn ,理论上可支持百个级别,但站点太多检索会慢,一般使用 category 方式,预标注垂类领域。 |
| site_weight或site_weight_manual | int | 检索结果里会输出URL所在站点的两个权威性字段,取值为0-8,值越高表示权威性等级越高,site_weight_sys为系统自动化评价的权威性等级,site_weight_manual为产品运营人工标注的权威性等级。 这两个参数可在特定应用场景下强制过滤低质站点的结果,哪怕该url的相关度很高。 例如:site_weight=6 ,表示仅输出 site_weight_sys或者site_weight_manual(有一满足即可) 大于等于6的url; site_weight_manual=6 ,表示仅输出人工打标 site_weight_manual 大于等于6的url; |
注:标签用于 aiso-km-e2 接口的 category 参数。
| 领域 | 人工标注 | 自动分类 | 说明 |
|---|---|---|---|
| 旅游 | 旅游 | 用于旅游攻略等场景 agent。 | |
| 医疗 | 医疗 AI 解答 | 健康医疗 | 人工精选站点:数百。 |
| 政务 | 政务 AI 解答 | 政务及公共服务 | 站点规模 100 左右。 |
| 金融 | 金融 AI 解答 | 金融 | 人工精选站点:数十 |
| 教育 | 教育 AI 解答 | 教育 | 人工精选站点:数十 |
| 论文 | 论文 AI 解答 | 教育 | 站点规模:千级别 |
| 法务 | 法律 AI 解答 | 法务行业 | 人工精选站点:百级别 |
| 参数 | 类型 | 说明 |
|---|---|---|
| extend_query | string | 使用半角 '|' 分隔的多个从 q 扩展出来的泛化 query。比如 “q1|q2|q3”,这些 query 会和参数 q 一起并行查询,最终再整体混排,取 topN,从而提升整个查询结果的丰富度。此参数用于用户自己拆词泛化的场景。最多支持 5 个,超过无效。 |
| query_rewrite | int | 接口内部自动拆词的泛化 query 个数。取值 0-5,0 表示由系统内置的模型根据 q 参数决定泛化的 query 个数。 优先级低于 extend_query,在无有效 extend_query 时才生效,默认值 0。 |
| 字段 | 类型 | 备注 | 是否必须 | 示例 |
|---|---|---|---|---|
| title | string | 标题 | 是 | 古代以北京为都城的有什么朝代 |
| summary | string | 传统摘要,带飘红 | 是 | 历史上以北京为都城的朝代有哪些... |
| url | string | 详情页地址 | 是 | https://m.baike.so.com/...9.html |
| site_name | string | 来源名称 | 否 | 360 百科 |
| site | string | 来源域名 | 否 | m.baike.so.com |
| time | int | 页面发布日期 | 否 | 1542297600(秒);有的 url 结果来自运营或者 AI 干预等,有可能没有页面时间。 |
| page_time | string | 页面发布日期 | 否 | 为了方便业务使用,在输出时新增根据 time 字段转的格式化时间,2025-02-12 12:12:12; |
| type | string | 类型 | 是 | 一般用于内部区分。engine,kvdb,wenda 等; |
| from | string | 结果来源 | 是 | 内部各类引擎、知识库等来源,如 engine,km2,km1 等 |
| official_site | int | 是否官网 | 否 | 如果一个url,是官网,则字段取值为1 |
| site_weight_sys | int | 站点权威性等级 | 否 | 取值为0-8,值越高,url所在站点的权威性等级越高,此值为系统化根据历史累积收录、访问、更新效率、质量评价等等多方 面因素自动化评估。 |
| site_weight_manual | int | 站点权威性等级 | 否 | 此值为人工标注,取值0-8,值越高,url所在站点的权威性等级越高。 |
| summary_ai | string | 基于全文和 query 的语义,通过 AI 从全文抽取的相关度高的完整语义长摘要 (忠于原文,非生成),可通过参数控制长度。 | 是(aiso 系列接口) | 辽朝(公元 916 年—公元 1125 年)是中国历史上由契丹族建立的朝代... 注:高级接口(如 aiso 开头)会基于全文通过 AI 重新生成长摘要,并对结果重新排序,对大模型应用更友好。360so-s1 为方便业务开发可以直接用,此字段值兼容赋值为传统摘要。 |
| 参数 | 必须 | 类型 | 说明 |
|---|---|---|---|
| sid | 是 | string | session id 单次请求的唯一 id,保障每个请求都不一样,方便 case 分析时进行各服务模块协查追溯。sid 一般由 md5(cid+q+ 毫微妙时间戳 + 机器 ip+ 执行请求的线程 id 等)生成。 |
| q | 是 | string | 查询的关键词,如猕猴桃。 |
| ref_prom | 是 | string | 取值 360so-v-ik 表示以文搜图。 |
| size | 否 | int | 指定图片的尺寸大小,默认值 0 表示不指定。 1-大尺寸 (宽高都大于 1000 像素),2-中尺寸 (宽高像素 500-1000),3-小尺寸 (宽高像素 500 以下),4-壁纸尺寸 (宽高 1024720~ 20481200),其他值无效。 |
| whratio | 否 | int | 指定宽高比形状类型。默认值 0 表示不限制。 1 正方图,2 横图,3 竖图,4 横图 4:3,5 竖图 4:3,6 横图 16:9,7 竖图 16:9,其他值无效。 |
| height | 否 | string | 指定原图高度像素值或范围 (包含边界值,空值表示不约束),如:指定值 height=800;不大于指定值 height=,800;不小于指定值 height=600,;指定范围 height=600,800; |
| width | 否 | string | 宽度。用法同高 度值。 |
| color | 否 | string | 指定图片需要包含的颜色。如 red 表示红色。可以半角分号分隔指定多个颜色,表示有颜色之一即可,如 color=red,blue。 特别地,如果需要颜色都有,可以使用参数 color_with=red,blue。 支持颜色列表:red,orange,yellow,green,indigo,blue,purple,pink,brown,black,white,gray,blackwhite |
| type | 否 | string | 指定图片的类型,非以下值表示不约束: type=static:只要静态图;type=dynamic:只要动态图。 |
| 参数 | 必须 | 类型 | 说明 |
|---|---|---|---|
| sid | 是 | string | session id 单次请求的唯一 id。 |
| q | 否 | string | 360so-v-ig 接口因为 post 传图,可以为空。 |
| ref_prom | 是 | string | 取值 360so-v-ig,表示以图搜图 |
| post_body.img_buf | 是 | json | 在 body 里提交的 base64 编码后的图片数据:{"img_buf":""},编码后不超过 5M 字节;也可以使用 {"img_url":"http://x....x.jpg"} 格式直接提交图片 url(但多了一次公网调用,延时可能有波动) |
| 字段名 | 字段描述说明 | 取值和示例 |
|---|---|---|
| id | 数据 id,排查 case 追溯用 | 8797fd521b96e35e8fe03610388842d5 |
| title | 标题 | 红色郁金香花海图片 |
| content | 图片描述 | 红色郁金香花海图片 |
| purl | 图片所在的原始网页 url | 字符串,http://www.photophoto.cn/... |
| imgurl | 图片本身的原始 url | http://picnew7.photophoto.cn/... |
| height | 原图高像素 | 603 |
| width | 原图宽像素 | 991 |
| thumbnail | 缩略图 url | https://pxxx.ssl.qhimgsxxx.com/... |
| search_url | 搜索详情页的 url(仅以文搜图接口有) | https://image.so.com/ai/large/view?... |
| rank | 结果列表里的逻辑排序 | 1 |
| 参数 | 必须 | 类型 | 说明 |
|---|---|---|---|
| sid | 是 | string | session id 单次请求的唯一 id。 |
| q | 是 | string | 查询词。支持 site 语法。 |
| ref_prom | 是 | string | 取值为 360so-v-news |
| count | 否 | int | 输出的新闻条数,默认值 10,最大值 30。V3.5 新增。 |
| fresh_day | 否 | int | 搜索近多少天的新闻。新闻无此参数时默认值 30,最大支持 300。由当前时间倒减天数倍 86400 秒开始查。 |
| date_range | 否 | string | 可选参数,半角逗号分隔符指定时间周期,如 2025-01-01,2025-01-30,或者带具体的时分秒。优先级低于 fresh_day。 |
| freshness | 否 | int | 360 智搜通用参数,时效性额外增权程度。取值 0-2,默认值 0。 |
| summary_len | 否 | int | 智能摘要的长度,作用于 summary_ai 字段,建议 300-1000。默认值 1000。最小值 120,最大值 3000。V3.5 新增。 |
| 参数 | 必须 | 类型 | 说明 |
|---|---|---|---|
| sid | 是 | string | session id 单次请求的唯一 id。 |
| category | 是 | string | 查询热点行业或者分类,可按需定制。目前默认支持的分类:ai。 |
| ref_prom | 是 | string | 取值为 360so-v-hotspot |
| hot_count | 否 | int | 输关注头部多少个热点,默认值50,最多100。 |
| count | 否 | int | 对热点进行检索时,每个热点保留的结果条数,默认值为5。如果条数太多,整个热点接口返回的数据会很大。 |
| engine_api | 否 | string | 在检索热点时,使用的检索接口,比如 aiso-max,aiso-pro,aiso-news等,默认使用aiso-max。指定aiso-max时,会使用大模型泛化改写多个query并行查询,获得更丰富的信息。 |
| hot_day | 否 | int | 关注近几天的热点,默认值1,最大值7。因为要算全网新数据,天数多,则计算量大,对性能影响比较大。 |
| fresh_day | 否 | int | 对热点进行检索时,每个热点的搜索结果做直接过滤,仅保留最近几天的结果,默认值7。 |
| 字段名 | 字段描述说明 | 取值和示例 |
|---|---|---|
| errno | 错误号,表示发生的错误类型。0表示响应正常。 | 20207 |
| message | 错误信息,辅助错误诊断的说明。 | 无效的OGID(12345),可能智搜接口未授权访问 |
| count | items数组的元素个数,即实际输出了多少条热点。 | 35 |
| items | 热点数组 | 略 |
| total_count | 总共有多少个热点。 | 88 |
| 字段名 | 字段描述说明 | 取值和示例 |
|---|---|---|
| hot_word | 热点的描述 | "零跑A10十万元级智能驾驶体验" |
| engine_results | 用hot_word取查询检索接口获取到的结果数组。 | 参见网页搜索的结果。 |
| count | engine_results数组的元素个数,即多少条检索结果。 | 3 |
| 参数 | 必须 | 类型 | 说明 |
|---|---|---|---|
| model | 是 | string | 模型类型。需要时api平台上已经接入的模型。 |
| messages | 是 | array | 当前会话记录信息,结构为结构为[{"role":"user","content":"搜索问题"}]形式,其中role的取值有assistant , user,content为具体的待搜索内容 |
| stream | 否 | bool | 是否流式输出,默认是false; true表示流式输出。 |
| max_refer_search_items | 否 | int | 取值范围是1到50,默认值是10,取搜索结果条数 |
| max_search_query_num | 否 | int | 拆词条数,代表需要泛化的query数量 |
| enable_corner_markers | 否 | bool | 输出答案里是否需要标注引用⻆标,默认为false |
| enable_web_page_safety | 否 | bool | 是否需要⽹⻚内容安全过滤,默认为false |
| search_mode | 否 | string | 搜索模式,可选值有:required, disabled, auto。分别表⽰: required - 强制搜索, disabled - 强制不搜索, auto - 通过意图分析动态判断 |
| user | 否 | string | 标记业务⽅⽤⼾id,便于业务⽅区分不同⽤⼾ |
| 字段 | ⼆级字段 | 三级字段 | 类型 | 说明 |
|---|---|---|---|---|
| choices | 数组 | 返回结果,⼀个结构体数组,⽬前不⽀持批量,因此正常返回时数组内含⼀个元素 | ||
| delta | 映射 | 返回结果 | ||
| content | 字符串 | 具体的⽣成内容 | ||
| finish_reason | 映射 | 流式返 回时,⼀般是空字符串;当命中敏感词时,P后⼀条该字段值是content_filter | ||
| index | 整数 | 代表本次结果在choices⾥的下标值,⽬前不⽀持批量,因此该值是0 | ||
| created | 整数 | 时间戳,值是服务端接收到请求时的时间戳,以秒计 | ||
| id | 整数 | 服务端⽣成的uuid,代表本次请求id,业务⽅可以记录⽅便排查问题 | ||
| model | 字符串 | 本次调⽤使⽤的模型名 | ||
| references | 字符串 | 搜索结果,仅在第⼀条消息出现⼀次 |
请确保填写正确的申请信息以便快速审核。