OpenBridger实用教程
EN 进入控制台

常见问题

Base URL 填什么?

OpenAI 兼容客户端填 https://openbridger.com/v1。只有单独一个「完整 Endpoint」输入框时,才在后面加 /chat/completions。

Claude Code 和 Anthropic SDK 填 https://openbridger.com,不带 /v1。说明见 Claude Code。

文档示例的 Base URL 是 https://openbridger.com/v1。

密钥要不要加 Bearer?

请求头是 Authorization: Bearer sk-...。密钥本身已经带 sk-。不要写成 Bearer Bearer 或 Bearer sk-sk-。

为什么模型列表是空的,密钥却没报错?

不少客户端不调用 /v1/models,或者会丢掉自己不认识的 ID。用 curl 能列出模型时,把 模型广场 的完整 ID 手工加进去。

怎样确认流量走了 OpenBridger?

给这个客户端单独一把密钥,发一句短消息,然后在 使用日志 里按密钥和时间查找。只看客户端界面上的模型名不够。

要退出原来的官方账号吗?

通常不用。编辑器账号负责登录和同步;自定义 Base URL 只影响走这把密钥的请求。恢复官方模型时,关掉自定义 Base URL 或换回内置供应商,并清掉对应环境变量,然后重启客户端。

401 和 403 怎么分?

401「无效的令牌」是密钥不可用,包括这把密钥自己的额度用尽。403 且 code 为 insufficient_user_quota 是钱包或订阅不够预扣。分组、IP 白名单和封禁也是 403,但文案不同。表在 错误码。

支持哪些客户端?

任何能自定义 Base URL、API Key 和模型 ID 的 OpenAI 兼容客户端都可以按 通用说明 试。单独写了步骤的有 Cursor、Claude Code、Codex、CC Switch、Cherry Studio、Chatbox、LobeChat、Open WebUI、Trae、CodeBuddy,以及 OpenAI SDK 和 LangChain。

某个模型是否支持工具调用、图像或该客户端要求的协议,以模型广场和一次短请求的结果为准。

钱包和套餐哪个先扣?

默认是「优先订阅」。没有订阅额度时扣钱包。四种偏好和购买入口见 订阅套餐。

可以怎样充值?

钱包页展示的在线支付(默认是支付宝和微信)以及兑换码。最低金额和到账数以确认页为准。见 充值与兑换。

注册会送额度吗?

不赠送。新用户钱包余额是 0。调用前需要充值或使用兑换码。

请求失败要不要一直重试?

401、403 额度不足、400 参数错误,重试不会成功。429 和上游暂时失败可以有限次退避重试。不要写成死循环。

相关

输入关键词开始搜索