额度与兑换码

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

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

额度与余额

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

核心规则：额度不足时回退到余额

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

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

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

额度管理

查看部门与成员额度

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

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

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

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

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

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

分配额度

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

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

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

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

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

调整与取消额度

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

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

调整额度会清零本周期已用金额

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

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

周期重置与用量通知

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

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

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

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

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

查看额度同步状态

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

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

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

兑换码管理

创建与发放兑换码

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

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

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

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

查看兑换结果

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

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

成员可按兑换码充值中的步骤完成兑换并查看自己的余额和最近兑换记录。

维护与清理兑换码

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

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