---
outline: [2, 3]
head:
  - - meta
    - name: description
      content: 介绍 OneGateway 成员额度的查看、分配、调整、周期重置和用量通知，以及兑换码的创建、发放与维护。
---

# 额度与兑换码

**额度与兑换码一般只会启用其中一种，默认是额度**：默认由管理员为成员分配额度，兑换码充值仅在环境启用后才可用。

管理员可以为成员分配额度（按周期重置的消费上限），也可以通过兑换码为成员充值余额。**成员额度控制周期消费上限，余额负责实际充值，两套机制独立生效。**

## 额度与余额

| 类型 | 来源 | 使用方式 |
| --- | --- | --- |
| 成员额度 | 管理员分配 | 按页面提供的周期设置消费上限，到期重置 |
| 余额 | 成员兑换兑换码充值 | 充值后按实际消费扣减，不随周期重置 |

::: tip 核心规则：额度不足时回退到余额
调用优先消耗成员额度，额度不足时回退到余额。未配置成员额度的成员直接使用余额；两者都不足以扣减本次调用时，请求才会被拒绝。因此，成员额度耗尽不一定意味着停止调用。
:::

成员额度按成员独立生效。按部门分配是给选中的每位成员分别设置额度，不是建立部门共享余额。

[API Keys](/user/tokens) 的额度限制与成员额度分别生效。如果 API Key 另设了上限，即使成员还有可用额度，该密钥也可能因自身额度不足而无法调用。若希望统一由成员额度控制消费，使用不单独限制额度的 API Key。

## 额度管理

### 查看部门与成员额度

进入 **组织管理 → 配额**，根据管理目标切换视图：

| 视图 | 用途 |
| --- | --- |
| 部门概览 | 按组织层级查看成员数量、额度配置情况和使用情况 |
| 需要关注 | 集中查看接近上限或已耗尽的成员 |
| 未配置 | 查找尚未配置成员额度的用户 |
| 已配置 | 查看已有额度规则的成员 |
| 全部成员 | 查看成员列表，并结合部门、额度状态等条件筛选 |

部门概览中的 **成员** 数字按“成员总数 / 已配置人数”展示，同时列出未配置、接近上限、已耗尽人数和平均使用率。没有部门归属的成员集中显示在 **未分配部门**。

成员列表显示额度金额、重置周期、下次重置时间、已用与剩余额度，以及额度状态和同步状态。可通过搜索、所属部门和额度状态筛选目标成员。

| 额度状态 | 含义 |
| --- | --- |
| 未配置 | 没有有效的成员额度规则 |
| 正常 | 使用率低于 80% |
| 接近上限 | 使用率达到 80%，但尚未达到 100% |
| 已耗尽 | 使用率达到或超过 100% |

这里的使用率和剩余额度针对成员额度，不代表余额。成员调动部门后，统计归属随之变化，已有额度规则不会仅因部门变化而调整。

### 分配额度

分配前，确认成员已建立 OneGateway 账号。

1. 点击 **分配额度**，打开额度策略表单。
2. 点击 **选择成员**，按部门批量选择，或切换到按成员逐个选择；可搜索部门或成员。
3. 选择 **重置周期**，默认每月；可选周期以当前环境页面为准。
4. 填写 **每位成员额度**，大于 0 且不超过系统允许的上限。
5. 按需设置额度使用达到 80% 时的用户通知。
6. 核对成员人数、每人额度及重置规则，点击 **保存额度**，再检查各成员的同步状态。

分配入口的成员选择器只列出尚未配置额度的成员。已有额度的成员应通过 **调整** 或 **批量调整** 修改。

按部门选择后，实际分配对象是本次选中的成员；后续新加入部门的用户不会自动获得这次额度。

批量保存允许部分成功。若返回失败明细，先确认哪些成员已成功，再根据失败原因处理对应成员，避免重复调整成功成员的额度。

### 调整与取消额度

**调整单个成员**：在成员列表点击 **调整**，修改周期、额度或通知设置后保存。表单会回显该成员当前配置，调整过程中不能更换成员。

**批量调整**：勾选目标成员后，点击出现的 **批量调整**，统一设置周期、每人额度和通知选项。批量表单使用默认值，不代表所选成员原有配置相同，保存前应逐项核对。

::: warning 调整额度会清零本周期已用金额
保存调整会结束原有周期并建立新周期，**本周期已用金额归零**，额度按新设置重新计算。当前调整入口也用于保存通知设置，操作前请一并考虑这一影响。
:::

**取消额度**：在成员所在行点击 **取消额度**，确认后结束该成员当前额度规则，成员回到未配置状态。取消额度不会清空余额；如果余额仍充足，成员仍可能继续调用。

### 周期重置与用量通知

可选周期以当前环境的额度配置页面为准；只有页面提供每天选项时，才可配置每日重置。

| 重置周期 | 重置时间 |
| --- | --- |
| 每周 | 每周一 00:00 |
| 每月 | 每月 1 日 00:00 |
| 每天（页面提供时） | 每天 00:00 |

重置按网关服务器的运行时区执行，不由个人电脑或组织的时区设置决定；请以页面显示的 **下次重置** 时间为准。

不能自行选择其他重置日期或时刻。周期到达后，已用额度重新计算，上一周期未使用的额度不累加到下一周期。

额度策略中的 **用户通知** 用于设置是否在额度使用达到 80% 时通知成员，首次分配时默认开启。关闭通知不会改变成员状态的判定，也不会改变消费上限。

### 查看额度同步状态

额度状态描述“用了多少”，同步状态描述“配置是否成功下发生效”，两者应分别查看。

| 同步状态 | 处理方式 |
| --- | --- |
| 已同步 | 配置已成功下发，可结合额度规则查看结果 |
| 下发中 | 等待处理完成后刷新查看 |
| 下发失败 | 查看错误原因，处理后通过 **重新下发** 重试 |

不要仅凭页面保存成功就认为额度已经生效。成员列表的已用金额可能晚于实际消费；实际调用时的额度校验由系统实时执行，不依赖管理页面刷新。

## 兑换码管理

### 创建与发放兑换码

在具有兑换码管理权限的入口中打开兑换码列表，新建兑换码。核心配置：**金额**（每个兑换码对应的充值额度）、**生成数量**（1–100）、**过期时间**（留空表示不过期）、**适用范围**（限定兑换码对哪些成员有效，创建后不可更换）。

根据发放方式选择后续操作：

- **手动发放**：创建成功后下载兑换码文本文件，或复制单个兑换码，再交给接收成员。
- **按部门或成员发放**：启用通知，选择部门或指定成员。系统按范围内符合条件的成员人数生成兑换码，每人对应一个，并通过已配置的通知渠道发放。

生成和发送兑换码不等于成员已经充值，成员还需要完成兑换。

### 查看兑换结果

在兑换码列表中查看状态、兑换人及兑换时间，确认是否已经使用。按成员发放时，记录可能预先关联接收成员，**不能仅凭存在成员信息判断兑换成功**，应结合已使用状态和实际兑换时间确认。

兑换成功后，金额计入成员的余额，不会增加其成员额度，也不会重置本周期的已用金额。同一个兑换码只能成功兑换一次。

成员可按[兑换码充值](/user/redemption)中的步骤完成兑换并查看自己的余额和最近兑换记录。

### 维护与清理兑换码

| 操作 | 使用场景与限制 |
| --- | --- |
| 编辑 | 修改未使用兑换码的名称、金额或过期时间；已使用兑换码不可编辑 |
| 禁用 | 暂停未使用兑换码的兑换 |
| 启用 | 恢复符合条件的兑换码；已使用或已过期的码不能通过启用重新使用 |
| 删除 | 删除不再需要的兑换码，操作前核对状态及发放情况 |
| 清理失效兑换码 | 批量清理已使用、已禁用和已过期的兑换码 |

清理后兑换码不可恢复，但充值日志会保留。