SuperAPI AI 工具集

twinmind-rate-limits

编程与开发

查看项目

更新于 10-15 23:30

技能介绍

用途:该技能用于在调用 TwinMind API 时处理速率限制,通过指数退避、请求队列与请求优化,避免限流错误导致应用崩溃。

主要能力:

  1. 指数退避与抖动重试:仅在 429/503 时重试,优先读取 Retry-After 响应头,否则按 baseDelayMs * 2^attempt 加随机抖动计算延迟,并受 maxDelayMs 上限约束。
  2. 请求队列:基于 p-queue,按 free/pro/enterprise 三档配置并发数与每分钟请求上限(free 并发 1、30/分钟;pro 并发 3、60/分钟;enterprise 并发 10、300/分钟),支持优先级、暂停、恢复与清空。
  3. 速率监控:解析 X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset 响应头,计算剩余额度与重置时间,支持在剩余低于阈值时提前节流。
  4. 自适应限流:根据成功与失败记录动态调整延迟,成功时逐步降低延迟,遇到限流时增加延迟,并按时间窗口重置统计。
  5. 批量转录:将多个音频 URL 聚合后调用 /transcribe/batch 接口,减少请求总数。

使用方式:按资料中的步骤依次实现 rate-limit.ts、queue.ts、rate-monitor.ts、adaptive-limiter.ts、batch.ts 等模块,并在业务调用中包裹 withRateLimit 或通过 TwinMindQueue 提交任务。

适用场景:需要稳定调用 TwinMind 转录、摘要、记忆搜索等接口,且对限流敏感的生产环境。

限制:需要 TwinMind API 访问权限(Pro/Enterprise),并熟悉 async/await 与限流概念;资料未提供具体安装命令、完整依赖版本或官方 SDK 细节,部分接口路径与字段以实际 API 为准。