团队软预算警报
为团队设置软预算，当支出超过阈值时接收电子邮件提醒 —— 不会拦截任何请求。
概述
软预算 (Soft Budget) 是一种支出阈值，超过该阈值会触发电子邮件通知，但不会拦截请求。这与硬预算 (max_budget) 不同，硬预算在达到限制后会拒绝请求。
团队软预算提醒功能让您可以：
- 尽早获得通知 — 当团队支出超过软预算阈值时，接收电子邮件提醒
- 保持请求畅通 — 与硬预算不同，软预算永远不会拦截 API 调用
- 定向通知特定接收者 — 将提醒发送给特定的电子邮件地址（例如团队负责人、财务部门），而不仅仅是发送给团队成员
- 无需全局提醒 — 团队软预算提醒通过电子邮件独立发送，无需依赖 Slack 或其他全局提醒配置
团队软预算提醒通过电子邮件发送。您必须在代理 (Proxy) 上配置有效的电子邮件集成（SendGrid、Resend 或 SMTP），以便发送提醒。请参阅 电子邮件通知 以获取设置说明。
一旦您配置了软预算和至少一个用于提醒的电子邮件地址，团队软预算提醒就会自动激活。无需额外的代理配置或重启 — 每次请求都会进行检查。
工作原理
每当使用属于某个团队的 API 密钥发出请求时，代理会检查：
- 该团队是否设置了
soft_budget？ - 团队当前的
spend(支出) 是否 >=soft_budget？ soft_budget_alerting_emails中是否配置了任何电子邮件？
如果这三个条件都满足，则会向配置的收件人发送电子邮件提醒。提醒会自动去重，因此在 24 小时内只会发送一次相同的提醒。
如何设置团队软预算提醒
1. 导航至管理界面 (Admin UI)
进入管理界面（例如 https://:4000/ui 或您的 PROXY_BASE_URL/ui）。
2. 前往团队 (Teams)
点击侧边栏中的 Teams。
3. 选择一个团队
点击您想要为其配置软预算提醒的团队。
4. 打开团队设置 (Settings)
点击 Settings 选项卡以查看团队的配置。
5. 编辑设置
点击 Edit Settings 以修改团队的预算配置。
6. 设置软预算
点击 Soft Budget (USD) 字段并输入您期望的阈值。例如，输入 0.01 用于测试，或输入 500 等更高的值用于生产环境。
7. 添加提醒电子邮件
点击 Soft Budget Alerting Emails 字段，输入一个或多个以逗号分隔的电子邮件地址，以便接收提醒。
8. 保存更改
点击 Save Changes。软预算提醒现已激活 — 无需重启代理。
9. 验证：是否收到电子邮件提醒
当团队支出超过软预算时，系统会向配置的收件人发送电子邮件提醒。以下是提醒邮件的示例：
设置参考
| 设置 | 描述 |
|---|---|
| 软预算 (USD) | 触发电子邮件提醒的支出阈值。当超过此限额时，请求不会被拦截。 |
| 软预算提醒电子邮件 | 以逗号分隔的电子邮件地址，当超过软预算时会收到提醒。至少需要配置一个电子邮件地址才能发送提醒。 |
- 软预算 (Soft Budget)：建议性阈值 — 发送电子邮件提醒，但不会拦截请求。
- 最大预算 (Max Budget)：硬性限制 — 一旦超过预算，即拦截请求。
您可以在同一个团队上同时设置两者，以实现早期预警（软）和硬性停止（最大）。
API 配置
您也可以在创建或更新团队时，通过 API 配置团队软预算。
curl -X POST 'https://:4000/team/update' \
--header 'Authorization: Bearer sk-1234' \
--header 'Content-Type: application/json' \
--data '{
"team_id": "your-team-id",
"soft_budget": 500.00,
"metadata": {
"soft_budget_alerting_emails": ["lead@example.com", "finance@example.com"]
}
}'
相关文档
- 电子邮件通知 – 为 LiteLLM Proxy 配置电子邮件集成（Resend、SMTP）
- 提醒 (Alerting) – 设置 Slack 及其他提醒渠道
- 成本追踪 – 追踪和管理团队、密钥和用户的支出