原来用 OpenAI SDK,接 BeatAPI 要改什么?
现有 OpenAI SDK 项目切换到 BeatAPI 时,只需修改三项配置:API Key、base_url(https://direct.beatapi.io/v1)以及精确的可用 model ID。原有 Chat Completions(messages)或 Responses(input)代码结构无需重写。
最小接入配置
在服务端初始化客户端时填入 BEATAPI_API_KEY,将 base_url 指向文本直连地址 https://direct.beatapi.io/v1(可规避常规 API 域名的 Cloudflare 100 秒超时限制,网络不可达时可回退至 https://api.beatapi.io/v1),并指定已开通的模型 ID(例如 gpt-6-luna)。
校验与灰度放量步骤
- 核对可用模型:不确定当前 Key 可调用的模型 ID 时,携带
Authorization: Bearer <BEATAPI_API_KEY>调用GET https://api.beatapi.io/v1/models获取列表。 - 保持协议对应:Chat Completions 继续调用
POST /v1/chat/completions并传messages;Responses 继续调用POST /v1/responses并传input。 - 逐项恢复高级参数:先发一条短的非流式请求并核对返回的
model与内容,再依次开启流式输出和结构化输出。永久 API Key 只保存在可信服务端,不放入浏览器或移动端代码。
合同与相关问题
发送收费请求前,先免费查看模型合同:model:gpt-6-luna, model:gpt-image-2.5-flare-std。

