OpenAI 兼容接口意味着很多使用 OpenAI SDK 或协议的工具，只需替换接口地址、密钥和模型名称就能连接其他服务。第一次接入时，不要复制一大段框架代码，先用最小请求确认四个参数都正确。

你需要准备什么

在 GBAPI 注册并创建 API Key，然后从模型广场复制当前真实可用的 model 值。教程不会根据 GPT‑5.5 或 GPT‑5.6 的系列名称猜测 API ID。

把密钥保存在环境变量中：

export GBAPI_API_KEY="你的密钥"
export GBAPI_BASE_URL="文档提供的接口地址"
export GBAPI_MODEL="从模型广场复制的型号"

Windows PowerShell 可以使用 $env:GBAPI_API_KEY="..."。不要把真实密钥提交到 Git。

使用 curl 发送最小请求

curl "$GBAPI_BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer $GBAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "替换为真实型号",
    "messages": [
      {"role": "user", "content": "只回复：连接成功"}
    ]
  }'

成功响应通常包含模型输出和用量字段。不同协议或型号的返回结构可能有差异，以 GBAPI 当前文档为准。

用 Python 调用

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["GBAPI_API_KEY"],
    base_url=os.environ["GBAPI_BASE_URL"],
)

response = client.chat.completions.create(
    model=os.environ["GBAPI_MODEL"],
    messages=[{"role": "user", "content": "只回复：连接成功"}],
)

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

四个最常见的检查点

出现错误时依次检查：请求地址是否重复或缺少 /v1；Authorization 是否包含 Bearer ；model 是否从模型广场准确复制；账户余额和渠道状态是否正常。

最小请求成功后，再加入流式输出、工具调用或长上下文。一次只增加一个变量，出错时更容易定位。

生产环境怎么保存密钥

服务端通过环境变量或密钥管理服务读取；为不同应用创建不同密钥；设置额度和速率限制；定期轮换并立即撤销泄露密钥。前端应用必须通过自己的后端请求，不要把上游 Key 发送给浏览器。

常见问题

Base URL 后面要不要加 /v1？

取决于客户端填写的是基础地址还是完整接口地址。按照 GBAPI 文档和客户端字段说明填写，避免重复出现 /v1/v1。

为什么不能把 API Key 写进网页前端？

浏览器里的代码和网络请求可被用户查看，密钥会泄露。生产环境应由自己的服务端读取环境变量并调用上游接口。