外观
BestAI 文档中心
不需要从头读完。先按你要完成的任务选择一篇，跑通后再看排障和进阶说明。
按任务找
| 你的任务 | 推荐入口 | 读完后你会完成什么 |
|---|---|---|
| 第一次使用 BestAI | 新用户接入指南 | 创建 Key、确认额度、选择工具、完成验证并核对账单 |
| 已经有 Key，只想复制配置 | 按工具选择 | 找到对应工具的地址、配置位置和验证方式 |
| 正在排查错误 | 常见问题 | 按 401、404、无账单、502/503 定位问题 |
| 想确认请求是否真的经过 BestAI | 控制台使用指南 | 查看 Key、余额、模型价格和请求记录 |
| 想直接测试 API | 通用 SDK 接入指南 | 用 curl 或 SDK 发出最小请求 |
| 想生成或保存图片 | 生图接入指南 | 调用 OpenAI / Gemini 图片模型并保存返回图片 |
按工具找
| 工具 | 推荐文档 | 主要内容 |
|---|---|---|
| Claude Code | Claude Code 接入指南 | 安装、环境变量、长期配置、VS Code 和验证 |
| Codex CLI / App | Codex 接入指南 | config.toml、Responses 协议、环境变量和 App 启动 |
| OpenAI / Anthropic SDK | 通用 SDK 接入指南 | Python、Node.js、curl、流式请求和图片接口 |
| Gemini 原生兼容接口 | 通用 SDK 接入指南 | /v1beta 地址、模型配置和最小请求 |
| 生图 API | 生图接入指南 | gpt-image-2、Gemini 图片模型、Base64/URL 保存 |
| 其他兼容工具 | 通用 SDK 接入指南 | Base URL、协议和模型字段的对应关系 |
三个地址先分清
| 使用场景 | Base URL |
|---|---|
| Claude Code / Anthropic | https://api.bestai.chat |
| Codex / OpenAI Responses | https://api.bestai.chat |
| OpenAI SDK / 兼容工具 | https://api.bestai.chat/v1 |
普通 Base URL 字段只填基础地址。完整的 /v1/messages、/v1/responses 或 /v1/chat/completions 只用于明确要求完整 endpoint 的字段或 curl 测试。
最终检查
完成任意工具接入后，确认：
- 配置中的占位符已经替换成自己的 Key。
- 当前 Provider、Profile 或模型选择器确实切到了 BestAI。
- 验证句收到回复。
- 余额与账单 中出现对应请求记录。
如果只有回复、没有账单，先不要继续跑长任务，回到工具设置检查当前 Provider。