AI 密钥管理

AI 密钥 (AI Key) 是你调用智卡算力服务的数字通行凭证（格式通常以 sk-... 开头）。

智卡密钥采用通用标准密钥格式，你可以将它直接粘贴进任何支持自定义 API Key 的对话客户端、IDE 插件或智能体软件中。

创建你的第一个 AI 密钥

  1. 登录智卡控制台，在左侧导航栏点击 “AI 密钥”（/hub/ai-key）。
  2. 点击页面右上角的 “新建密钥” 按钮。
  3. 在弹出的对话框中完成配置：
    • 密钥名称：输入一个易于识别的名称（例如：Cursor 编程专用、公司电脑 Chatbox）。
    • 消费限额（防超支保护）：你可以为该密钥指定一个最大可用额度（例如设置为 30 元）。当该密钥的累计消费达到限额时，系统会自动拒绝该密钥的后续请求，而你账户里的其他余额完全不受影响。
  4. 点击 “创建”。
  5. 复制并保存：系统会生成并展示完整的密钥明文。请注意，出于安全考虑，密钥明文仅会展示这一次，请立即将其复制并妥善保存在密码管理器或直接粘贴至目标软件中。

最佳使用习惯：一工具一密钥

我们强烈建议你为每一个独立的 AI 工具或智能体分别创建专属的 AI 密钥，而不是把同一个 Key 随处粘贴：

  1. 防止 Agent 循环失控（防超支）： 一些自动化编程 Agent 或复杂工作流在遇到异常时可能会发生无限重试或死循环。通过为该 Agent 设置限额专用 Key，即使工具失控，损失也会被严格限制在你设定的限额内。
  2. 用量精细归因： 在后续的“用量与明细”看板中，你可以按密钥名称快速筛选，精准掌握究竟是哪一款工具消耗了最多的算力。
  3. 即时停用与隔离： 如果某台笔记本电脑遗失，或者你不小心在某个第三方应用中输入了密钥，你只需在控制台一键删除或禁用该单一密钥，其他正在正常工作的软件和密钥丝毫不受波及。

密钥状态与日常维护

在 /hub/ai-key 列表中，你可以随时对已有密钥执行以下操作：

  • 状态切换：点击开关可临时禁用某个密钥（此时调用该 Key 会返回 401 认证失败），需要时可随时重新激活。
  • 修改限额：随时上调或下调密钥的额度上限。
  • 删除密钥：彻底作废该密钥。一旦删除，使用该 Key 的所有软件将永久无法继续调用。

密钥安全守则

  • 严禁上传公开平台：切勿将包含 sk-... 的代码推送到 GitHub、Gitee 等公开代码仓库。
  • 注意屏幕共享：在进行屏幕共享、录屏或演示时，注意不要暴露配置窗口中的完整密钥。
  • 定期审查：定期进入控制台查看是否有长期闲置的密钥，并及时将其清理。