OpenBridger实用教程
EN 进入控制台

故障排查

先用 curl 把网关和客户端分开。curl 成功、客户端失败,就查客户端的地址和缓存。curl 也失败,就查密钥、额度和模型 ID。

自检

curl -i "https://openbridger.com/v1/models" \
  -H "Authorization: Bearer ${OPENBRIDGER_API_KEY}"
  • HTTP 200 且有模型列表:密钥和地址可用。
  • 401:密钥本身不可用。见 错误码。
  • 403 且提到额度:去 钱包。
  • 连接不上:确认主机名是 openbridger.com,路径不要写成 /v1/v1/models。

然后再发一条 快速开始 里的短对话,到 使用日志 对请求 ID。

对照表

现象 常见原因 处理
401「无效的令牌」 密钥错、禁用、过期,或密钥额度用尽;多写了 Bearer 从 API 密钥页重新复制,检查该密钥剩余额度和过期时间
403 额度不足 钱包或订阅不够预扣 充值,或缩短输入后再试
403 分组 / IP 密钥分组不可用,或 IP 白名单不含当前出口 改分组或白名单
503 无可用渠道 模型 ID 不属于当前分组 从模型广场复制完整 ID
上游 404 / model not found 上游不认识这个名字,或客户端改写了 ID 换广场里的另一个 ID,并看日志里实际提交的名字
429 本地频率限制或上游限流 看文案是否包含「您已达到请求数限制」。是则等窗口;否则是上游,稍后重试
超时 上下文很长或上游慢 用一句短提示、减小输出长度再对比
流式中断 网络或客户端对流的处理 同一模型先发 "stream": false
扣费偏高 历史消息重复、工具调用多 在日志里看 token,而不是只看客户端气泡
改了配置仍走旧地址 环境变量或另一个配置文件还在 新开终端,检查 OPENAI_* 和 ANTHROPIC_*
模型列表拉不下来 客户端要的不是 /v1/models,或它过滤了 ID 手工填模型 ID

地址填法

客户端类型 填写
OpenAI SDK、Chatbox、Cherry Studio、LobeChat、Cursor 的 OpenAI Base URL、Open WebUI https://openbridger.com/v1
只有「完整 Endpoint」一栏 https://openbridger.com/v1/chat/completions
Claude Code、Anthropic SDK https://openbridger.com(不要加 /v1)
Codex Base URL https://openbridger.com/v1,协议 Responses

相关

输入关键词开始搜索