HopBase企业给员工分配大模型 API Key,最稳的做法是:不要共用一把 Key,而是给每位员工开一个成员账号,让他用自己的邮箱登录、自己建 Key;再把成员归到部门,按「密钥 → 成员 → 部门」三级设额度,每月在固定账期日统一重置。在 HopBase 控制台里,所有消耗从企业余额扣、按成员和部门归属,用量页可按部门筛选并导出 CSV 给财务分摊。下文按顺序讲每一步、各角色权限,以及哪些 Key 给人、哪些给服务。
为什么不能一把 Key 全公司共用
共用 Key 的问题不在于贵,而在于三件事都做不了:
- 看不清是谁花的:账单只有一个总数,没法按人或部门分摊;
- 管不住上限:某个脚本死循环,能把整个月的预算一次烧完;
- 回收不了:员工离职或 Key 泄露,只能整把作废,所有业务一起停。
拆成「成员 + 部门 + 多把 Key」后,这三件事都有了着落。
第一步:规划组织结构
动手前先在纸上画一张表,回答三个问题:
- 有哪些部门(例如研发、数据、市场、客服)?每个部门谁负责?
- 每个部门、每个人每月大概花多少美元?
- 有哪些「不属于某个人」的服务要调模型(线上客服机器人、夜间批处理、CI 测试)?
第 3 个问题决定后面哪些 Key 挂在成员名下、哪些直接挂在部门名下。
第二步:建部门、设账期日
- 进入控制台「团队管理 → 部门」,逐个添加部门。
- 给部门填部门额度(美元,本期可消耗上限)。部门额度是限额,不从余额预扣;留空表示不限。部门下所有成员与密钥的消耗共用这个额度。
- 设置每月账期日(1–28 号任选)。部门和成员的月度额度都在这一天统一清零本期已用。改账期日从下一个账期日起生效,当前期不会提前清零。
建议把账期日设在财务月结前一天或当天,这样一期的用量正好对应一个结算周期。
第三步:添加成员并分配额度
- 「团队管理 → 成员 → 添加成员」,填成员名称、登录邮箱和初始密码。成员用这个邮箱密码登录,登录后可以自己改密码。
- 选择所属部门。成员的消耗同时计入部门额度。
- 填成员额度(美元,必填),选择「按月重置」或「一次性总额」。成员名下所有密钥与工作台的消耗共用这个额度。
- 勾选可用分组,限制这位成员能用哪些模型套餐;一个都不勾表示继承企业的全部分组。
成员登录后可以自己创建密钥、使用工作台与 AI Chat。如果不希望成员看到价格和折扣,可以关闭成员的价格显示,成员只看可用资源与用量,额度与余额照常显示。
注意一个边界:同一部门里成员额度之和超过部门额度时,先花先得——部门额度用完后,即使某个成员自己还有额度,请求也会被拒绝。额度不足的请求在处理前就被拒绝,返回 HTTP 402 insufficient_quota,不产生费用。错误码说明见错误码文档。
第四步:指定部门负责人与企业管理员
企业主一个人管几十个成员会很累,可以分出两类角色:
- 部门负责人:在部门设置里指定。负责人接收本部门及其成员的额度预警,可以管理本部门成员(增删改、调额度、停用、改可用分组),但不能改部门额度、账期与负责人本身。
- 企业管理员:由企业主授予。与企业主同等管理团队、部门、密钥与用量,费用仍从企业余额扣。适合 IT 或运维负责人。
谁能做什么
| 操作 | 企业主 | 企业管理员 | 部门负责人 | 成员 |
|---|---|---|---|---|
| 添加 / 编辑 / 删除 / 停用成员 | 全企业 | 全企业 | 仅本部门 | — |
| 调整成员额度与可用分组 | 全企业 | 全企业 | 仅本部门 | — |
| 建 / 改 / 删部门,设部门额度与负责人 | 可以 | 可以 | 不可以 | — |
| 设置账期日 | 可以 | 可以 | 不可以 | — |
| 接收本部门及成员的额度预警 | — | — | 可以 | — |
| 创建自己的密钥、用工作台与 AI Chat | 可以 | 可以 | 可以 | 可以(受成员额度约束) |
第五步:Key 给人,还是给服务
一把 Key 可以挂在成员名下,也可以不挂成员、直接挂在部门名下。规则很简单:
| 用途 | 挂在哪里 | 建议设置 |
|---|---|---|
| 个人开发、Claude Code、Cursor 等编码工具 | 成员名下(成员自己建) | 受成员额度约束;离职时随成员一起停用 |
| 线上服务(客服机器人、内部应用) | 不挂成员,直挂部门 | 单独设 Key 额度、并发和 IP 名单;一个服务一把 |
| 批处理、CI 测试 | 不挂成员,直挂部门 | 设过期时间和较小额度,用完即止 |
挂了成员的密钥跟随成员的部门;未挂成员的密钥消耗计入所直挂部门的额度。每把 Key 都可以单独设置:
- 分组:每把 Key 含 1–10 个分组,只能调这些分组的模型,用
GET /v1/models可查看这把 Key 能用哪些模型(见模型列表文档); - 额度、过期时间、IP 名单、并发:过期时间留空表示永不过期;
- 禁用 / 吊销:随时可以操作,不影响其他 Key。
每把 Key 都显示创建人,服务端只存单向哈希。接入时 OpenAI 兼容的 Base URL 是 https://api.hop-base.com/v1,示例 Key 写作 sk-your-key。
第六步:按部门看用量、导出对账
- 打开「用量」页,按日期、Key、成员、部门或 Key 创建人筛选。
- 点「导出 CSV」:单文件最多 5 万行、最长 400 天。列包含时间、模型、用量、官方币种、官方成本、折扣、汇率、实扣金额、备注。
- 每一行都可以复算:官方成本 × 折扣 ÷ 汇率 = 实扣。失败请求不计费。
再加一道保险:按「可用余额」设多档预警阈值,跌破时发邮件和站内通知,避免月中余额见底。完整的分摊方法见大模型 API 用量对账与部门分摊;Key 泄露和员工离职的处理见API Key 泄露与离职回收手册。
所有组织调整、成员变更、额度与权限调整、密钥操作都会记入审计,可按时间与对象查询。需要公司转账、发票或企业结算,请联系 HopBase 团队(sales@hop-base.com)。
常见问题
企业怎么给员工分配大模型 API Key,员工要自己注册吗?
不用。企业主或企业管理员在「团队管理」里添加成员,填登录邮箱和初始密码即可。成员登录后自己建 Key,消耗从企业余额扣,计入该成员和所属部门。
成员额度加起来超过部门额度会怎样?
先花先得。部门额度用完后,部门下所有成员和密钥的请求都会在处理前被拒绝,返回 HTTP 402 insufficient_quota,直到下一个账期日重置,或由企业主调高部门额度。
怎么按部门统计 AI 用量?
在用量页按部门筛选后导出 CSV,每行带官方成本、折扣、汇率和实扣金额,可以逐行复算。挂了成员的 Key 计入成员所在部门,未挂成员的 Key 计入它直挂的部门。