Skip to main content
月度支出上限会监控你在 BYOK 模型上的花费,并在该支出接近你设定的上限时通知组织的 Owner。它是一个提前预警信号,而不是硬性阻断。
这是通知,不是上限。Kodus 在达到限额时绝不会阻断或暂停审查。 超过 100% 之后,支出仍会在你的提供商账户上继续累积。要真正停止支出,请在模型提供商的控制台(OpenAI、Anthropic、Google 等)中设置硬性限额 —— 只有它能强制执行。请把 Kodus 的限额当作提前预警,好让提供商侧的上限不会突然袭击你。

​
它统计什么

  • 仅 BYOK 模型。 支出是针对你在 Bring Your Own Key 中配置的模型统计的 —— 也就是你直接向提供商付费的那些密钥。Kodus 自己一侧运行的模型不计入。
  • 按当前费率、逐模型计价。 每个模型的 token 按该模型的当前费率计价。不存在快照 —— 如果某个模型的价格发生变化(目录更新或手动修改),该模型当月至今的用量会按新费率重新计算。切换到另一个模型不会重新计价你之前用的模型。
  • 按自然月(UTC)。 统计窗口从当月 1 日到次月 1 日。用量会在每月初自动归零为 $0 —— 无需手动重置。
为了让数字只反映 Kodus 的部分,我们建议你给 Kodus 的 API 密钥仅用于 Kodus。如果同一个密钥还驱动其他工具,提供商侧的用量 —— 以及基于它的任何估算 —— 会把两者混在一起。

​
如何配置

该限额位于 BYOK 页面,在你的 Main 和 Fallback 模型下方。
1

打开 BYOK 设置

前往 app.kodus.io/organization/byok,滚动到 Monthly spend limit。(该区块在你配置了至少一个 BYOK 模型后才会出现。)
2

核对模型价格

每个已配置的模型都会显示其每 token 价格 —— input、output、cache read、cache write —— 单位为 $ / 1M tokens。Catalog 徽标表示 Kodus 自动找到了价格;Manual 徽标表示是你自己填写的。
3

修正没有价格的模型

带 No price 徽标的模型无法自动定价(自定义或未收录的模型)。请照着提供商的价格页填写其每 token 价格。在所有模型都有价格之前,你无法启用该限额 —— Kodus 无法定价的模型也无法追踪其支出。
4

设置月度限额并启用

以美元填入你的上限,打开 Enable spend alerts,然后点击 Save spend limit。

​
模型定价

Kodus 会在公开的价格目录中查找每个模型,并预填找到的值(Catalog)。如果目录有误或缺少该模型,请填入正确的每 token 费率 —— 徽标会变为 Manual,并改用你的数值。
在你覆盖过的模型上点击 Revert to catalog price。输入框会重置为目录值,徽标也变回 Catalog。此后该模型将重新跟随实时的目录价格(不存在冻结快照)。
自定义端点、自托管模型,或目录尚未收录的模型没有自动价格。手动填入费率即可让它们可被追踪。在此之前,该限额无法启用。

​
提醒

启用后,Kodus 大约每小时一次检查你当月至今的支出,并在你跨过每个阈值时,通过邮件和应用内通知中心通知组织的 Owner: 每个阈值每月最多触发一次,因此你不会为同一级别收到重复提醒。进入新的月份后会自动重置。
在整个过程中审查都照常运行 —— 50% 时、100% 时,以及超出之后。唯一发生的事情就是这些提醒。
你可以在通知设置的 Spend Limit 中管理它们的送达位置(以及哪些角色会收到)。

​
准确性

支出是一个估算值。它由你的审查所消耗的 token 以及 BYOK 页面上显示的每 token 价格推算而来 —— 不会与提供商账单精确到分。

保持价格准确

把目录价格与提供商的价格页对照,修正偏差。订阅制/统一费率套餐尤其无法与按 token 的目录定价对上。

密钥只用于 Kodus

专用密钥意味着 Kodus 看到的用量就是 Kodus 造成的用量 —— 不会有别的东西把数字撑大。
并发审查可能短暂超出上限。 在接近限额时同时审查大量 PR,可能会在下一次每小时检查捕捉到之前,把当月支出推过 100% 一点。这是预期行为 —— 这也是真正的上限应该设在提供商那边的又一个理由。

​
常见问题

不会。它只是通知。要停止支出,请在你的模型提供商的账单控制台中设置硬性限额。
只有你的 BYOK 模型上的 token 用量,按 BYOK 页面上显示的当前费率计价。Kodus 托管的模型不计入。
每个自然月的 1 日(UTC)。当月至今的支出归零为 $0,所有阈值提醒自动重新武装。
不会。支出是按模型追踪的:每个模型的 token 按该模型的费率计价。如果你在模型 A 上花了 $50 然后切换到模型 B,模型 A 的用量仍然是 $50 —— 切换到 B 绝不会把 A 的 token 按 B 的费率重新计价。你的总额只是随着 B 之后的用量而增长。唯一会让已发生用量被重新计价的,是同一个模型的价格发生变化 —— 当价格目录更新了某个模型的费率,或你在 BYOK 页面编辑了它的手动价格时,该模型当月至今的用量会按新费率重新计算(不存在冻结快照)。
每个已配置的模型都必须有价格(目录或手动),且月度限额必须大于 $0。修正所有 No price 的模型,设置一个正数金额,然后保存。
你组织的 Owner,在应用内的通知中心收到。可在通知设置的 Spend Limit 中调整路由。