ENTERPRISE GUIDE

企业团队接入指南:自建 sub2api,统一管理员工 API 与用量

企业自建 sub2api 接入 RootFlowAI,统一采购模型服务,为员工分配独立账号、API Key、权限和内部预算。

企业可以在 RootFlowAI 统一采购模型服务,再通过自己部署的 sub2api,为员工提供独立账号、API Key、使用权限和内部预算。员工使用企业自己的 API 地址,管理员集中维护上游连接,并按员工查看用量。

本文面向企业内部使用,配置参考 sub2api v0.2.21。更新时间:2026 年 11 月 14 日。不同版本的菜单名称可能略有差异。

部署完成后,员工如何使用

请求经过以下链路:员工的工具 → 企业自建 sub2api → RootFlowAI → 对应模型服务。

员工分别持个人 API Key 连接企业自建 sub2api,网关通过企业上游 Key 接入 RootFlowAI;企业管理员负责权限、预算和用量

图 D01:员工使用个人 Key,企业网关统一接入 RootFlowAI;管理员在企业平台维护权限、预算和用量。查看清晰原图。

例如,企业使用 https://ai.example.com 作为内部 AI 平台:

  • 管理员在 RootFlowAI 创建企业专用上游 Key,将它保存在 sub2api 中。
  • 管理员在 sub2api 为 Alice、Bob 创建普通员工账号并分配预算。
  • 员工登录 https://ai.example.com,创建自己的 API Key,配置开发工具。
  • 管理员按员工查询用量;员工离职后,停用对应账号及 Key。

ai.example.com 是示例域名。实际操作时,请替换为企业自己的域名。

先分清两套账号和 Key

项目RootFlowAI企业自建 sub2api
谁登录企业采购或平台管理员企业管理员和员工
账户用途统一采购、维护上游权限、核对实际消耗管理员工、内部预算、个人 Key 和用量
API Key 用途供 sub2api 连接 RootFlowAI供员工的工具连接企业网关
管理入口RootFlowAI 账户中心企业自己的平台域名
员工拿到什么通常不直接领取上游 Key本人的登录账号和个人 API Key

企业在 RootFlowAI 只需维护一个账户。根据协议、权限和预算隔离需要,可以在这个账户下创建少量专用上游 Key,例如分别用于 Claude 和 GPT;不必按员工数量创建上游 Key。

sub2api 的“账号管理”主要管理上游供应商连接,“用户管理”管理员工登录账户。本教程会分别称为“上游账号”和“员工账号”。

采购额度与员工预算有什么区别

RootFlowAI 余额用于实际采购结算;sub2api 员工余额用于企业内部的用量分配和访问控制。

RootFlowAI 账户总览中的当前余额、区间净消费、请求数与模型消费统计

图 D02-A:在 RootFlowAI 账户中心查看采购账户余额和实际消费,作为上游结算依据。查看清晰原图。

企业 sub2api 管理控制台中的用户数、请求数、Token 用量与模型统计

图 D02-B:在企业 sub2api 查看内部请求与用量统计。右上角余额属于企业平台内的登录账户,员工预算在“用户管理”中单独设置。查看清晰原图。

两张截图的统计范围和时间窗口不同,不用于金额直接对比。sub2api 截图版本为 v0.2.19,本文配置参考 v0.2.21,菜单以实际部署版本为准。

分配内部预算不会给上游充值。

在 sub2api 给员工增加余额,不会增加 RootFlowAI 账户余额。sub2api 页面中的 $ 表示其内部计价单位,不能直接理解为人民币,也不代表与 RootFlowAI 实际扣费金额自动一致。

模型价格、分组倍率、缓存单价和统计时区会影响两边记录。企业可以先用内部预算控制使用范围,再按实际采购价格校准成本分摊。详见添加员工与设置预算。

按角色选择阅读路线

你现在要做什么从这里开始
第一次部署企业平台部署你的企业网关
已经部署,需要连接 RootFlowAI接入 RootFlowAI
给同事开通账号、分配预算添加员工与设置预算
我是员工,只需要配置工具员工快速开始
员工离职、备份或升级日常管理与维护
调用失败、没有模型、额度异常常见问题排查

管理员建议按“部署 → 接入 → 添加员工”的顺序完成配置,然后将员工快速开始页面发给同事。员工无需阅读服务器部署章节。

推荐的内部使用方式

  • 使用 Linux 服务器和 Docker Compose 部署,配置企业域名及 HTTPS。
  • 使用 standard 模式,让员工余额参与校验。
  • 由管理员创建员工账号,关闭不需要的公开注册入口。
  • 为每位员工建立独立普通用户,由员工自行管理个人 Key。
  • 先接通一个模型平台,再通过复合分组扩展到多个平台。
  • 管理员维护用户余额、授权和并发限制,员工的 Key 限额用于进一步约束个人工具。

员工一个 Key 同时使用多个模型平台,需要配置复合分组;普通分组通常对应具体平台。具体步骤见接入 RootFlowAI。

上线前完成这些检查

  1. 企业域名通过 HTTPS 访问,管理员可以正常登录。
  2. 上游 Key 权限、模型配置、分组授权一致,至少完成一个实际请求。
  3. 两名员工能分别登录,只能查看自己的 Key 和个人明细。
  4. 员工无法自行增加用户余额或获取未授权分组。
  5. 停用一名员工后,另一名员工仍可使用。
  6. 已保存可恢复的备份,并明确日常维护人员。

企业管理员负责自建服务器、sub2api 配置、员工权限和数据备份;RootFlowAI 提供上游 API 服务及本站账户的使用支持。自建网关的可用模型,取决于上游 Key 权限、sub2api 支持的协议以及企业配置。

下一步:部署你的企业网关。已部署的管理员可直接查看接入 RootFlowAI。