秘塔ai搜索api分页非传统offset/limit模式,size设单次最多返回条数(上限50),page为从0开始的偏移块序号,且page×size≤1000;需按语义排序切片逻辑协同使用,避免重复、遗漏或限流。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要在调用秘塔AI搜索API时准确控制返回结果的数量与分页逻辑,但直接把size当“每页条数”、page当“第几页”来用,会导致重复召回、漏掉高相关结果,甚至触发接口限流——因为秘塔的分页机制不是传统数据库offset/limit模式,而是基于语义排序的动态切片。
size参数:控制单次响应的最高结果数量
在请求体中设置"size": 5,表示本次API调用最多返回5条结果,无论底层索引有多少匹配项。这个值有硬性上限:【最大不可超过50】,超出将被截断并静默返回400错误,不提示具体原因。
size不保证返回满额结果——若语义相关度低于阈值,可能只返回2条或0条。它只设上限,不保下限。
这一步操作起来很简单,直接把数字填进JSON就行。
page参数:指定语义排序后的结果切片位置
page不是从1开始的页码编号,而是从0开始的偏移块序号。设置"page": 0取前size条;"page": 1取接下来的size条(即第size+1到第size×2条),以此类推。
关键限制是:【page × size 不得超过1000】,否则返回HTTP 400且响应体中带"error": "offset too large"。这意味着即使size=10,page最大也只能是99,而非无限翻页。
该限制源于秘塔知识融合层对排序后向量缓存的深度约束,不是配额问题,无法通过升级权限绕过。
size与page协同使用的正确路径
第一步:确定你要覆盖的总结果范围(例如前300条高相关结果);
第二步:选定size值(建议优先试20或30,平衡精度与延迟);
第三步:计算最大可用page = floor((300 - 1) / size),例如size=25 → page最大为11(对应275条);
第四步:循环调用,每次递增page,直到返回结果为空或page已达上限;
注意:两次调用间若query微调(如增删空格、换同义词),将视为全新查询,排序锚点重置,无法续接上一页。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











