OpenBridger实用教程
EN 进入控制台

完成第一次调用

这条路径只做四件事:注册并登录、确认钱包里有额度、创建一把 API Key、用 curl 打通 POST /v1/chat/completions。

开始之前

注册页提供的方式以页面为准。程序默认打开的是用户名或邮箱加密码的注册;如果页面要求邮箱验证码或人机验证,按页面做完再继续。GitHub 等第三方登录只有在登录页实际出现时才可用。

截图待补

注册成功后的控制台首页,标出「钱包」「API 密钥」「模型广场」「使用日志」四个入口。由运营用当前界面替换本段。

步骤

注册并登录

打开 https://openbridger.com,完成注册后进入控制台。登录失败次数过多会被临时限制,等一会儿再试,不要连续撞密码。

看钱包余额

打开 钱包。余额以人民币显示。注册不赠送额度,新用户余额是 0。要先用页面上的在线充值或兑换码,见 充值与兑换,余额够一次短对话再继续。

复制模型 ID

打开 模型广场,选一个你的分组能用的对话模型,复制完整模型 ID。不要自己缩短版本号。

创建 API Key

打开 API 密钥,新建一把名为 curl-test 的密钥。复制出来的值以 sk- 开头。细节见 创建 API Key。

发送一条短请求

把下面命令里的密钥和模型 ID 换成你自己的,然后执行。

export OPENBRIDGER_API_KEY="sk-把控制台复制的密钥贴在这里"
export OPENBRIDGER_MODEL="模型广场里的完整模型 ID"

curl "https://openbridger.com/v1/chat/completions" \
  -H "Authorization: Bearer ${OPENBRIDGER_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\": \"${OPENBRIDGER_MODEL}\",
    \"messages\": [{\"role\": \"user\", \"content\": \"用一句话回复:pong\"}]
  }"

成功时响应是一段 JSON,里面有 choices[0].message.content。同时响应头里有 X-Oneapi-Request-Id,报错时把它和正文一起留下来。

确认请求真的经过网关

  1. 打开 使用日志。
  2. 按刚才的时间和密钥名 curl-test 筛选。
  3. 核对模型 ID、状态和消耗。日志里有这一条,才说明客户端没有把请求发到别的地址。

也可以先在 AI 体验台 用同一模型发一句短消息。体验台走的是登录会话,不是 API Key;它能验证模型和额度,不能代替上面的 curl。

这一步常见错误

现象 处理
401,文案「无效的令牌」 密钥复制错了、已禁用、已过期,或这把密钥自己的额度用尽。重新复制,不要手写第二遍 Bearer 或 sk-。
403,文案含「用户额度不足」 钱包或当前扣费来源不够这次预扣。先充值或换一个更小的请求。见 额度与计费。
503,文案含「无可用渠道」 模型 ID 写错,或当前分组没有能服务它的线路。从模型广场重新复制。
连接失败、超时 先确认地址是 https://openbridger.com/v1/chat/completions,没有写成 /v1/v1/。再看 故障排查。

完整状态码表在 错误码。

下一步

输入关键词开始搜索