普通用户教程
创建 API Key
这一步的目标是：创建一个最简单、最容易排查的 API Key。
第 1 步：进入 API 密钥页面
在左侧菜单点击「API 密钥」。
如果页面还没有 Key，会看到创建入口。点击「创建 API 密钥」。
创建 Key 时照这个弹窗找字段：第一次只填名称和分组，其它高级限制先保持关闭，跑通后再逐项开启。
第 2 步：第一次按这个方式填
| 字段 | 第一次建议 | 为什么 |
|---|---|---|
| 名称 | 我的第一个 Key | 方便以后在使用记录里辨认 |
| 分组 | 选择你有权限的共享分组 | 请求必须知道走哪个号池 |
| 多分组路由 | 关闭 | 第一次先让请求只走一个分组，便于排查 |
| 自定义密钥 | 关闭 | 系统生成最省心 |
| IP 限制 | 关闭 | 新手通常不知道自己的出口 IP，开启后容易误拦截 |
| 额度限制 | 不填或保持默认 | 先不额外限制这个 Key，仍受账户余额控制 |
| 速率限制 | 关闭 | 跑通后再按需求限制 |
| 密钥有效期 | 关闭或不设置 | 避免测试时刚好过期 |
第 3 步：保存并复制密钥
点击保存后，回到 API Key 列表。
你需要确认：
- 列表里出现刚创建的 Key。
- Key 的状态是启用或活跃。
- Key 的分组不是空的。
- 能点击复制按钮复制密钥。
复制出来的内容通常长这样：
sk-xxxxxxxxxxxxxxxx第 4 步：安全保存
把 API Key 临时放在你自己的安全位置，例如：
- 本地密码管理器
- 本地加密笔记
- 只在当前电脑上临时使用的记事本
不要放在：
- 公开仓库
- 群聊
- 截图
- 工单正文
- 公开日志
如果怀疑密钥泄漏，直接删除旧 Key，重新创建一个。
第 5 步：点一次“使用密钥”
在 API Key 列表里找到这个 Key，点击「使用密钥」。
这个弹窗通常会告诉你：
- Base URL 应该填什么。
- 不同客户端怎么配置。
- 推荐模型是什么。
- 是否需要
/v1。 - 是否能导入 CC-Switch。
不要急着关掉，下一步会用到这里的信息。
常见问题
| 现象 | 原因 | 处理 |
|---|---|---|
| 创建按钮不可用 | 名称或分组没填 | 填名称并选择分组 |
| 分组下拉为空 | 你没有可用分组或权限不足 | 先确认余额、订阅和可用渠道 |
| 使用密钥弹窗提示未分配分组 | Key 没绑定分组 | 回列表点击分组列重新选择 |
| 复制后看不到完整密钥 | 页面可能只显示脱敏内容 | 用复制按钮，不要手动框选省略号 |
成功标准
完成这一页后，你应该拥有：
- 一个已启用的 API Key。
- 一个已绑定的共享分组。
- 一份安全保存的
sk-...密钥。 - 一个可以打开的「使用密钥」弹窗。
继续看 确认 Base URL。