概述

消费者（Consumer）是 AI 原生网关中代表调用方身份的实体。每个消费者可以拥有自己的凭证、配额限制、标签等属性。在模型推理服务/MCP 服务上启用消费者认证后，仅被授权的消费者持有合法凭证才能访问该服务。

通过创建消费者，您可以：

• 为不同租户、第三方开发者或内部系统分配独立的访问身份。
• 为每个消费者单独配置 Token / 请求次数配额，控制成本与用量。
• 在网关侧识别请求来源，便于审计、排查与差异化策略。

当前支持的认证方式： AI 原生网关的消费者认证模型支持多种认证方式，当前阶段仅实现了 API Key，后续将逐步扩展。本文中涉及的「凭证」均指 API Key。

使用限制

• 单个网关实例下最多支持创建 200 个消费者。
• 消费者名称创建后不支持修改，请谨慎填写。

操作步骤

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

基本信息

1. 配置 基本信息：

   配置项	说明
   消费者名称	必填，创建后不支持修改。命名规则： 长度 2–64 个字符。 仅支持大小写字母、数字、下划线（_）和连字符（-）。 同一实例下名称唯一。
   描述	选填，最多 64 个字符，用于备注消费者用途。
   标签	选填，单击 添加标签 可逐条配置 Key/Value 形式的标签，便于在多消费者场景下分类管理。 最多添加 20 个标签。 标签 Key：最长 64 字符，同一消费者下不可重复。 标签 Value：最长 128 字符。

配额限制

1. 配置 配额限制（选填）：

   配置项	说明
   配额限制	开关项。开启后展开下方配置；关闭则代表该消费者不限量调用。
   重置周期	开启配额限制后必填，决定配额按什么频率重置： 不重置：配额一次性使用完毕后不再恢复。 每天：每天到指定时间重置配额。 每月：每月到指定的「日 + 时间」重置配额。
   Token 用量限制	勾选后填写每个周期允许消耗的 Token 上限。 单位为万 Token（即输入 1 表示 10000 Token）。 支持小数，精度 4 位（最小 0.0001 万 = 1 Token）。
   请求次数限制	勾选后填写每个周期允许调用的最大请求次数，正整数，最小 1。

   Token 限制和请求次数限制可同时启用。两者命中任一上限即触发限额，超出后请求被网关拒绝直至下一周期重置。

   

认证方式

1. 配置 凭证（当前仅支持 API Key 类型）：

   配置项	说明
   立即创建凭证	开关项。勾选后随消费者一并生成首个 API Key；不勾选则消费者创建后无凭证，需到详情页再单独创建。
   凭证位置	必填，决定客户端调用时 API Key 该放在请求的哪个位置： Authorization：放在标准 Authorization Header 中，格式为 Bearer <API Key>。 自定义 HTTP Header：放在指定名称的 Header 中，例如 X-API-Key: <API Key>。 自定义 Query 参数：放在指定名称的 URL 查询参数中，例如 ?api_key=<API Key>。
   生成方式	系统生成：由网关自动生成符合规则的 API Key，安全性更高，推荐使用。 自定义：手动指定 API Key 值，便于沿用既有凭证或测试场景。

   

2. 确认无误后单击 确定，完成消费者创建。

   • 若勾选了「立即创建凭证」并选择「系统生成」，创建成功后请在消费者详情中查看 API Key。
   • 创建后的消费者可在消费者列表中查看，可在消费者详情页继续追加凭证、调整配额或编辑标签。