SuperAPI AI 工具集

elevenlabs-rate-limits

通用与其它

查看项目

更新于 10-15 23:25

技能介绍

用途:处理 ElevenLabs 语音合成的限流问题,包括 429 错误、重试逻辑与并发管理。ElevenLabs 有两类限流:按套餐的并发请求上限和系统级节流。关键在于同一个 429 因 detail.status 不同而含义相反:too_many_concurrent_requests 表示超出套餐并发,应排队而非退避;system_busy 表示服务过载,应指数退避。

主要能力:按套餐大小配置请求队列(p-queue);对 system_busy 与 5xx 做带抖动的指数退避,对并发错误快速短重试,对 401/400/404 直接失败;轮询 user.subscription 字符用量,超过阈值告警并阻断会超额度的请求;将三者组合为 resilient-client,使 generateSpeech() 自动完成配额校验、排队与退避。

套餐并发上限:Free 2、Starter 3、Creator 5、Pro 10、Scale 15、Business 15(字符额度分别为 1 万、3 万、10 万、50 万、200 万、自定义)。模型按字符消耗积分:eleven_v3 与 eleven_multilingual_v2 为 1.0,eleven_flash_v2_5 与 eleven_turbo_v2_5 为 0.5,开发阶段可用 Flash/Turbo 节省配额。

使用方式:需安装 @elevenlabs/elevenlabs-js,建议 npm install p-queue,并了解自身套餐限制。构建 rate-limiter.ts、backoff.ts、quota-monitor.ts、resilient-client.ts 四个模块后组合调用。例如用 createRequestQueue("pro") 限制并发 10,将多个转换请求加入队列执行。错误处理:并发超限时排队约 50ms 后重试;system_busy 按 1s、2s、4s、8s 退避;401 配额耗尽时停止请求并等待重置;5xx 指数退避最多重试 5 次。

限制:资料未提供超出上述范围的实现细节或价格信息,具体配额以 ElevenLabs 官方为准。