身份与访问权限
适用范围: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。
- 根据使用场景设置消费额度和有效期。
- 创建成功后保存 Key;完整值只展示一次。
- 将 Key 配置到应用运行环境,发起一次调用检查身份及费用归属。
需要更换正常使用的 Key 时,先让应用切换到新 Key,再删除旧 Key。发现泄漏时应立即撤销泄漏的凭据。删除后,携带该 Key 的请求将被拒绝。完整界面及步骤见API Keys。
管理模型访问
服务状态、资源可见性和调用身份共同影响请求是否可用。使用专属实例时,应按实例 API 说明选择对应身份;实例页面的查看和修改权限与推理 API 的调用权限需分别确认。
为应用提供访问入口时,同时检查:
- 服务是否启用,上游是否可用。
- Key 是否属于预期个人或组织,是否仍在有效期内。
- 调用方是否有权访问目标服务,Key 是否已达到消费限额。
模型或组织的权限配置以所部署版本提供的功能为准。为不同应用创建独立 Key 后,可分别设置消费上限和有效期。