经验案例
按项目拆 Key 与命名
Key 按项目、环境、用途和负责人拆分。
阅读全文 →经验案例
用量监控
看余额趋势、调用日志、模型分布和异常增长。
阅读全文 →经验案例
额度与预算控制
给项目 Key 设配额，批量脚本单独限额。
阅读全文 →经验案例
模型分档
简单任务用经济模型，复杂任务用满血模型。
阅读全文 →经验案例
月底对账
用一张小表按项目、Key、模型和异常汇总。
阅读全文 →经验案例
轮换、停用与泄露处理
Key 放服务端密钥管理，泄露后立即作废重建。
阅读全文 →github_project
Sub2API 本体：团队统一 API 路由的底座
一站式开源中转/网关：把 Claude、OpenAI、Gemini、Grok 等订阅/API 统一接入，平台侧做鉴权、token 级计费、负载均衡与转发，用户只拿平台发的 Key。团队价值不在“多一个
阅读全文 →experience
最小可用链路：1 个上游 + 1 个分组 + 1 个测试用户 + 1 把受限 Key
第三方自托管指南给出的最小验证法：不要一上来灌全部账号和成员。先一条链路端到端跑通，并核对请求落账的 user / key / group / account / model / token 数 /
阅读全文 →experience
上游账号池与智能调度：多账号、粘性会话与 Nginx 坑
Sub2API 的账号池不是简单堆账号：官方功能含 Smart Scheduling（智能选号 + sticky sessions）。同一会话尽量落同一账号，避免多轮上下文在账号间漂移。但反代配置不对
阅读全文 →experience
分组设计：按平台建具体组，按人群/用途控权限与费率
分组是 Sub2API 权限与计费的实际边界：Key 绑/限到分组，分组决定能打哪些上游账号。官方 Composite Groups 文档给的建组范式是先建具体 provider 组（如 OpenAI
阅读全文 →experience
Composite Groups：一个套餐/一把 Key 路由多家模型
Composite Groups 是管理员路由层：Key 不再绑单一 provider，而是按请求的 model 解析到具体平台（Anthropic / Gemini / OpenAI / Antig
阅读全文 →experience
每成员一把 Key：一人一 Key、按项目再拆分，绝不共用主 Key
网关治理的第一原则（Sub2API 与 LiteLLM 两边一致）：上游凭据只留在网关里，成员拿到的是平台发的、可单独吊销的 Key。Sub2API 侧是 API Key Distribution（给
阅读全文 →experience
额度与余额：用户余额、token 级计费与成本档位设计
Sub2API 的计费是 token 级 Precise Billing，请求按实际命中的具体平台/分组记账；新用户默认余额为 0、默认倍率 1.0（config 示例），意味着不开通动作做对了，新账
阅读全文 →experience
并发与速率限制：per-user / per-account 双层都要调
Sub2API 并发控制是双层的：per-user 并发（默认 5，config 示例）与 per-account 并发；另有可配置的 request/token Rate Limiting。团队翻车
阅读全文 →case
Simple Mode：内部小团队的轻量跑法（案例）
官方为“个人开发者或内部团队快速接入、不需要完整 SaaS 功能”提供了 Simple Mode：隐藏 SaaS 功能、跳过 billing 流程，启动时自动播种默认分组。对 LIN 的团队客户，这是
阅读全文 →troubleshooting
排障：请求不对账 / 调不通时按归属链逐项核
网关类问题的高效排法不是猜，而是沿归属链核：这笔请求最终记在哪个 user、哪把 key、哪个 group、哪个 upstream account、哪个 model、多少 token、扣了多少。dev
阅读全文 →experience
用量审计与成本分摊：按 user / key / group / account 四维出账
Sub2API 的 token 级计费使“谁花了多少”可精确归属；Composite 文档还确认解析出的具体平台会用于 platform usage reporting 与 ops error pla
阅读全文 →troubleshooting
安全 playbook：Key 泄露与成员离职
两类事件都按“先止血、再溯源、后补发”处理。止血靠网关能力：Key 可单独吊销、用户可单独停用，不必动上游账号，更不必全员换 Key——这正是团队用网关而非共用上游凭据的核心收益（botmonster
阅读全文 →github_project
对照系统（标注来源）：New API 的渠道/令牌治理
统一 AI 模型聚合与分发网关，术语体系是渠道（channel）/ 令牌（token）/ 分组（group）/ 用户（user）。其可迁移经验集中在令牌的字段级管控与渠道路由：令牌可设过期、剩余额度、
阅读全文 →github_project
对照系统（标注来源）：LiteLLM 的团队预算治理
其团队治理是开源网关里文档最全的：Organization / Team / Internal User / Virtual Key 四层，spend 同时归属 key、user、team、org，*
阅读全文 →github_project
移动管理端：sub2api-mobile（生态项目）
Sub2API 官方 README 生态表收录的移动管理控制台（仓库 ckken/sub2api-mobile，MIT，231 stars 快照）：跨平台 App（iOS/Android/Web，Ex
阅读全文 →github_project
用量/余额监控工具：All API Hub 与 pi-sub2api-usage
两个已核验的“成员/管理员侧”监控工具，补 Sub2API 后台之外的日常可见性：① All API Hub（qixing-jk/all-api-hub，AGPL-3.0，4,935 stars 快照
阅读全文 →