秘塔AI搜索API默认返回10条结果,需通过per_page参数(最大50)调整单次数量,并结合page参数与响应头X-Total-Count字段分页获取全部结果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

秘塔AI搜索API默认只返回10条结果,但实际业务中常需获取更多条目用于分析或展示,必须手动设置分页参数才能突破默认限制。
设置单次请求返回的结果数量
在API请求URL中添加 per_page 参数,例如 per_page=30 表示本次请求最多拉取30条结果。
【per_page最大值为50,超出将被服务端自动截断为50】
这一步操作很简单,直接把 per_page=50 加到请求地址末尾即可,不需要额外认证或开关。
获取全部匹配结果的完整分页方案
当全量结果超过50条时,必须分页获取。正确路径是:
第一步:发送首次请求,携带 page=1&per_page=50;
第二步:解析响应头中的 X-Total-Count 字段,该值代表全量匹配总数;
第三步:根据总数计算总页数,例如 X-Total-Count=137 → 总页数为 ⌈137/50⌉ = 3 页;
第四步:依次请求 page=2&per_page=50、page=3&per_page=50,最后一组可设为 page=3&per_page=37 精确补足剩余条目。
注意:page值超过总页数时,API静默返回空数组,不会报错也不会提示——必须靠X-Total-Count提前预判边界。
网页端调试时快速验证参数效果
方法一:在秘塔API页面左侧配置区,找到「结果数量」输入框,直接填入数字(如42),右侧脚本会实时更新含 per_page=42 的调用代码。
方法二:复制生成的cURL命令,在终端执行后检查返回JSON数组长度是否等于设定值;若始终为10,大概率是忘记勾选「搜索」功能类型,导致请求被路由到无分页能力的模块。


















