CleverSee的API怎么调用?向 /search/unified 发一个 POST,请求头带 Bearer 密钥,请求体里用 query 提问、engineType 选版本。三档传参值分别是 CNLiteBasic、CNAuto、Generic。

联网搜索的统一入口是 https://cloud-iqs.aliyuncs.com/search/unified,POST 方法,Content-Type 用 application/json。国内版、国际版、不同性能档,都从这一个地址进,靠 engineType 区分。完整示例在接入文档里按版本分别给了。
请求体的必填项只有一个 query,长度要求在 2 到 500 字符之间。超长的检索式会被拒,做多条件检索时把条件放进 advancedParams,不要全塞进 query 里拼字符串。
返回结构里主要看 pageItems 数组,每一项给链接、标题、摘要、发布时间。要不要正文由 contents 里的开关决定:mainText 打开返回长正文,markdownText 返回 Markdown,summary 返回短摘要。三个都打开返回体会明显变大,按下游模型能吃多少来开。
HTTP 方式用 API Key,在控制台的 API Key 页面创建,放进请求头的 Authorization 字段,格式是 Bearer 加空格加密钥。同一个头也支持换成 X-API-Key 字段名,两种写法等价。
SDK 方式用 AccessKey。要在 RAM 控制台建一个 RAM 用户、给它授权、再为它创建一对 AccessKey ID 和 Secret,然后写进 SDK 的配置里。AccessKey 不能拿去当 Bearer 令牌用,混用会直接 401。
密钥要放在服务端。前端代码里出现 API Key,等于把用量和账单公开了,谁拿到都能拿去刷。确实要给浏览器用的场景,自己在中间加一层转发,转发层校验身份后再带密钥出去。
极速版的传参值是 CNLiteBasic,平均响应 450 毫秒,返回条数上限 50 条。它是三档里最快也最便宜的,适合聊天、客服、搜索直答这类用户不愿意等、且问题不难的场景。
条数上限高是这一档的特点。做聚合类应用、要从几十个页面里抽事实,极速版能一次拿够材料,不用分多次调。代价是信源的权威性和长尾覆盖弱一些,需要精读专业内容的任务不要用它起手。
接入时先把 numResults 设小一点试,五条足够验证链路通不通。调到五十条再看返回体积和下游处理时间,一次到位容易把联调卡在超时上。
智能版的传参值是 CNAuto,平均响应 700 毫秒,返回条数上限 10 条。它把速度和相关性放在中间位置,官方定位是兼顾响应速度与搜索质量,面向业务场景比较普适。
条数只有 10 条,意味着单个查询的信息容量有限。需要广覆盖时改成多轮查询:同一主题换几个问法分别调,再把结果合并去重。这比在一档里硬要五十条更可控,也能针对每一轮单独调参数。
响应 700 毫秒对同步接口够用,对语音交互偏慢。做语音助手时把检索和生成拆开,检索先返回一句「正在查」,生成完再播报,体感差别很大。
Generic 版的传参值是 Generic,平均响应 950 毫秒,返回条数上限 10 条。它用的是 Quark 专属信源,长尾性和权威性是三档里最强的,业务场景普适性也更强。
要五十条结果得换成 GenericAdvanced,这个增值包把上限扩到约 50 条,同时单价跟着上去。开增值包前先确认真的需要那么多条,常见检索场景十条就够定位答案。
国际版走的是 Global 和 GlobalAdvanced 两个值,当前 Global 还没上线,只有 GlobalAdvanced 可用,平均响应 1764 毫秒。做海外信息检索时用它,时延接近两秒,接口超时时间要按这个数放宽。
开通后账号会拿到一批体验额度,调接口时先扣这份额度,扣完转按量计费。额度数量在控制台概览页看,不在接口文档里固定写死。开发和联调阶段尽量用极速版跑,单价低、响应快,同样的额度能多跑几十轮,把链路和异常分支都验一遍再换正式档位。
编码问题,不是接口问题。响应头声明的是 UTF-8,客户端没按这个解就会乱码。检查客户端有没有强制指定 UTF-8 解码,写文件时用的编码对不对。用 response.json() 而不是 response.text 再手动转,能避开大半。
看版本。极速版最多 50 条,智能版 10 条,Generic 版 10 条,开增值包能到约 50 条。实际返回数由 numResults 决定。写代码时按上限做分页或截断,别把 numResults 设超。
支持,但有默认上限。新购账户的并发是三 QPS,也就是每秒最多三次请求,超出的会被限流。要更高的并发得联系商务经理沟通扩容。做批量任务时自己加一个令牌桶控制速率,别靠重试去撞上限,撞回来的限流响应也算一次失败的往返,白等一轮。
CleverSee调用失败怎么排查?按四个地方依次查:密钥与授权、账户余额、并发上限、请求参数。四种原因对应四类不同的返回,每...
2026-10-21
CleverSee怎么收费?按调用成功次数后付费,联网搜索在计费规则页里列了两个型号:Lite 版 18 元每千次、Pro 版 42 元每千次...
2026-10-21
CleverSee的企业数据搜问能做什么?把企业自己的文档、图片、音视频接进来做检索和问答,路径是数据接入、应用配置、API 调用...
2026-10-21
CleverSee的联网问答怎么用?在控制台建一个问答应用、配置好策略、发布拿 appID,再用 API Key 调。它和搜索接口的分工很清...
2026-10-21
CleverSee的网页解析怎么用?向 /readpage/scrape 发一个 POST,请求体里放 url 和想要的格式,返回就是清洗过的正文。静态页...
2026-10-21