概述

消费者创建后，您可以在「消费者管理」中查看、搜索、编辑、删除消费者，调整配额限制，以及对单个消费者的凭证进行新增、删除、复制等操作。

重要

• 消费者删除后无法恢复，请确认该消费者未被任何模型推理服务或 MCP 服务授权后再操作。
• API Key 删除后无法恢复，使用该 Key 的客户端会立即调用失败，请提前通知调用方。

消费者列表

1. 登录百度智能云 AI 原生网关控制台。
2. 在顶部导航栏选择目标地域，并在实例列表中单击目标实例 ID，进入实例详情页。
3. 在左侧导航栏选择 消费者管理，进入消费者列表页。

4. 列表展示如下信息：

   列	说明
   消费者名称 / ID	消费者的唯一标识。单击名称可进入详情页查看完整信息。
   描述	展示创建消费者时填写的描述信息。
   配额状态	展示当前消费者的配额使用状态，包括： 不限制：未开启配额限制，无用量约束。 正常：已启用配额，未触达阈值。 接近上限：当前用量已达到阈值 80%。 已超额：本周期内已超过阈值，新请求被拒绝直至下一周期重置。
   消费者标签	展示消费者的标签 Key/Value，可单击展开查看完整列表。
   创建时间	消费者的创建时间。
   操作	提供「调整配额」「删除」操作入口，具体见下文。

5. 单击右上方的刷新按钮可重新拉取列表。

编辑消费者标签

消费者的「名称」创建后不支持修改，但您可以随时调整标签。

1. 在消费者列表中找到目标消费者，单击操作列的 编辑 图标。
2. 在弹窗中按需新增、修改或删除标签（最多 20 个，键最长 64 字符且不可重复，值最长 128 字符）。
3. 单击 确定，完成编辑。

调整配额

如果业务用量增长或需要临时放开配额，可在消费者列表中直接调整该消费者的配额。

在消费者列表中找到目标消费者，单击操作列的 调整配额，弹出「调整配额」对话框。系统会先拉取该消费者的最新配额详情后再显示，避免基于过期数据修改。

调整配额字段说明

配置项	说明
配额限制	总开关。关闭后该消费者不再受配额约束，可不限量调用。
重置周期	决定配额按什么频率重置： 不重置：配额一次性使用完毕后不再恢复，需重新调整后才能继续调用。 每天：每天到指定时刻（CST 北京时间）重置用量，重置后当天用量清零。 每月：每月指定日期与时刻（CST）重置用量。
限制维度	必选其一或同时勾选，至少勾选一种维度： Token 用量限制：单位万，支持 4 位小数（最小 0.0001 万 = 1 Token），值须大于 0。 请求次数限制：正整数，最小 1。 当对接有自身配额限制的第三方模型服务时，建议把所有消费者的限额之和控制在该服务总配额以内，避免单一消费者耗尽整体额度。
生效方式	决定本次修改何时生效： 立即生效：保存后新配置即时生效；当前周期内累计的已用量按新上限重新判定。 下次重置时生效：本周期继续按旧配置运行，到达「当前周期的下次重置时间」时一次性切换到新配置。 系统会按下文「四类典型场景」自动启用或禁用其中一项，无需手动选择。

四类典型场景

调整配额时，系统会根据您的修改内容自动判定属于哪一类场景，并相应锁定「生效方式」选项、给出对应提示。理解这四类场景，可以帮助您预判改动会在何时、以什么方式生效。

场景一：未修改重置周期，仅调整上限

触发条件：消费者原本已开启配额且有重置周期，本次只修改 Token 上限或请求次数上限，未动重置周期、每月重置日、重置时间。

生效方式：「立即生效」与「下次重置时生效」均可选，由您自由决定。

• 选择 立即生效：保存后新上限即时应用。如当前周期已用量超过新上限，弹窗会给出告警提示，确认提交后该消费者会立即进入「已超额」状态，新请求被拒绝。
• 选择 下次重置时生效：本周期继续按旧上限运行；弹窗会展示「当前重置周期」与「下次重置时间」（精确到秒），等到达该时间时一并切换到新上限。

举例 1：提升额度（业务增长）

消费者 tenant-a 原配置：每月 1 日 00:00 重置，Token 上限 100 万；当前是 5 月 15 日，本月已用 50 万。租户业务增长，希望把上限调整到 200 万。

• 若选 立即生效：从 5 月 15 日提交时刻起，本月可用余额按新上限计算（已用 50 万、剩余 150 万），用户立刻能继续调用更多。
• 若选 下次重置时生效：本月剩余余额仍按旧上限算（剩 50 万）；到 6 月 1 日 00:00 重置后，新周期上限变成 200 万。

举例 2：降低额度（已用量超过新上限）

消费者 dev-test 原配置：每月 1 日 00:00 重置，Token 上限 100 万；当前是 5 月 20 日，本月已用 80 万。希望把上限收紧到 50 万。

• 若选 立即生效：弹窗告警「当前周期已用 80 万 Token，超出新上限（50 万）」。确认提交后该消费者立即进入「已超额」状态，新请求被拒绝直到 6 月 1 日重置。
• 若选 下次重置时生效：本月继续按 100 万跑完（剩余 20 万仍可用）；6 月 1 日重置后才切换到 50 万上限。

场景二：消费者原本有重置周期，本次修改了周期

触发条件：在原本已配置重置周期（每天 / 每月）的基础上，改动了任一周期相关字段——切换周期类型（如每天→每月）、调整每月重置日、修改重置时间。

生效方式：「立即生效」自动置灰，强制为「下次重置时生效」。

原因：周期相关字段不能在周期中途变更，否则会造成统计口径混乱。本周期会按旧规则完整跑完并重置一次，重置之后才合并应用新的周期与上限。

举例 1：从「每月」切到「每天」

消费者 partner-x 原配置：每月 1 日 00:00 重置，Token 上限 1000 万。希望改为每天 00:00 重置、单日上限 50 万。当前是 5 月 20 日。

• 弹窗提示：「修改重置周期，变更将在当前周期的下次重置时生效。当前重置周期：每月 1 日 00:00:00。下次重置时间：2026-06-01 00:00:00。」
• 5 月 20 日 至 5 月 31 日：仍按"每月 1000 万"运行。
• 6 月 1 日 00:00：旧周期重置一次。
• 6 月 1 日 00:00 起切换到新规则：按"每天 50 万"，每日 00:00 重置。

举例 2：调整重置时刻

消费者 peak-traffic 原配置：每天 00:00 重置，请求次数上限 10000 次。业务发现 00:00 是流量高峰，希望把重置时刻调整到业务低峰的 04:00。

• 弹窗提示「下次重置时间」按旧规则推算（即下一次 00:00）。
• 旧周期跑到下一次 00:00 自然重置。
• 该次重置后开始按 04:00 为新的重置时刻——此时会有一个比 24 小时更长的过渡周期（00:00 重置 → 次日 04:00 再重置），过渡期内仍按 10000 次为上限，请提前评估业务影响。

场景三：消费者原本不重置，本次开启了周期

触发条件：消费者原本是「不重置」（一次性额度）或原本未开启配额，本次改为「每天」或「每月」之一。

生效方式：「下次重置时生效」自动置灰，强制为「立即生效」。

原因：原本没有"当前周期"概念，不存在"下次重置时间"，因此无法采用 pending 模式。新周期一旦保存即立即开始第一个周期。

弹窗会给出提示：「当前无重置周期，修改重置周期将立即生效。」

举例 1：从未限额到首次开启月度配额

消费者 prod-customer 原本未开启配额限制，可不限量调用。现在希望开启每月配额：每月 1 日 00:00 重置，Token 上限 1000 万。当前是 5 月 15 日。

• 弹窗提示：「当前无重置周期，修改重置周期将立即生效。」
• 5 月 15 日提交时刻起立即开始第一个周期：从此刻开始计入用量，到 6 月 1 日 00:00 第一次重置。
• 注意：第一个周期是从开启时刻到下一个重置点，不足完整月（只有 16 天多）但上限就是 1000 万，请提前与业务方沟通好首月的额度预期。

举例 2：从一次性额度切换到定期续期

消费者 trial-user 原配置：开启了配额限制但选择「不重置」，一次性给 100 万 Token、目前已用 30 万。试用期结束希望转为正式订阅，每月 1 日 00:00 重置、Token 上限 200 万。

• 弹窗提示：「当前无重置周期，修改重置周期将立即生效。」
• 提交后立即进入「每月 200 万」周期。
• 第一个完整周期从 6 月 1 日 00:00 开始；从提交到 6 月 1 日的剩余天数按"过渡周期"处理，上限即 200 万。

场景四：从开启配额改为关闭

触发条件：把「配额限制」总开关从开启切换为关闭。

行为说明：

• 弹窗下方会出现警告：「关闭配额限制后，当前配额配置将被清除。再次开启需重新配置，请确认操作。」
• 提交后该消费者立即变为不限量调用，原有的 Token 上限、请求次数上限、重置周期等配置全部丢失。
• 后续如需再次启用配额，需要从头重新配置全部字段。

举例：消费者升级到不限量套餐

消费者 vip-customer 原配置：每月 1 日 00:00 重置，Token 上限 500 万、请求次数上限 100000 次。客户升级到不限量套餐，希望放开所有限制。

• 在「调整配额」中关闭「配额限制」总开关。
• 弹窗警告：「关闭配额限制后，当前配额配置将被清除。再次开启需重新配置，请确认操作。」

• 提交后：

  • 该消费者立即不限量调用，新请求不再受 Token 或请求次数限制。
  • 原有的「每月 / 500 万 / 100000 次」配置全部丢失。
  • 若 3 个月后客户被降级、想重新启用配额，需要在「调整配额」中从头重新填写重置周期、上限等全部字段，无法"恢复"上次的配置。

提交与生效

确认无误后单击 确定，系统按上述场景对应的生效方式更新配额：

• 场景一选择「立即生效」、场景三、场景四：更新即时生效。
• 场景一选择「下次重置时生效」、场景二：更新已记录但本周期内行为不变，下次重置时按新配置开始计费。

常见问题

• Q：为什么我选不到「立即生效」？ 因为您改动了重置周期相关字段（场景二）；本周期需要按旧规则跑完才能合并新规则。如确实需要立即生效，请保留原周期不动，仅修改上限。
• Q：为什么我选不到「下次重置时生效」？ 因为消费者原本没有重置周期（场景三）；保存后会立即开始新周期。
• Q：选择「下次重置时生效」后，我能看到具体何时切换吗？ 可以。弹窗里会显示「下次重置时间」精确到秒，按当前消费者上一次重置时间 + 周期推算得到。
• Q：调整配额时改坏了配置怎么办？ 关闭弹窗或单击「取消」即可放弃本次修改，配额配置会保留为弹窗打开时的状态。但场景四（从开启切到关闭）一旦确定，原配置无法恢复，请谨慎操作。

管理 API Key 凭证

每个消费者下可以拥有多个 API Key 凭证（最多 100 个），便于在多套客户端、多个环境之间分别使用同一身份。

1. 在消费者列表中单击目标消费者名称，进入消费者详情页。

2. 在 认证方式 > API Key 标签页中可执行以下操作：

   动作	说明
   添加凭证	单击 添加凭证，在弹窗中选择生成方式： 系统生成：由网关自动生成符合规则的 API Key。 自定义：手动指定 API Key，长度 8–128 字符，仅支持大小写字母、数字、下划线（_）、斜杠（/）、连字符（-）和空格。
   复制 API Key	对刚创建的 API Key，可在 API Key 中单击复制图标按钮一键复制完整值。
   删除 API Key	在列表对应行单击 删除，二次确认后该凭证立即失效。使用该 Key 的客户端会调用失败。
   查看使用情况	列表中展示每个 API Key 的「生成方式」「创建时间」「最近使用时间」，便于识别长期未使用、可下线的旧凭证。

修改凭证位置

消费者的凭证位置（Authorization / 自定义 Header / 自定义 Query 参数）决定客户端调用时 API Key 应该放在哪里。如需调整，可在消费者详情页操作。

1. 进入消费者详情页。
2. 在凭证位置区域单击 编辑 图标。

3. 在弹窗中选择新的位置：

   • Authorization：Bearer ：放在标准 Authorization Header 中。
   • 自定义 HTTP Header：放在指定名称的 Header 中（如 X-API-Key）。
   • 自定义 Query 参数：放在指定名称的 URL 查询参数中（如 api_key）。
4. 若选择自定义 Header 或 Query 参数，需填写对应的字段名。

5. 单击 确定，完成修改。

   重要：修改凭证位置后，所有正在使用该消费者 API Key 的客户端都需要相应调整请求头或参数携带方式，否则会调用失败。请在变更前与调用方做好沟通。

删除消费者

对于不再使用的消费者，您可以将其从实例中删除。

1. 在消费者列表中找到目标消费者，单击操作列的 删除。
2. 在弹出的二次确认框中确认操作。

重要

• 删除消费者会同时删除该消费者下所有 API Key，使用这些 Key 的客户端会立即调用失败。
• 删除前请确认该消费者未被任何模型推理服务或 MCP 服务授权。如已授权，建议先到对应服务的「认证授权」中移除该消费者，避免影响业务。