PureBridge API 文档

请求示例

POST /v1/chat/completions

聊天补全支持 stream: true 的流式返回；做响应头验证时建议临时使用 stream: false。

这里显示的是 GET /v1/models 返回的 PureBridge 模型 ID。调用时请按返回值原样使用；它们可能是路由别名，并不等同于上游供应商的官方发布名称。

curl https://api.purebridge.uk/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "codex-auto-review",
  "messages": [
    {
      "role": "system",
      "content": "You are a concise assistant."
    },
    {
      "role": "user",
      "content": "Say hello from PureBridge."
    }
  ],
  "stream": true
}'

响应示例

标准 SSE 流式返回结构

data: {"id":"chatcmpl_123","object":"chat.completion.chunk","model":"codex-auto-review","choices":[{"index":0,"delta":{"role":"assistant"},"finish_reason":null}]}

data: {"id":"chatcmpl_123","object":"chat.completion.chunk","model":"codex-auto-review","choices":[{"index":0,"delta":{"content":"Hello from PureBridge."},"finish_reason":null}]}

data: {"id":"chatcmpl_123","object":"chat.completion.chunk","model":"codex-auto-review","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

data: [DONE]

可验证请求

核对 OpenAI 路由请求的官方 request id

当所选模型路由到 OpenAI 官方上游时，PureBridge 会透传 OpenAI 返回的 x-request-id。你也可以发送 X-Client-Request-Id，把自己的 trace id 带到上游排障链路中。

• x-request-id 是 OpenAI API 为本次上游请求生成的请求 ID，适合 PureBridge 支持侧排障和对账。
• X-Client-Request-Id 由你生成并随请求发送，便于把本地日志、PureBridge 用量记录和上游排障串起来。
• 如果你的模型 ID 实际路由到非 OpenAI 上游，应以该上游自己的响应头和错误格式为准。
• 示例里的 body sha256 是你本地发出字节的哈希；如果后续启用网关级 body-sha256 回显，可以进一步核对上游收到的字节。

verify.sh

响应头验证示例

export PB_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"
CLIENT_REQUEST_ID="pb-verify-$(date +%s)"
BODY='{"model":"codex-auto-review","messages":[{"role":"user","content":"ping"}],"stream":false}'

printf "%s" "$BODY" | shasum -a 256

curl -sS -D - -o /tmp/purebridge-verify.json https://api.purebridge.uk/v1/chat/completions \
  -H "Authorization: Bearer $PB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Client-Request-Id: $CLIENT_REQUEST_ID" \
  --data-binary "$BODY" \
  | grep -Ei '^(x-request-id|openai-|x-ratelimit|date):'

已启用模型 ID

当前环境可用的 PureBridge 模型 ID

这里显示的是 GET /v1/models 返回的 PureBridge 模型 ID。调用时请按返回值原样使用；它们可能是路由别名，并不等同于上游供应商的官方发布名称。

• codex-auto-review codex-auto-review ·
• gpt-5.4-mini gpt-5.4-mini ·
• gpt-5.5 gpt-5.5 ·

模型列表返回

GET /v1/models 的响应结构

{
  "object": "list",
  "data": [
    {
      "id": "codex-auto-review",
      "object": "model",
      "owned_by": ""
    },
    {
      "id": "gpt-5.4-mini",
      "object": "model",
      "owned_by": ""
    },
    {
      "id": "gpt-5.5",
      "object": "model",
      "owned_by": ""
    }
  ]
}

场景重点

这条路径适合什么

• OpenAI-compatible API 调用：把 PureBridge 配到 SDK、CLI、IDE agent 或工作流工具里。
• 开发者效率场景：Codex、opencode、Aider、Continue、Cline、Roo Code 等工具适合代码修改、解释、测试和自动化任务。
• 个人自动化场景：日报、资料整理、消息摘要、内容生成、个人 Bot、定时脚本和低代码工作流。
• 预算治理场景：按工具、项目或工作流拆分 API KEY，通过用量页跟踪请求、Token、费用和异常消耗。

下一步

阅读后怎么做

注册账号，在 App 工作区创建 API KEY，然后调用 API 域名。