Skip to content

管理 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 管理页

  1. 在左侧导航栏点击 API 密钥密钥管理,进入 API Key 列表页。

  2. 点击右上角的 创建 API Key 按钮。

    进入API Key管理,点击创建API Key

入口二:应用详情页

  1. 在左侧导航栏点击 开发应用管理,点击目标应用进入详情页。

  2. 切换到 API Key 标签页,点击右上角的 创建 API Key 按钮。所属应用 会自动预选为当前应用。

    应用详情页创建Key

入口三:Playground

  1. 在左侧导航栏点击 开发模型广场 / Playground,进入在线调试页。

  2. 在页面顶部 API Key 下拉选择器旁,点击 创建 链接按钮。

    Playground创建Key入口

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

    Playground新建Key抽屉

填写 Key 配置

无论从哪个入口进入,创建抽屉中的配置项都相同:

基本信息

  • 所属应用(必填):该 Key 绑定的应用,所有调用用量计入该应用。
  • Key 名称(必填):易于识别的名称,例如「生产环境 - 文本生成」,长度 2~50 字符。

能力配置

  • 允许的能力类型:勾选该 Key 可使用的能力,例如文本生成、图像生成、向量嵌入、语音合成、语音识别、Web 搜索等。

模型范围

  • 允许的模型:选择「全部模型」,或指定特定模型列表。

预算限制

  • 每日/每月预算上限(选填):超出后自动拒绝请求,不设置则不限制。

速率限制

  • RPM / TPM 限制(选填):每分钟最大请求数 / Token 数,不设置则使用系统默认值。

完成创建

  1. 点击抽屉底部的 创建 按钮。

    确认创建Key

  2. 在弹出的提示框中点击 复制,立即保存完整的 API Key。

    重要提示:完整的 API Key 仅在创建时展示一次,关闭后无法再次查看。遗失只能删除旧 Key 并重新创建。

    复制API Key

管理已有 Key

在 API Key 列表页(左侧导航 开发API Key)可以查看、编辑、启禁用和删除 Key。

  • 编辑:点击操作列的 编辑 修改名称、能力、模型范围、预算或速率限制,保存后即时生效。

  • 启用 / 禁用:点击状态开关。禁用后该 Key 的所有请求立即被拒绝,可随时重新启用。

  • 删除:点击操作列的 删除 并输入 Key 名称二次确认。删除立即生效且不可恢复。

    API Key相关操作

注意事项

  • Key 安全:API Key 是调用接口的唯一凭证,请勿暴露在客户端代码、公开仓库或任何可被他人访问的位置。
  • Key 仅展示一次:完整的 Key 字符串仅在创建时展示一次,遗失只能删除重建。
  • 禁用 vs 删除:暂时停用建议禁用(可逆),删除不可逆。
  • 预算限制:每日与每月预算独立计算,先达到的限制先生效。
  • 速率限制:Key 级别 RPM/TPM 不能超过系统上限,超过则以系统上限为准。
  • Key 与应用:每个 Key 必须绑定应用,且创建后不可更换;迁移需新建 Key。
  • 最小权限原则:仅授予所需的最小能力和模型范围。

相关文档