发布日期: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条。搜索近期新闻,传统飘红摘要。 |
注:垂类和网页搜索的 path不同,且垂类为 post请求。
| 参数 | 必须 | 类型 | 说明 |
|---|---|---|---|
| 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 方式,预标注垂类领域。 |
注:标签用于 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 等 |
| 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 新增。 |
请确保填写正确的申请信息以便快速审核。