管理 API Key
功能概述
API Key 是调用无量AI开放平台 API 接口的身份凭证。每个 API Key 绑定到特定的应用,并可以独立配置以下选项:
- 能力权限:授权该 Key 可使用的 API 能力类型(如文本生成、图像生成等)
- 模型范围:限制该 Key 可调用的模型列表
- 预算限制:设置每日/每月消费上限
- 速率限制:设置每分钟请求数(RPM)和每分钟 Token 数(TPM)上限
创建 API Key
平台提供 3 个入口 创建 API Key,最终都会打开同一个创建抽屉面板:
| 入口 | 适用场景 |
|---|---|
| API Key 管理页 | 集中管理所有 Key,适合首次创建或统一管理 |
| 应用详情页 - API Key 标签 | 为某个指定应用快速创建 Key,应用自动预选 |
| Playground - API Key 下拉 | 调试模型时临时缺少 Key,就地创建无需离开当前页面 |
入口一:API Key 管理页
在左侧导航栏点击 API 密钥 → 密钥管理,进入 API Key 列表页。
点击右上角的 创建 API Key 按钮。

入口二:应用详情页
在左侧导航栏点击 开发 → 应用管理,点击目标应用进入详情页。
切换到 API Key 标签页,点击右上角的 创建 API Key 按钮。所属应用 会自动预选为当前应用。

入口三:Playground
在左侧导航栏点击 开发 → 模型广场 / Playground,进入在线调试页。
在页面顶部 API Key 下拉选择器旁,点击 创建 链接按钮。

在弹出的抽屉中选择目标应用;如果尚无应用,也可直接输入名称 在线新建应用。

填写 Key 配置
无论从哪个入口进入,创建抽屉中的配置项都相同:
基本信息
- 所属应用(必填):该 Key 绑定的应用,所有调用用量计入该应用。
- Key 名称(必填):易于识别的名称,例如「生产环境 - 文本生成」,长度 2~50 字符。
能力配置
- 允许的能力类型:勾选该 Key 可使用的能力,例如文本生成、图像生成、向量嵌入、语音合成、语音识别、Web 搜索等。
模型范围
- 允许的模型:选择「全部模型」,或指定特定模型列表。
预算限制
- 每日/每月预算上限(选填):超出后自动拒绝请求,不设置则不限制。
速率限制
- RPM / TPM 限制(选填):每分钟最大请求数 / Token 数,不设置则使用系统默认值。
完成创建
点击抽屉底部的 创建 按钮。

在弹出的提示框中点击 复制,立即保存完整的 API Key。
重要提示:完整的 API Key 仅在创建时展示一次,关闭后无法再次查看。遗失只能删除旧 Key 并重新创建。

管理已有 Key
在 API Key 列表页(左侧导航 开发 → API Key)可以查看、编辑、启禁用和删除 Key。
编辑:点击操作列的 编辑 修改名称、能力、模型范围、预算或速率限制,保存后即时生效。
启用 / 禁用:点击状态开关。禁用后该 Key 的所有请求立即被拒绝,可随时重新启用。
删除:点击操作列的 删除 并输入 Key 名称二次确认。删除立即生效且不可恢复。

注意事项
- Key 安全:API Key 是调用接口的唯一凭证,请勿暴露在客户端代码、公开仓库或任何可被他人访问的位置。
- Key 仅展示一次:完整的 Key 字符串仅在创建时展示一次,遗失只能删除重建。
- 禁用 vs 删除:暂时停用建议禁用(可逆),删除不可逆。
- 预算限制:每日与每月预算独立计算,先达到的限制先生效。
- 速率限制:Key 级别 RPM/TPM 不能超过系统上限,超过则以系统上限为准。
- Key 与应用:每个 Key 必须绑定应用,且创建后不可更换;迁移需新建 Key。
- 最小权限原则:仅授予所需的最小能力和模型范围。
相关文档
- 创建应用 - 了解如何创建应用
- 应用详情与管理 - 在应用详情页管理 API Key
- 发起 API 调用 - 使用 API Key 调用接口
- 使用 Playground 测试 - 在 Playground 中使用 API Key 测试接口
- 接入 CC Switch - 在 CC Switch 里使用 API Key 并查看余额 / 预算