身份与访问权限
适用范围：EE 提供 用量计量与配额管理，不进行平台定价扣款或财务结算；本页涉及价格、消费金额、余额、充值与发票的说明仅适用于已开通计费功能的运营环境。
AI Gateway 使用 API Key 识别调用方。为不同应用创建可识别的 Key，可以分别管理使用期限、消费额度和费用归属。
选择正确的身份与凭据
| 凭据 | 用途 |
|---|---|
| 个人 API Key | 以个人身份调用网关，消费计入个人账单 |
| 组织 API Key | 以组织身份调用网关，消费计入组织账单 |
| Git Access Token | Git 与平台 API 访问，不代替网关 API Key |
| 上游供应商凭据 | 管理员配置模型上游时使用，不是应用调用网关的凭据 |
企业登录与组织成员管理参见自定义用户系统和组织管理。登录后，请使用具备目标服务访问权限的个人或组织 API Key 发起调用。
创建与维护 API Key
- 个人调用进入 账号设置 → API Keys；组织调用进入 组织设置 → API Keys。
- 创建 Key，填写可识别的名称，例如 production-support 或 evaluation-test。
- 根据使用场景设置消费额度（Quota）、可调用的模型范围以及有效期。
- 创建成功后保存 Key；完整值只展示一次。
- 将 Key 配置到应用运行环境，发起一次调用检查身份及费用归属。
API Key 生命周期与状态管理
- 临时禁用与恢复：当需要临时排查、轮转凭据或暂停某应用的调用时，可在列表中直接将指定 API Key 切换为“禁用”状态，无需彻底删除；恢复时重新点击“启用”即可秒级生效。
- 凭据泄露应急：发现 Key 泄漏时应立即在控制台中将其禁用或删除。失效后，网关会立刻阻断携带该 Key 的所有后续请求（返回
401 Unauthorized）。完整界面及步骤见API Keys。
模型访问范围隔离
为保障企业内部资源安全、防止低优先级业务或非授权团队调用昂贵的大参数模型，AI Gateway 支持模型权限范围细粒度隔离：
- 按 API Key 限制模型：在创建或编辑 API Key 时，支持配置该 Key 允许访问的模型白名单。
- 越权拦截：应用如果尝试使用该 Key 调用未在其白名单中的模型，网关将在准入阶段直接拒绝并返回权限受限错误， 防止算力被非预期消耗。
IP 白名单准入控制
企业级生产部署时，为防范 API 凭据因网络抓包、开发泄漏引发的未授权外部调用，AI Gateway 支持配置 IP 白名单访问控制：
- 安全准入控制：仅允许处于企业内网网段、专线公网出口 IP 或指定服务器地址的客户端发起调用。
- 即时阻断：未命中白名单的外部请求将被网关在最外层直接拦截，增强系统边界安全防护。
管理模型访问
服务状态、资源可见性和调用身份共同影响请求是否可用。使用专属实例时，应按实例 API 说明选择对应身份；实例页面的查看和修改权限与推理 API 的调用权限需分别确认。
为应用提供访问入口时，同时检查：
- 服务是否启用，上游是否可用。
- Key 是否属于预期个人或组织，是否仍在有效期内。
- 调用方是否有权访问目标服务，Key 是否已达到消费限额。
模型或组织的权限配置以所部署版本提供的功能为准。为不同应用创建独立 Key 后，可分别设置消费上限和有效期。