创建和保护 API Key

API Key 用于识别请求、校验权限和记录用量。不要把兑换码、订阅码和 API Key 混淆。

创建前准备

1. 确认账户有可用余额或有效订阅。
2. 打开“可用渠道”，找到准备使用的模型。
3. 记录模型所属分组和当前状态。
4. 返回“API 密钥”页面。

创建密钥

1. 点击创建 API Key。
2. 设置容易识别的名称，例如按设备或工具命名。
3. 选择包含目标模型的分组。
4. 如果页面提供有效期或限制选项，按实际用途设置。
5. 创建后立即复制并安全保存完整 Key。

红色箭头标出创建密钥入口；截图中的模型、倍率和可用状态仅作操作示例。

选择实际需要的模型分组；模型、说明和倍率以控制台当前显示为准。

完整 Key 只应由你本人保管

不要在聊天截图、公开仓库、网页前端代码或共享配置中展示完整 Key。

推荐的管理方式

• 不同设备或工具使用不同 Key，方便定位和停用。
• 名称包含用途，不使用“测试1”这类难以识别的名字。
• 不再使用的 Key 及时停用或删除。
• 定期检查请求记录是否存在异常来源。

完成最小验证

创建后先阅读完成第一次 API 请求，发送一句简短测试并确认：

1. 模型正常回复。
2. 控制台出现请求记录。
3. 模型和分组正确。
4. 余额或订阅用量变化合理。

Key 泄露怎么办

1. 立即停用或删除泄露 Key。
2. 创建一个新 Key。
3. 更新 CC Switch、Codex、Claude Code 或其他工具配置。
4. 检查泄露时间后的请求和用量记录。
5. 不要继续使用已经公开过的旧 Key。

常见问题

创建后请求提示模型不可用

检查 Key 分组是否包含目标模型，并复制“可用渠道”当前显示的模型名称。

创建后忘记保存完整 Key

如果页面不再展示完整 Key，应创建新 Key 并停用旧 Key，不要尝试猜测或恢复隐藏部分。

多个工具共用一个 Key 可以吗

技术上可能可以，但不利于定位异常和单独停用。建议按工具或设备分别创建。