跳转到主要内容
您可以在预算管理页面灵活设置和管理团队成员及 API Key 的费用预算,有效控制各层级的成本支出。
该功能目前仅对团队账号开放。个人账号或未加入团队的账号仅展示菜单,不提供预算功能。您可以通过团队管理功能,将个人账户升级为团队账户,或加入现有团队与他人协作。

预算管理权限说明

  • 团队所有者、管理员及财务管理员可以查看并调整所有成员的预算,以及成员名下所有 API Key 的预算
  • 开发者、基础用户只能查看自身的预算类型与额度(含名下 API Key 的预算),无法修改

成员预算与 API Key 预算

您可以为每位团队成员设置整体预算,也可以为单个 API Key 单独设置消费上限:
  • 成员预算:管控该成员在所有服务(模型 API、GPU 实例、沙箱等)的总消费,是该成员的消费天花板
  • API Key 预算:为某个 Key 单独设置消费上限,仅针对该 Key 的模型 API 调用;GPU 实例、沙箱等产品不受 Key 预算约束,但计入成员预算总额
两项限额同时生效,哪个先达到上限就先暂停对应服务:
  • 某个 Key 预算用完 → 该 Key 停止服务,该成员的其他 Key 和 GPU 等服务不受影响
  • 成员预算用完 → 该成员名下所有服务同时暂停;GPU 实例等按时计费产品无法继续创建新资源,已创建的实例按原计费周期自然结束

预算类型说明

成员预算和 API Key 预算均支持以下三种类型,可独立配置、互不依赖:
类型说明重置行为
无上限不设消费上限,消费仍会记录用于报表
固定总预算设定总额度,用完后服务暂停不重置,需管理员手动上调额度后恢复
月度预算设定每月可用额度,用完后服务暂停每月 1 日 00:00(UTC+8)自动重置,未用完额度不结转
类型组合示例:
  • 成员:月度 $500 + Key:月度 $100 → 常规双层管控
  • 成员:无上限 + Key:月度 $50 → 信任该成员整体消费,但对某个公开服务 Key 单独限额
  • 成员:月度 $500 + Key:固定总预算 $200 → Key 用于有明确总预算的一次性项目

「未设置」与「无上限」的区别

  • 未设置:管理员尚未为该成员 / Key 配置过预算,建议及时配置,避免管理盲区
  • 无上限:管理员有意选择不限制消费,定期 review 即可

切换预算类型

切换预算类型时,系统按以下规则处理已用额度与重置周期:
切换方向已用额度重置行为
无上限 → 固定总预算从 0 开始,不追溯切换前消费不重置
固定总预算 → 月度预算历史消费保留显示,从切换时刻起计入月度用量下月 1 日起按月自动重置
月度预算 → 固定总预算当前已用额度保留,停止月度重置不再重置
任意类型 → 无上限清除预算配置立即恢复无限制

月度预算说明

自动重置

月度预算在每月 1 日 00:00(UTC+8)自动重置:已用额度归零,额度恢复为设定值。当月未用完的额度不会结转到下月。

调整月度额度

管理员可以随时修改月度预算金额,修改立即生效。调整后的可用余额 = 新额度 − 当月已用。 几种常见情况:
  • 上调额度:可用余额同步增加,若原先已暂停服务,调整后立即恢复
  • 下调额度:可用余额相应减少,若新额度低于当月已用,该成员的服务将立即暂停,上调额度后即可恢复
  • 固定总预算追加额度:直接上调预算上限即可,不支持手动清零已用额度

设置及调整成员预算

  1. 进入预算管理页面,在成员列表中找到目标成员,或通过搜索框快速定位。 budgets01 Pn
  2. 单击「编辑」按钮,选择预算类型并填写额度。
    • 新成员默认「无上限」,可随时调整。
    • 「固定总预算」和「月度预算」类型均需填写预算金额。
    budgets02 Pn
  3. 单击「刷新」按钮可获取最新预算与消费数据。 budgets03 Pn
预算变更实时生效。额度用尽后,该成员将无法继续发起新的服务调用,请在调整前确认好额度设置。

设置 API Key 预算

主入口: 进入预算管理页面,单击成员行的「查看 API Key」,在弹窗中查看该成员名下所有 Key 的预算状态并进行编辑。 辅助入口: 进入「模型 API → API Keys」页面,在 Key 列表中可查看预算状态标签,单击 Key 详情后可跳转至预算管理页进行配置。 API Key 预算支持与成员预算相同的三种类型(无上限 / 固定总预算 / 月度预算),配置方式相同。
API Key 预算目前仅限制模型 API 的调用消费,GPU 实例、沙箱等产品的消费不受 Key 预算约束,但仍计入成员预算总额。
API Key 被删除后,该 Key 的预算配置自动归档,历史消费记录保留可查。

预算用尽后的提示

预算用完后,页面和 API 响应均会提示是哪一层的额度已用尽:
  • 成员预算用完:「您的成员预算已达上限($200 / $200),所有服务暂停,请联系管理员调整。」
  • API Key 预算用完:「API Key your-key-name 的预算已达上限($50 / $50),其他 Key 不受影响。」
  • 两层同时达到上限:优先展示 Key 级提示,并附带成员预算的当前状态说明。
管理员可进入预算管理页直接上调对应额度或切换预算类型,调整后立即生效。