秘塔AI搜索API默认QPS限流为3，超限返回429错误；需在客户端用线程池（max_workers=3）或令牌桶（@limits(calls=3,period=1)）控制并发，并携带X-Request-ID字段以获取Retry-After提示。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你要用秘塔AI搜索API批量处理100个关键词、每秒发起5次请求却频繁收到429错误或结果截断时，必须在客户端层主动控制并发节奏，不能依赖服务端自动限流。
确认服务端默认并发限制
秘塔AI搜索API对同一API_KEY的调用默认启用QPS=3的硬性限流——即每秒最多3次成功请求。超出后返回HTTP 429状态码，且不计入额度消耗，但会中断后续请求链。
这一步无需额外配置，但【若未在请求头中携带X-Request-ID字段，429错误将不附带Retry-After提示，导致重试逻辑失效】。
Python requests + ThreadPoolExecutor 控制并发数
方法一：固定线程池上限
使用concurrent.futures.ThreadPoolExecutor(max_workers=3)，严格限定同时活跃请求数为3。这是最稳妥的初阶方案，适配所有网络环境。
方法二：动态令牌桶（推荐）
安装ratelimit库：pip install ratelimit；在每个search函数上添加@sleep_and_retry @limits(calls=3, period=1)装饰器。该方式能自动平滑突发流量，比线程池更贴合秘塔QPS语义。
注意：两种方法都需确保每个请求头含Authorization: Bearer YOUR_API_KEY和X-Request-ID: uuid4()，否则限流策略可能误判为不同客户端。
Node.js 批量调用并发控制
第一步：安装p-limit库 → npm install p-limit
第二步：初始化限流器 const limit = pLimit(3)
第三步：将全部搜索任务包装为Promise数组，用limit.map(tasks, async task => { ... })执行。p-limit内部采用微任务队列，比原生Promise.all更可控，且失败任务不会阻塞其余请求。
第四步：捕获单个请求错误时，必须检查response.status === 429并暂停当前批次2秒后再续跑——因为秘塔的限流窗口是滑动1秒窗，硬等1秒可能仍被拦截。
绕过并发限制的合规路径
方法一：申请企业版白名单
登录秘塔开发者后台 →「配额管理」→ 提交QPS扩容工单，注明业务场景（如“电商竞品监控系统”），企业版可获批QPS=20～50，无需改代码。
方法二：分账号轮询
创建3个子账号，各自分配独立API_KEY，在客户端实现KEY轮转调度。每个KEY维持QPS=3，整体等效QPS=9。此法适用于无法升级企业版但需短期提速的场景。
【子账号必须绑定不同手机号与邮箱，否则系统判定为同一主体，仍按总QPS=3统一流控】。
