SuperAPI AI 工具集

clay-rate-limits

通用与其它

查看项目

更新于 10-15 22:42

技能介绍

用途:该技能用于处理 Clay 的速率限制、Webhook 节流与信用额度节奏策略,适用于遇到 429 错误、需要管理 Webhook 提交速率或优化数据补全调用时。

主要能力:梳理 Clay 的三层限制——计划层、Webhook 层与数据补全提供方层;给出按计划区分速率限制的配置思路(如 Explorer 400 条/小时、Pro 与 Enterprise 较高并发,Free/Starter 受限);指出每个 Webhook 生命周期提交上限为 5 万次,且该上限按 Webhook 计算而非按表;提供 429 响应退避重试的写法思路与 Webhook 生命周期管理(预警阈值 4.5 万次、耗尽后新建 Webhook)。

使用方式:资料给出 TypeScript 示例,涉及 src/clay/rate-limiter.ts、src/clay/backoff.ts、src/clay/webhook-manager.ts 等文件,依赖 p-queue;示例演示队列并发控制、Retry-After 读取、指数退避加重试抖动,以及按表注册与记录提交次数。

适用场景:当出现计划层小时限流、Webhook 静默停止、数据补全卡住或 Explorer 计划每小时 400 条限制时,可参考对应处理方式;使用托管账号时由 Clay 内部节流,使用自有 API 密钥时继承提供方限制。

限制与注意:资料未提供具体安装命令与官方文档全文;速率与提供方限制以原文表格为准,可能随 Clay 政策变化。输出需保留幂等键,不应通过新 Webhook 或提高并发掩盖节流失败,达到限制或预算护栏时应停止新提交、安全排空待处理任务并调度经批准的替换方案。