新用户接入指南

适合第一次把 BestAI 接入本地工具或自己的应用。你会创建一把 Key、完成一个工具的配置，并用使用记录确认请求经过了 BestAI。

只想直接使用？

在线聊天和图像创作有网页入口。本文面向需要配置工具或调用 API 的用户。

开始前准备

• 一个可以登录 BestAI 的账号。
• 账户余额或目标分组的可用额度。
• 先选一个要接入的工具，例如 Claude Code、Codex 或 SDK。

验证请求也会产生用量。首次使用只发送短句，跑通后再尝试长任务。

第 1 步：创建 API Key

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

1. 名称：按用途命名，例如 codex-local 或 project-dev，便于稍后在使用记录中识别。
2. 分组：选择支持目标工具、协议和模型的分组。先看模型广场的分组说明；同名模型不代表不同分组能力相同。
3. 额度与有效期：按用途设置，确认不会阻止这次验证。Key 额度与账户余额是不同限制。
4. 复制：复制完整 Key。sk-你的Key、YOUR_API_KEY 等只是文档占位符。

已有 Key 时可直接核对其状态、分组、额度和有效期，不必重复创建。需要了解字段含义时，查看控制台使用指南。

不要把真实 Key 放进截图、公开仓库或排障消息。

第 2 步：确认余额或额度

打开 账户仪表盘确认余额；如果使用订阅分组，确认对应订阅有效且额度未耗尽。同时检查 Key 自身的额度和到期时间。

余额不足、Key 过期、分组不可用和认证错误是不同问题。验证失败时读取错误正文，不要仅凭 401 或 403 判断原因。

第 3 步：选择工具并保存配置

一次只配置一个工具。打开对应指南，完成其中的推荐路径，再回到下面的验证步骤。

你使用什么	配置指南	本步完成时应看到什么
Claude Code / VS Code	Claude Code 接入指南	工具读取了 BestAI 地址、Key 和可用模型
Codex CLI / App	Codex 接入指南	当前 Provider 选择 BestAI，并使用 Responses 协议
自己的代码或兼容工具	通用 SDK / API 接入指南	Base URL、协议、模型 ID 与 Key 分组匹配
图片生成或编辑 API	生图接入指南	请求端点、模型和返图保存方式已确认

在 API Keys 页面看到“使用密钥”或配置提示时，可先复制对应工具的配置。合并到已有配置时保留其他设置；不要直接用整份示例覆盖原文件。

终端与桌面应用

终端中临时设置的环境变量通常只对该终端及其子进程生效。桌面应用未必能读取它们。各工具指南会区分临时验证与长期配置。

第 4 步：发送最小验证请求

对文字模型发送：

请只回复：BestAI 已连接。

等待请求完成，记下时间、模型和所用 Key 名称。模型是否逐字照抄这句话不是路由证明，下一步还要核对记录。

生图用户可按生图指南的最小请求生成一张图，确认文件能正常打开后再核对用量。

第 5 步：核对使用记录

打开 使用记录，刷新页面：

1. 日期范围包含刚才的请求时间。
2. 筛选当前 Key；不确定其他筛选时先重置。
3. 找到时间和模型对应的记录，核对分组、用量和实际费用。

结果	下一步
有回复，也找到对应记录	本次接入验证完成
有回复，暂时没找到记录	先刷新、核对日期和筛选，再检查工具是否仍在使用旧 Provider
无回复，有对应错误记录	按错误正文处理认证、额度、模型或上游问题
无回复，也没找到记录	检查请求是否发出、地址和网络；没有用量记录不能单独证明请求未到站

记录显示为很小的费用或零值时，结合完整明细和计费规则判断，不以余额是否肉眼可见地减少作为成功条件。

验证失败怎么办

现象	先检查	继续阅读
401 / 403	错误正文、Key 是否完整、状态/额度与分组权限	认证与权限排查
404	对应工具要求的 Base URL 和协议路径	地址排查
有回复但没找到记录	日期和筛选、当前 Provider、Key 与模型	核对一次请求
502 / 503	发生时间、模型 ID 和脱敏错误信息	上游错误排查

接下来

保留这次已经验证可用的配置，再开始实际任务。查看控制台使用指南了解额度与记录，或回到文档中心接入其他工具。