控制台使用指南

这篇说明第一次接入时最常用的几个页面：API Keys、仪表盘和使用记录。

你会完成什么

读完后，你应该能独立完成：

1. 创建一把用途清楚的 API Key。
2. 给 Key 选择正确的分组并设置额度。
3. 找到当前可用的模型和价格。
4. 判断一次请求是否真正经过 BestAI。

页面入口

你要做什么	页面
查看余额、最近请求和快捷操作	仪表盘
创建、复制、编辑或停用 API Key	API Keys
查看历史请求、模型、状态和费用	使用记录

页面需要登录。没有登录时，先打开 BestAI 完成注册或登录。

创建 API Key

打开 API Keys，点击“创建 API 密钥”。

名称

名称只用于你自己识别，建议写清工具或项目：

claude-code-local
codex-work
project-dev

不要把真实密钥写进名称。名称会出现在列表和使用记录里。

分组

创建时必须选择一个可用分组。分组决定：

• 可以使用哪些平台和模型。
• 请求经过哪类上游渠道。
• 计费倍率和部分限制。

如果不确定选哪一个，先查看创建 Key 时显示的分组描述和限制，不要凭模型名称猜测。

额度限制

可以为单个 Key 设置 USD 额度限制。测试 Key 建议先设置较小额度；留空或关闭限制表示不使用单 Key 额度上限，仍然受账户余额和分组规则约束。

创建后，列表会显示 Key 的状态、分组、今日/累计用量，以及已设置的额度进度。

复制和保护

列表中的 Key 默认会被遮罩。只在可信的本机配置窗口中复制完整值，不要把完整 Key 放入：

• 截图或屏幕录制。
• 聊天记录或公开 issue。
• Git 仓库、配置示例或 shell 历史。

怀疑泄露时，立即停用旧 Key 并创建新 Key，不要继续复用旧值。

使用 Key 配置工具

在 API Keys 列表中找到目标 Key，可以打开使用配置提示。优先使用控制台生成的配置，再回到对应的工具接入指南查看解释和验证步骤。

控制台生成的配置可能包含：

• Claude Code 环境变量或 settings.json。
• Codex config.toml 和 API Key 环境变量。
• OpenCode 等工具的 Provider 示例。
• macOS/Linux、PowerShell 和 Windows CMD 的不同写法。

已有配置时不要直接覆盖文件。先备份，再只合并 env、model_provider 或 model_providers 相关字段。

仪表盘看什么

打开 仪表盘 后，先看三类信息：

信息	用途
账户余额	判断请求是否可能因余额不足失败
今日请求和用量	判断刚才的验证请求是否产生记录
分组/模型信息	确认 Key 所属分组是否提供目标模型

不要只根据工具返回“有回复”判断配置成功。代理、旧 Provider 或本地缓存也可能让你看到回复；使用记录才是核对请求路径的依据。

核对一次请求

完成短验证后，打开 使用记录：

1. 记录验证请求的大概时间。
2. 按时间找到最近的一条记录。
3. 核对 API Key、模型、状态和费用。
4. 确认记录属于刚才使用的分组。

结果可以这样判断：

工具	使用记录	结论
有回复	有成功记录	接入完成
有回复	没有对应记录	当前会话可能走了其他服务商
无回复	有失败记录	请求已经到达 BestAI，按状态和错误继续排查
无回复	没有记录	先检查工具是否真的发出了请求

选择模型和价格

模型和价格会随分组、上游和运营配置变化。以控制台当前显示为准，不要把文档中的示例模型当成永久承诺。

完成标准

你已经掌握控制台基本操作，当你能够：

1. 创建并识别一把用途清楚的 Key。
2. 给 Key 选择分组并设置合理额度。
3. 用使用记录证明一次请求经过 BestAI。