API 密钥

API 密钥用于验证客户端请求并记录消费。任何持有密钥的人都可能使用对应额度，请像保护密码一样保护它。

创建密钥

前往控制台的 API 密钥 页面创建密钥。推荐按用途拆分：一台设备、一个自动化任务或一个团队成员使用独立密钥。

分配分组

密钥必须分配分组后才能生成可用配置。分组决定可调用的服务、模型协议和计费规则。如果“使用配置”提示尚未分配分组，请先编辑密钥的分组设置。

::: :::

直接导入 CC-Switch

本机已安装 CC-Switch 时，可以在密钥列表点击“导入 CC-Switch”。ModelPort 会根据密钥所属分组自动生成客户端、接口地址、模型和用量查询配置，并通过系统协议直接交给 CC-Switch。完整流程请参阅 CC-Switch 一键导入。

安全限制

可根据用途配置以下限制：

限制	适用场景
额度限制	控制单个密钥的最大消费金额
有效期	临时设备、演示或短期任务
IP 白名单	出口 IP 固定的服务器
IP 黑名单	阻止已知不可信来源

家庭宽带和移动网络的出口 IP 可能变化，不建议在不确定时设置严格白名单。

密钥泄露处理

1. 立即在 API 密钥 页面禁用或删除泄露的密钥。
2. 新建密钥并更新客户端配置。
3. 查看用量记录，确认是否存在异常请求。
4. 不要继续使用已经公开过的旧密钥。

不要公开密钥

不要把真实密钥写入截图、Issue、代码仓库、构建日志或前端网页。文档示例中的占位符不能替换为真实密钥后再分享。