API Key 是给外部客户端用的“调用凭证”，不是网站登录密码。它只应该出现在你自己的客户端和密钥管理工具里。
它是什么
- 让外部客户端调用平台提供的模型接口。
- 只能访问管理员分配的模型分组。
- 可以单独停用或删除，不影响你的登录密码。
- 每次调用会记录在调用日志里，便于核对。
不要混淆
API Key 不能登录网站，登录密码也不能当 API Key 使用。不要把 Key 写进网页前端或公开仓库。
创建之前
| 条件 | 怎么确认 |
|---|---|
| 已登录 | 能正常打开 AI 中心 |
| 有模型分组 | 创建窗口中能看到可选分组 |
| 知道用途 | 客户端支持页面列出的兼容协议 |
| 准备保存 | 创建后立即复制到密码管理器 |
创建 Key
-
打开 API Key 页面
进入 AI 中心 → API Key。页面顶部会显示可用的连接信息和创建按钮。
-
填写名称
用能区分用途的名称，例如“研究客户端”或“本地脚本”。不要用密码或个人信息命名。
-
选择模型分组
分组决定这把 Key 能访问哪些模型。没有分组时先联系管理员。
你应该看到：分组下拉框里有可选项，创建按钮可用。
-
创建并立即复制
点击“创建并显示 Key”。完整 Key 通常只显示一次，关闭窗口后无法再次查看。
页面顶部还有一个“创建智能 API Key”入口，适合让 AI 帮你补全名称和分组。本文以手动“创建 API Key”为例，两者最终都会生成可停用的个人 Key。
连接客户端
页面会提供兼容协议的 Base URL 和模型列表地址。复制到客户端时注意：
- Base URL 直接复制页面提供的值，不要自行拼接路径。
- 不同客户端要求的协议不同，选与客户端匹配的那一组。
- 模型列表接口用于拉取可用模型；拉不到时先检查 Key 和分组。
- 不要把 Key 写进浏览器前端、公开仓库或截图。
以页面为准
连接地址可能随部署调整。教程不写死地址，始终以 API Key 页面当前显示的内容为准。
状态与额度
| 字段 | 含义 |
|---|---|
| 名称 | 创建时填写的用途名称 |
| 状态 | 启用或已停用；停用后不能调用 |
| Key | 通常只显示尾号，用于区分不同 Key |
| 额度 | 这把 Key 的可用额度或消耗情况 |
| 最近使用 | 最后一次调用时间，用于判断是否还在使用 |
额度消耗会反映在个人钱包和调用日志里。发现异常时先停用 Key，再排查调用来源。
轮换与停用
- 在 API Key 列表里找到目标 Key。
- 先停用，确认客户端不再使用它。
- 创建新 Key，更新客户端配置。
- 确认新 Key 工作正常后，删除旧 Key。
怀疑泄露时
不要等待观察。先停用旧 Key，再创建新 Key；同时检查调用日志里是否有异常来源和消耗。
安全边界
- 每把 Key 只给一个用途，方便停用和追查。
- 不要把 Key 提交到 Git、粘贴到公开聊天或发给他人。
- 不要把 Key 写进前端代码或浏览器存储。
- 定期检查列表，删除不再使用的 Key。
- 模型分组只给必要的权限，不用的分组不要开。
常见错误
| 现象 | 可能原因 | 处理 |
|---|---|---|
| 创建按钮不可用 | 没有模型分组 | 联系管理员分配分组 |
| 客户端返回未授权 | Key 错误、已停用或复制不完整 | 重新复制或新建 Key |
| 请求地址不存在 | Base URL 拼错或协议不匹配 | 按页面提供的地址重新填写 |
| 模型列表为空 | 分组没有模型或 Key 无权限 | 检查分组和 Key 状态 |
| 额度消耗异常 | Key 泄露或客户端重复请求 | 停用 Key，查看调用日志 |
常见问题
-
API Key 和登录密码一样吗？
不一样。登录密码用于进入站点；API Key 只用于客户端调用模型接口，不能登录站点。不要把两者混用或互相替代。
-
创建后看不到完整 Key 了怎么办？
完整 Key 通常只在创建时显示一次。如果已经关闭页面且没有保存，停用旧 Key 后重新创建一个，不要尝试从日志或浏览器存储里找回。
-
没有模型分组怎么办？
模型分组由管理员分配。创建页显示没有可用分组时，先联系管理员开通分组，再回来创建 Key。
打开 API Key 页面
先确认模型分组，再创建一把只用于当前客户端的 Key。