HopBase大模型 API 预算要控制住，靠的是「额度先于账单」：先给每个部门、每个成员设月度额度，再给每把自动化服务用的 Key 单独设封顶，额度用完后请求在处理之前就被拒绝（HTTP 402 insufficient_quota），所以一个跑飞的 Agent 循环最多花到它的封顶为止。在 HopBase，部门与成员额度在你设定的账期日（每月 1–28 号）统一重置；企业余额可设多档预警，跌破时发邮件和站内通知；再配合按任务选更便宜的模型、用好提示词缓存，以及每周一次导出 CSV 复盘，超支就从「月底才发现」变成「当天就被拦住」。
AI 用量为什么容易超支
- 按 token 计费，成本跟着调用量走：没有固定月费，一个新上线的功能、一段写错的重试逻辑，都会让花费在几小时内翻倍。
- 自动化服务没人盯：Agent、批处理、定时任务在夜里也在跑，循环一旦没有退出条件，就会一直调用。
- 一把 Key 多人共用：事后分不清是谁、哪个项目花的钱，也就没法追责和优化。
- 模型选得「一律最好」：分类、抽取这类简单任务也用旗舰模型，单价差距直接变成账单差距。
所以 token 成本管控的目标很具体：每一笔消耗都有归属，每个归属都有上限，上限被触发时系统自动拦截，而不是靠人每天看账。
第一步：搭好三级额度——部门、成员、密钥
HopBase 企业账号下，企业主（或企业管理员）可以创建团队成员、建部门，消耗统一从企业余额扣。额度分三级，各管一件事：
| 额度层级 | 管什么 | 重置方式 | 适合谁 |
|---|---|---|---|
| 部门额度 | 整个部门（含成员与归属该部门的 Key）每月最多花多少 | 账期日统一重置 | 按部门做预算的财务口径 |
| 成员额度 | 单个成员每月最多花多少 | 账期日统一重置 | 工程师、运营等个人使用 |
| 密钥额度 | 这一把 Key 的消耗封顶 | 按需手动调整 | Agent、批处理、线上服务 |
几条规则要先弄清楚：
- 成员额度之和可以超过部门额度，此时按先花先得——部门额度先用完，部门内所有请求都会被拒。
- 部门负责人会收到本部门及成员的额度预警，可以管理本部门成员（增删改、调额度、停用、换分组），但不能改部门额度、账期和负责人本身，这些由企业主或企业管理员定。
- 没挂成员的 Key 可以直接归到部门，自动化服务的消耗也就算进部门预算。
第二步：给自动化服务的 Key 单独封顶
给团队设 AI 额度，最容易漏掉的是机器。建议每个自动化服务一把独立 Key，并在创建时设好：
- 额度：按该服务正常用量的 1.5–2 倍设封顶，留出波动空间，但挡住失控。
- 分组：每把 Key 含 1–10 个分组，只能调这些分组里的模型；给批处理 Key 只挂便宜模型所在的分组，代码写错了也调不到旗舰模型。
- 过期时间、IP 名单、并发：临时任务设过期时间；线上服务锁定出口 IP；并发上限也能压住突发流量。
Key 额度用完后，请求在处理之前就返回 402，不会先生成再扣费。你的代码应把 402 当作「停下来」的信号，而不是重试：
from openai import OpenAI, APIStatusError
client = OpenAI(api_key="sk-your-key", base_url="https://api.hop-base.com/v1")
def step(messages):
try:
return client.chat.completions.create(model="your-model", messages=messages)
except APIStatusError as e:
if e.status_code == 402: # insufficient_quota：额度已用完
raise SystemExit("Key 额度已用完，停止 Agent 循环并通知负责人")
raise
要临时止血，也可以在控制台随时禁用或吊销这把 Key，立即生效。
第三步：余额预警分档 + 账期日重置
额度管「谁能花多少」，余额预警管「企业还剩多少」。在企业余额上按可用余额设多档阈值，比如「够两周」「够一周」「够三天」三档，跌破任一档就发邮件和站内通知。这样充值决策提前落到财务手里，而不是等到所有请求都 402 才发现。
账期日建议与公司财务月结对齐（可选每月 1–28 号）。到账期日，部门与成员的月度额度统一重置，新一个月从零计。
第四步：降低单价的两个杠杆
- 按任务选模型：分类、改写、抽取用轻量模型，复杂推理和代码再用旗舰模型。HopBase 按各厂商官方牌价 × 分组折扣结算，同一个模型在不同分组的折扣也不同，怎么挑见分组路由降本指南。
- 用好提示词缓存：长系统提示、长文档、多轮对话的固定前缀命中缓存后，按厂商的缓存读价计费，通常明显低于普通输入价。写法与命中条件见提示词缓存省钱指南。
第五步：每周 15 分钟复盘
- 打开用量页，日期选最近 7 天，导出 CSV（可按 Key、成员、部门、Key 创建人筛选；单文件最多 5 万行、可选 400 天）。
- 按「实扣金额」排序，看花费最多的前 5 把 Key 和前 5 个模型，和上周对比。
- 抽查几行，用「官方成本 × 折扣 ÷ 汇率 = 实扣」复算；失败请求不计费，不会出现在扣费里。
- 对增长异常的 Key：问创建人原因，必要时下调额度或换到更便宜的分组。
- 看预警记录：一周内被同一档反复触发，说明额度或充值节奏需要调整。
逐行对账和按部门分摊的完整方法见大模型 API 用量对账与部门分摊。
示例：一家 30 人公司的预算表（数字均为假设）
以下数字纯属示例，用来说明怎么分配，不代表任何真实客户，也不代表 HopBase 的价格。
| 对象 | 示例额度（美元/月） | 说明 |
|---|---|---|
| 研发部 | 1,800 | 8 名工程师每人 200（合计 1,600，可先花先得），另含 2 把服务 Key |
| 研发部 · 代码审查 Agent Key | 150 | 只挂轻量模型分组，IP 锁定 CI 出口 |
| 客服部 | 700 | 4 名成员每人 200（合计 800 > 700，先花先得） |
| 市场部 | 300 | 2 名成员每人 150 |
| 余额预警 | 1,500 / 800 / 300 | 可用余额跌破任一档即发邮件 |
假设某天代码审查 Agent 因为一个解析错误陷入循环：它会持续调用，直到这把 Key 的 150 封顶用完，此后所有请求返回 402，研发部其余成员不受影响，部门负责人收到额度预警，第二天的周复盘里这把 Key 会排在第一位。损失被限定在 150 以内。
常见问题
大模型 API 预算怎么控制，最少要做哪几步？
最少三步：按部门和成员设月度额度、给每个自动化服务一把带封顶的独立 Key、在企业余额上设至少两档预警。做到这三步，单个失控的程序就不会把整个月预算花光。
额度用完了请求会怎样，会不会先扣钱？
不会。额度不足时请求在处理之前就被拒绝，返回 HTTP 402 insufficient_quota，不产生费用；失败请求也不计费。调高额度或到账期日重置后即可继续使用。
能不能给团队成员设 AI 额度，并且每月自动清零？
可以。成员额度和部门额度都是月度额度，在你设定的账期日（每月 1–28 号）统一重置。密钥额度是单把 Key 的封顶，需要时手动调整。
想按这套方法给团队设预算，可以注册 HopBase 企业账号，建部门、分额度、发 Key，几分钟就能配完。