创建并安全使用 API Key

开始前准备

• 完成登录，并明确要使用的协议、客户端和运行环境。
• 在模型广场确认目标模型所属的当前分组。
• 为不同应用、环境或团队成员规划独立 Key，便于限额、审计和停用。

创建和配置 Key

1. 打开 Key 管理

登录后进入API Key 管理页，选择创建 Key。为 Key 使用能区分项目和环境的名称，例如开发、测试或生产用途。

2. 选择分组

根据目标协议和模型选择当前可用分组。Key 创建后只能调用其分组支持的模型；不要从第三方教程复制已经过期的分组名或模型名。

3. 设置使用边界

按实际需要配置额度、有效期、请求限速和 IP 黑白名单。生产 Key 应采用最小可用权限和合理限额，不要为了排障长期关闭所有限制。

4. 安全保存 Key

按页面提示保存新 Key，并将它放入服务端环境变量或专业密钥管理工具。不要写入浏览器前端、移动端安装包、公开仓库、文档示例或聊天记录。

5. 打开“使用密钥”指引

在 Key 列表中打开“使用密钥”，按页面为当前 Key 和分组实际提供的客户端与操作系统选择配置。这是本站推荐的默认路径：生成内容以当前 API 地址和 Key 分组为准，也不需要先进入第三方工具选择供应商。页面未展示的客户端不应仅凭第三方教程推断为可用。

6. 发起最小测试并核对用量

从模型广场复制当前模型标识，按对应协议发送一个最小请求。成功后进入用量页，确认记录归属到刚创建的 Key。

已经安装 CC Switch 时的可选快捷入口

CC Switch 不是使用虾马AI的前置条件。只有你已经在可信设备上安装并理解该第三方软件，且 Key 页面当前提供相应按钮时，才考虑使用“已安装 CC Switch？一键导入”。否则直接使用站内“使用密钥”生成原生配置即可。

• 一键导入会通过本机协议链接把 API 地址、模型和完整 Key 交给 CC Switch；只在自己的可信设备上确认。
• 为第三方客户端单独创建低额度、短有效期、可随时停用的 Key，不与生产服务共用。
• 导入前核对目标软件和配置内容；本站导入链接默认关闭 CC Switch 用量查询，不向链接附加用量脚本。
• CC Switch 可能展示其他供应商、赞助商或外部链接，这些内容不属于虾马AI，也不代表本站推荐或背书。使用本站深链导入后，无需在其供应商列表中重新选择服务。
• 发现导入目标异常、设备并非自己控制或 Key 可能已泄露时，立即取消并在站内停用该 Key。

成功标志

• Key 列表中显示新 Key，分组和限制与预期一致。
• “使用密钥”页面会展示当前支持的客户端和操作系统配置。
• 最小请求成功，并能在用量页按该 Key 查到对应记录。

常见问题

一个 Key 能否调用多个模型？

同一分组内通常只需修改请求的 model 字段即可切换模型。实际可用范围以模型广场和 Key 所属分组当前展示为准。

什么时候应该创建多把 Key？

不同应用、环境、团队成员、协议或风险边界应使用独立 Key。这样可以分别设置额度和限速，并在单个 Key 泄露时缩小影响范围。

Key 被拒绝时检查什么？

检查 Key 状态、分组、额度、有效期、速率和 IP 规则，再检查鉴权头、端点及模型归属。错误码排查见错误与计费核对。

能否只查询一把 Key 的用量？

可以在登录后的用量页筛选，也可以使用本站公开 API Key 用量查询页。不要把 Key 提交给第三方查询网站。

必须安装 CC Switch 才能使用吗？

不需要。站内“使用密钥”是默认配置入口；CC Switch 仅是面向已安装用户的可选本机快捷方式，不影响直接配置 Codex、Claude Code 或其他当前支持的客户端。