Sub2API 并发控制是双层的:per-user 并发(默认 5,config 示例)与 per-account 并发;另有可配置的 request/token Rate Limiting。团队翻车常见形态不是“总额度不够”,而是单成员的批处理任务占满用户并发,或单上游账号并发被打满拖垮全组。

适用场景:团队多人同时用 Claude Code/Codex 类长会话客户端,或有人跑批量脚本导致其他人排队/报错时。

Concurrency Control Rate Limiting 并发 限流

操作步骤

  1. 先按成员工作类型定 user 并发:交互式编程成员与批处理任务不要同档。
  2. 按上游账号的实际承受力定 account 并发,分组内账号数变化后回头复核。
  3. 给批处理/自动化单独发 Key 并单独限流(思路借鉴条目 14 的 per-key RPM/TPM,Sub2API 侧对应 request/token rate limits,具体字段以 LIN 版本为准)。
  4. 调完后用条目 2 的方法做并发压测小样,再全量生效。

配置说明

已核验:default.user_concurrency: 5 只是 config 示例默认值,不是推荐值。Simple Mode 下另有 API Key 的 5h/日/7日消费窗口(条目 9),与并发是两回事,不要混为一谈。

注意事项

  • ⚠️ 只调大不调小:并发放大后先撞的是上游账号的限流/风控,整组一起遭殃。
  • ⚠️ 把长会话客户端的“连接数”当成“并发请求数”来配 WebSocket ingress(见条目 3 config_notes),两套限制互相误伤。

来源:https://github.com/Wei-Shaw/sub2api