Sub2API 并发控制是双层的:per-user 并发(默认 5,config 示例)与 per-account 并发;另有可配置的 request/token Rate Limiting。团队翻车常见形态不是“总额度不够”,而是单成员的批处理任务占满用户并发,或单上游账号并发被打满拖垮全组。
适用场景:团队多人同时用 Claude Code/Codex 类长会话客户端,或有人跑批量脚本导致其他人排队/报错时。
Concurrency Control Rate Limiting 并发 限流
操作步骤
- 先按成员工作类型定 user 并发:交互式编程成员与批处理任务不要同档。
- 按上游账号的实际承受力定 account 并发,分组内账号数变化后回头复核。
- 给批处理/自动化单独发 Key 并单独限流(思路借鉴条目 14 的 per-key RPM/TPM,Sub2API 侧对应 request/token rate limits,具体字段以 LIN 版本为准)。
- 调完后用条目 2 的方法做并发压测小样,再全量生效。
配置说明
已核验:default.user_concurrency: 5 只是 config 示例默认值,不是推荐值。Simple Mode 下另有 API Key 的 5h/日/7日消费窗口(条目 9),与并发是两回事,不要混为一谈。
注意事项
- ⚠️ 只调大不调小:并发放大后先撞的是上游账号的限流/风控,整组一起遭殃。
- ⚠️ 把长会话客户端的“连接数”当成“并发请求数”来配 WebSocket ingress(见条目 3 config_notes),两套限制互相误伤。