开始使用
快速开始
使用智能路由创建 API Key,并跑通第一条 Better Gate 请求。
下面以个人工作区为例。正常情况下,几分钟内即可完成第一条请求。
1. 确认工作区
- 登录 Better Gate 控制台。
- 点击页面顶部的工作区切换器。
- 选择“个人工作区”。
个人工作区和组织工作区分别拥有自己的额度、API Key、用量日志和账单记录。
2. 获取可用额度
- 打开侧边栏的“账单中心”。
- 点击一个充值金额即可进入支付;也可以选择自定义金额。
- 如果你有兑换码,点击“使用兑换码”将额度加入当前工作区。
- 支付成功后查看充值成功弹窗和页面顶部额度。
充值活动开启时,金额卡片会同时显示支付金额、赠送金额和最终到账额度。
3. 创建 API Key
- 打开“API Keys”。
- 点击“创建 Key”。
- 填写容易识别的名称,例如
codex-personal。 - 保持默认的“智能路由”。
- 点击创建并复制完整 Key。
智能路由会自动选择支持当前模型的可用渠道,并在异常时切换备用渠道。只有明确需要固定线路时,才选择“指定渠道分组”。
展开“高级选项”后,还可以设置过期时间、RPM、TPM 和允许使用的模型。
4. 选择模型
- 打开“模型列表”。
- 按渠道类型和渠道分组查看当前可用模型。
- 使用搜索或模型分类找到目标模型。
- 复制准确的模型 ID。
渠道分组卡片显示该组“低至几折”,每个模型也会显示自己的实际折扣和计费价格。
5. 接入工具
推荐使用 Better Gate 客户端:
| 系统 | 下载地址 |
|---|---|
| Windows | 下载 Better Gate Windows 客户端 |
| macOS | 下载 Better Gate macOS 客户端 |
安装后登录账号、选择工作区、工具和 API Key,再按客户端提示应用配置。
如果需要手动填写:
https://gateway.better-gate.comOpenAI 兼容工具通常使用:
https://gateway.better-gate.com/v16. 查看结果
- 在工具中发送一句简单问题。
- 回到 Better Gate,打开“用量日志”。
- 确认能看到请求 ID、API Key、模型、渠道分组、状态、Tokens 和费用。
如果请求失败,点击红色“错误”状态查看错误代码、原始信息和建议处理方式。
组织工作区有什么不同
组织管理员需要先完成:
- 在“团队协作”创建组织,或进入已有组织。
- 在组织“账单中心”充值或兑换额度。
- 在“成员管理”邀请成员并分配成员额度。
成员切换到组织后创建自己的组织 API Key。组织 Key 消耗组织额度,同时受该成员额度限制。管理员可在“用量日志”按成员筛选团队请求。
如果没有成功,请继续查看 故障排查。