API Key 管理

如何创建 API Key

1. 登录 虚宝 AI
2. 进入控制台的 API 密钥
3. 点击 创建密钥
4. 填写密钥名称，并为它分配正确的分组

提示

当前虚宝 AI 是按分组创建密钥。
如果你有多个分组需要分别使用，就应该创建多个 Key，而不是期待一个 Key 覆盖全部分组。

创建时建议重点检查

• 分组：决定这个 Key 可以走哪些上游能力与计费规则
• 自定义密钥：如果你希望自己指定 Key 字符串，可以按页面规则填写
• 额度限制：控制这个 Key 最多能消耗多少金额
• 速率限制：限制 5 小时、1 天、7 天等窗口内的消费
• 有效期：给测试 Key 或临时 Key 设定过期时间
• IP 限制：需要锁定来源时，可配置白名单或黑名单

最常见的两个排查点

• 分组是否正确
• 额度 / 速率限制是否已经耗尽

注意

如果你遇到“模型不可用”“没有权限”“请求被拒绝”或 429，不要先急着换模型，先检查当前 Key 的分组、额度限制、速率限制与有效期。

推荐操作顺序

1. 先创建 Key
2. 确认分组是否正确
3. 如有需要，再补充额度限制、速率限制和 IP 限制
4. 点击密钥行里的 使用密钥，复制对应客户端配置
5. 发起一次最小请求，回到 使用记录 核对是否正常

使用密钥 弹窗有什么用

使用密钥 是最值得先看的入口之一。它会按客户端类型给出配置示例，常见包括：

• Claude Code
• Codex CLI
• Codex CLI (WebSocket)
• OpenCode

提示

如果文档示例与控制台 使用密钥 弹窗有差异，请以控制台弹窗为准。