外观
文档中心
不用从头读完。先选要完成的任务，配置完成后再看用量与排障。
按任务找
| 你的目标 | 打开这里 |
|---|---|
| 直接在线聊天 | 聊天入口 |
| 在线创作图片 | 图像创作入口 |
| 第一次接入 API 或本地工具 | 新用户接入指南 |
| 已有 Key，配置另一个工具 | 按工具找 |
| 查找模型、协议、分组与价格 | 模型与价格 · 实时模型广场 |
| 创建 Key、设置额度、核对请求 | 控制台使用指南 |
| 出现错误或找不到记录 | 按现象排查 |
| 把已跑通的 API 接入自己的项目 | 应用接入实践 |
| 需要定位失败或整理反馈 | 请求排障与反馈 |
按工具找
| 工具或协议 | 指南 | 内容 |
|---|---|---|
| Claude Code / VS Code | Claude Code 接入指南 | 推荐配置、终端环境变量、长期配置和验证 |
| Codex CLI / App | Codex 接入指南 | Provider、Responses、密钥与应用启动 |
| OpenAI / Anthropic SDK | 通用 SDK 接入指南 | curl、Python、Node.js 和流式请求 |
| Gemini 原生兼容接口 | Gemini 接入 | 模型列表、generateContent 和认证方式 |
| 生图 / 编辑图片 | 生图接入指南 | OpenAI 与 Gemini 请求、返图格式和本地保存 |
Base URL 是否包含 /v1 或 /v1beta 取决于客户端和协议。复制对应指南的配置，不要将完整 endpoint 填进普通 Base URL 字段。
按现象排查
| 现象 | 从哪里开始 |
|---|---|
| 401 / 403 | 认证、状态、额度与分组 |
| 404 / 路径找不到 | Base URL 与 endpoint |
| 400 / 参数错误，413 / 请求过大 | HTTP 状态速查 |
| 429 / 限流或额度耗尽 | 区分额度、并发和队列 |
| 超时、输出一半就断开 | 超时与流式中断 |
| 有回复，却找不到记录 | 核对时间、筛选与 Provider |
| 502 / 503 | 上游或网络错误 |
| 重启后配置失效 | 临时变量与长期配置 |
| 桌面 App 读不到 Key | 环境变量检查 |
| 浏览器显示 Network Error / CORS | 检查浏览器与后端链路 |
网页地址与 API 地址
- 网页操作：在 API Keys、账户仪表盘和使用记录管理账号；未登录时先完成 BestAI 登录。
- 工具调用：使用指南中以
https://api.bestai.chat开头的 API 地址。路径按协议和客户端填写。
一次配置完成后，发一条短请求，并到使用记录核对同一时间、Key 和模型，再开始长任务。