故障排查

出现问题时先打开“用量日志”。如果能看到失败请求，点击红色“错误”状态查看错误代码、上游信息和建议处理方式。

用量日志里没有请求

通常说明请求没有到达 Better Gate：

1. 检查工具中的 Base URL 是否为 Better Gate 地址。
2. 检查工具是否已经切换到 Better Gate 配置。
3. 确认 API Key 已完整填写且没有多余空格。
4. 重启工具后再次测试。
5. 使用客户端接入时，重新选择工作区、工具和 Key，再应用配置。

API Key 无效

在“API Keys”检查：

1. Key 是否启用且未过期。
2. 工具中是否仍使用轮换前的旧 Key。
3. Key 是否属于正确的个人或组织工作区。
4. Key 是否限制了当前模型。

如果旧 Key 显示“需轮换”，先轮换，再复制新 Key 或在客户端中刷新。

余额或成员额度不足

个人工作区：

1. 打开“账单中心”。
2. 查看个人额度。
3. 充值或使用兑换码。

组织工作区：

1. 确认组织额度可用。
2. 打开“成员管理”检查该成员额度。
3. 普通成员需要联系管理员调整额度。

个人充值不会增加组织额度，组织充值也不会增加个人额度。

模型不存在或不可用

1. 打开“模型列表”，复制准确的模型 ID。
2. 检查 API Key 的路由方式。
3. 智能路由 Key：确认至少一个可用渠道分组提供该模型。
4. 指定渠道分组 Key：确认该模型存在于所选分组。
5. 检查 Key 的高级选项是否限制了模型范围。

不确定渠道分组时，优先改用默认的“智能路由”。

指定渠道分组失败但其他分组正常

指定渠道分组不会自动故障切换。可以：

1. 编辑 Key，改回“智能路由”。
2. 或在“模型列表”确认目标分组仍提供该模型。
3. 在“用量日志”查看实际错误代码和上游渠道。

请求被限流

1. 打开“API Keys”并编辑对应 Key。
2. 检查 RPM 和 TPM 限制。
3. 0 表示不额外限制；非零值可能阻止高频请求。
4. 同时查看错误详情，确认是否为上游渠道限流。

客户端登录或授权卡住

1. 回到 Better Gate 客户端并重新登录。
2. 浏览器打开授权页后，确认账号并完成授权。
3. 返回客户端等待工作区和 Key 同步。
4. 仍未完成时，关闭客户端并重新打开。

一键接入后没有生效

1. 检查是否完整重启了对应工具：一键接入前后需要彻底退出工具（不是只关闭窗口或切换会话）再重新打开，否则配置不会生效。
2. 确认客户端中选择了正确工作区、工具和 Key。
3. 重新应用配置。
4. 再发起请求并查看“用量日志”。

刚创建或轮换 Key 后，在客户端刷新一次再应用。

充值成功但额度没有更新

1. 确认当前工作区与充值时一致。
2. 打开“账单中心”的“充值记录”。
3. 查看订单是否为“已支付”。
4. 刷新页面。
5. 如果已支付但额度仍未到账，联系支持并提供订单时间和金额。

发票按钮没有显示

只有符合条件的已支付充值记录会显示“立即开票”。人工充值、兑换码或已经开票的记录不会重复显示该按钮。

组织普通成员不能管理组织发票，需要联系所有者或管理员。

邀请返利没有解锁或到账

1. 邀请人必须先完成自己的个人首次充值，才会生成邀请码。
2. 好友必须通过邀请链接注册。
3. 好友首次充值成功后才会激活返利。
4. 奖励进入个人额度，不进入组织额度。
5. 在“邀请返利”的邀请记录和“账单中心”的赠金记录中核对。

联系支持时提供什么

请提供：

1. 个人或组织工作区名称。
2. 使用的工具和模型。
3. API Key 名称，不要发送完整 Key。
4. 用量日志中的请求 ID、错误代码和大概时间。
5. 如果是充值问题，提供金额和订单时间。