> ## Documentation Index
> Fetch the complete documentation index at: https://ppio.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 团队预算管理

您可以在[**预算管理**](https://ppio.com/billing/budget)页面灵活设置和管理团队成员及 API Key 的费用预算，有效控制各层级的成本支出。

<Note>
  该功能目前仅对团队账号开放。个人账号或未加入团队的账号仅展示菜单，不提供预算功能。您可以通过[**团队管理**](https://ppio.com/settings/team)功能，将个人账户升级为团队账户，或加入现有团队与他人协作。
</Note>

## 预算管理权限说明

* 团队**所有者、管理员及财务管理员**可以查看并调整**所有成员的预算**，以及成员名下所有 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. 进入[**预算管理**](https://ppio.com/billing/budget)页面，在成员列表中找到目标成员，或通过搜索框快速定位。

   <img src="https://mintcdn.com/ppinfra/pGuwYZ6NEz3RzrAp/support/image/budgets01.png?fit=max&auto=format&n=pGuwYZ6NEz3RzrAp&q=85&s=0b14b7d2b0403efca87520d41d26c91e" alt="budgets01 Pn" width="1280" height="687" data-path="support/image/budgets01.png" />

2. 单击「编辑」按钮，选择预算类型并填写额度。

   * 新成员默认「无上限」，可随时调整。
   * 「固定总预算」和「月度预算」类型均需填写预算金额。

   <img src="https://mintcdn.com/ppinfra/pGuwYZ6NEz3RzrAp/support/image/budgets02.png?fit=max&auto=format&n=pGuwYZ6NEz3RzrAp&q=85&s=56360225b9c39063e3ad2e97b21ee9fd" alt="budgets02 Pn" width="1280" height="683" data-path="support/image/budgets02.png" />

3. 单击「刷新」按钮可获取最新预算与消费数据。

   <img src="https://mintcdn.com/ppinfra/pGuwYZ6NEz3RzrAp/support/image/budgets03.png?fit=max&auto=format&n=pGuwYZ6NEz3RzrAp&q=85&s=c6192e8ae8ccaddde7e16b3df591b2f5" alt="budgets03 Pn" width="1280" height="686" data-path="support/image/budgets03.png" />

<Warning>
  预算变更实时生效。额度用尽后，该成员将无法继续发起新的服务调用，请在调整前确认好额度设置。
</Warning>

## 设置 API Key 预算

**主入口：** 进入[**预算管理**](https://ppio.com/billing/budget)页面，单击成员行的「查看 API Key」，在弹窗中查看该成员名下所有 Key 的预算状态并进行编辑。

**辅助入口：** 进入「模型 API → API Keys」页面，在 Key 列表中可查看预算状态标签，单击 Key 详情后可跳转至预算管理页进行配置。

API Key 预算支持与成员预算相同的三种类型（无上限 / 固定总预算 / 月度预算），配置方式相同。

<Note>
  API Key 预算目前仅限制模型 API 的调用消费，GPU 实例、沙箱等产品的消费不受 Key 预算约束，但仍计入成员预算总额。
</Note>

<Note>
  API Key 被删除后，该 Key 的预算配置自动归档，历史消费记录保留可查。
</Note>

## 预算用尽后的提示

预算用完后，页面和 API 响应均会提示是哪一层的额度已用尽：

* **成员预算用完**：「您的成员预算已达上限（\$200 / \$200），所有服务暂停，请联系管理员调整。」
* **API Key 预算用完**：「API Key your-key-name 的预算已达上限（\$50 / \$50），其他 Key 不受影响。」
* **两层同时达到上限**：优先展示 Key 级提示，并附带成员预算的当前状态说明。

管理员可进入预算管理页直接上调对应额度或切换预算类型，调整后立即生效。