控制台使用指南

这篇说明第一次接入时最常用的几个页面：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 的结果，都不能单独证明本次请求经过 BestAI。

核对一次请求

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

1. 等待验证请求完成，记下时间和所用 Key 名称。
2. 刷新使用记录，确认日期范围包含该请求；先重置不确定的筛选，再筛选目标 Key。
3. 按时间和模型找到对应记录，核对分组、用量和实际费用。不要只看“最近一条”，后台任务或其他工具也可能同时调用。
4. 遇到失败时，查看页面中的错误记录入口（若当前账号可用），结合客户端错误正文和状态码排查。错误记录与已计费用量不是同一回事。

结果可以这样判断：

工具	使用记录	结论
有回复	有成功记录	接入完成
有回复	暂时没有对应记录	先检查日期、筛选并刷新，再核对当前 Provider 和 Key
无回复	有对应错误记录	按状态码和错误正文继续排查，不将错误记录直接等同于扣费
无回复	没有记录	检查请求是否发出、地址和网络；仅凭缺少用量记录无法断定请求未到站

费用显示很小时，可以查看完整明细。余额是否出现肉眼可见的减少，不是验证请求路径的必要条件。

选择模型和价格

打开模型广场，先选择 Key 对应的分组，再查看协议、模型 ID、输入/输出和缓存价格。部分分组对客户端、并发、上下文或用途有限制，创建 Key 前阅读分组说明。

模型和价格会随分组、上游和运营配置变化。具体计算方式见模型与价格；不要把文档中的示例模型当成永久承诺。

完成标准

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

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