首页 > AI工具 > CleverSee的API怎么调用?密钥和三种版本传参

CleverSee的API怎么调用?密钥和三种版本传参

更新时间:2026-10-22 00:06:34 发布时间:5小时前 阅读:11次

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

CleverSee的API怎么调用?密钥和三种版本传参

CleverSee的搜索接口只有一个地址

联网搜索的统一入口是 https://cloud-iqs.aliyuncs.com/search/unified,POST 方法,Content-Type 用 application/json。国内版、国际版、不同性能档,都从这一个地址进,靠 engineType 区分。完整示例在接入文档里按版本分别给了。

请求体的必填项只有一个 query,长度要求在 2 到 500 字符之间。超长的检索式会被拒,做多条件检索时把条件放进 advancedParams,不要全塞进 query 里拼字符串。

返回结构里主要看 pageItems 数组,每一项给链接、标题、摘要、发布时间。要不要正文由 contents 里的开关决定:mainText 打开返回长正文,markdownText 返回 Markdown,summary 返回短摘要。三个都打开返回体会明显变大,按下游模型能吃多少来开。

CleverSee的密钥有两种来源

HTTP 方式用 API Key,在控制台的 API Key 页面创建,放进请求头的 Authorization 字段,格式是 Bearer 加空格加密钥。同一个头也支持换成 X-API-Key 字段名,两种写法等价。

SDK 方式用 AccessKey。要在 RAM 控制台建一个 RAM 用户、给它授权、再为它创建一对 AccessKey ID 和 Secret,然后写进 SDK 的配置里。AccessKey 不能拿去当 Bearer 令牌用,混用会直接 401。

密钥要放在服务端。前端代码里出现 API Key,等于把用量和账单公开了,谁拿到都能拿去刷。确实要给浏览器用的场景,自己在中间加一层转发,转发层校验身份后再带密钥出去。

CleverSee的极速版适合日常问答

极速版的传参值是 CNLiteBasic,平均响应 450 毫秒,返回条数上限 50 条。它是三档里最快也最便宜的,适合聊天、客服、搜索直答这类用户不愿意等、且问题不难的场景。

条数上限高是这一档的特点。做聚合类应用、要从几十个页面里抽事实,极速版能一次拿够材料,不用分多次调。代价是信源的权威性和长尾覆盖弱一些,需要精读专业内容的任务不要用它起手。

接入时先把 numResults 设小一点试,五条足够验证链路通不通。调到五十条再看返回体积和下游处理时间,一次到位容易把联调卡在超时上。

CleverSee的智能版把条数压到十条

智能版的传参值是 CNAuto,平均响应 700 毫秒,返回条数上限 10 条。它把速度和相关性放在中间位置,官方定位是兼顾响应速度与搜索质量,面向业务场景比较普适。

条数只有 10 条,意味着单个查询的信息容量有限。需要广覆盖时改成多轮查询:同一主题换几个问法分别调,再把结果合并去重。这比在一档里硬要五十条更可控,也能针对每一轮单独调参数。

响应 700 毫秒对同步接口够用,对语音交互偏慢。做语音助手时把检索和生成拆开,检索先返回一句「正在查」,生成完再播报,体感差别很大。

CleverSee的Generic版走专属信源

Generic 版的传参值是 Generic,平均响应 950 毫秒,返回条数上限 10 条。它用的是 Quark 专属信源,长尾性和权威性是三档里最强的,业务场景普适性也更强。

要五十条结果得换成 GenericAdvanced,这个增值包把上限扩到约 50 条,同时单价跟着上去。开增值包前先确认真的需要那么多条,常见检索场景十条就够定位答案。

国际版走的是 Global 和 GlobalAdvanced 两个值,当前 Global 还没上线,只有 GlobalAdvanced 可用,平均响应 1764 毫秒。做海外信息检索时用它,时延接近两秒,接口超时时间要按这个数放宽。

常见问题

CleverSee的API有免费调用额度吗

开通后账号会拿到一批体验额度,调接口时先扣这份额度,扣完转按量计费。额度数量在控制台概览页看,不在接口文档里固定写死。开发和联调阶段尽量用极速版跑,单价低、响应快,同样的额度能多跑几十轮,把链路和异常分支都验一遍再换正式档位。

CleverSee返回中文乱码怎么办

编码问题,不是接口问题。响应头声明的是 UTF-8,客户端没按这个解就会乱码。检查客户端有没有强制指定 UTF-8 解码,写文件时用的编码对不对。用 response.json() 而不是 response.text 再手动转,能避开大半。

CleverSee一次能返回多少条结果

看版本。极速版最多 50 条,智能版 10 条,Generic 版 10 条,开增值包能到约 50 条。实际返回数由 numResults 决定。写代码时按上限做分页或截断,别把 numResults 设超。

CleverSee的接口支持并发调用吗

支持,但有默认上限。新购账户的并发是三 QPS,也就是每秒最多三次请求,超出的会被限流。要更高的并发得联系商务经理沟通扩容。做批量任务时自己加一个令牌桶控制速率,别靠重试去撞上限,撞回来的限流响应也算一次失败的往返,白等一轮。

标签:
相关文章