OpenBridger实用教程
EN 进入控制台

OpenAI 兼容调用

能填写 Base URL、API Key 和模型 ID 的客户端,按下面三个值接入。图像、语音、工具调用是否可用,取决于模型广场里的该模型和当前线路,不是 Base URL 本身。

Base URLhttps://openbridger.com/v1
API Keysk-...,请求头用 Bearer
对话路径POST /v1/chat/completions

密钥放在环境变量里。下面示例用 YOUR_API_KEY 占位,运行前替换,或改成读取环境变量。

curl

curl "https://openbridger.com/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID_FROM_CONSOLE",
    "messages": [{"role": "user", "content": "Hello OpenBridger"}]
  }'

流式输出加上 "stream": true。是否在流里返回用量,看模型和线路,以响应和 使用日志 为准。

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.OPENBRIDGER_API_KEY,
  baseURL: process.env.OPENBRIDGER_BASE_URL, // https://openbridger.com/v1
});

const response = await client.chat.completions.create({
  model: process.env.OPENBRIDGER_MODEL,
  messages: [{ role: "user", content: "Hello OpenBridger" }],
});

console.log(response.choices[0].message.content);
export OPENBRIDGER_API_KEY="sk-..."
export OPENBRIDGER_BASE_URL="https://openbridger.com/v1"
export OPENBRIDGER_MODEL="MODEL_ID_FROM_CONSOLE"

官方 SDK 会在 baseURL 后面拼接 /chat/completions。baseURL 必须含 /v1,不要再写成 https://openbridger.com/v1/chat/completions。

Python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["OPENBRIDGER_API_KEY"],
    base_url=os.environ["OPENBRIDGER_BASE_URL"],
)

response = client.chat.completions.create(
    model=os.environ["OPENBRIDGER_MODEL"],
    messages=[{"role": "user", "content": "Hello OpenBridger"}],
)

print(response.choices[0].message.content)

Python SDK 的参数名是 base_url,不是 baseURL。

其他常用路径

在同样的 Base URL 下,把路径换成网关已实现的接口即可,例如:

curl "https://openbridger.com/v1/embeddings" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"MODEL_ID_FROM_CONSOLE","input":"hello"}'

模型列表:

curl "https://openbridger.com/v1/models" \
  -H "Authorization: Bearer YOUR_API_KEY"

路径清单见 产品介绍。未实现的路径返回 501 api_not_implemented。

不要从公开网页直接带密钥

浏览器里的密钥对访问者可见。网页应用请调用你自己的后端,由后端再请求 OpenBridger。

常见问题

现象 处理
请求仍发往 api.openai.com Node 检查 baseURL,Python 检查 base_url
404 且路径里有两个 /v1 Base URL 多写了一层 /v1
tools 报错 先去掉工具,用纯文本打通,再确认该模型是否支持工具调用
401 / 403 / 503 按 错误码 对照,不要只看客户端的「网络错误」

相关

输入关键词开始搜索