开发文档
BoostRail 提供 OpenAI 兼容 API。已在用 OpenAI SDK 的应用,只需把 base_url 改为网关地址、api_key 换成平台 Key,即可调用全部已接入模型。
接入四步
- 注册账号——组织与项目自动配好。
- 在控制台创建 API Key。明文仅创建时展示一次,请立即保存到安全的密钥管理工具。
- 在 SDK 或 HTTP 客户端中设置 base_url 与 api_key。
- 发起调用。模型名参见模型列表页,也可用 GET /v1/models 实时查询。
代码示例
Python
from openai import OpenAI
client = OpenAI(
api_key="你的 API Key",
base_url="https://api.boostrail.com/v1",
)
response = client.chat.completions.create(
model="deepseek-v4-pro",
messages=[{"role": "user", "content": "你好"}],
stream=True,
)
for chunk in response:
print(chunk.choices[0].delta.content or "", end="")Node.js
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "你的 API Key",
baseURL: "https://api.boostrail.com/v1",
});
const completion = await client.chat.completions.create({
model: "deepseek-v4-pro",
messages: [{ role: "user", content: "你好" }],
});
console.log(completion.choices[0].message.content);curl
curl https://api.boostrail.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer 你的 API Key" \
-d '{
"model": "deepseek-v4-pro",
"messages": [{"role": "user", "content": "你好"}]
}'端点说明
GET /v1/models— 查询当前账号可用的模型清单。POST /v1/chat/completions— 对话补全,支持 stream=true 流式输出(OpenAI 流式格式)。
常见错误
| HTTP 状态 | 错误码 | 说明 |
|---|---|---|
| 401 | missing_api_key / invalid_api_key | 未携带或 Key 错误,检查 Authorization 头。 |
| 403 | disabled_api_key / expired_api_key | Key 已禁用或过期,请在控制台更换。 |
| — | 余额不足 | 请求会被拒绝且不产生负余额,充值后即恢复。 |
安全提示
不要把 API Key 写进前端代码、公开仓库、日志或截图。怀疑泄露时,在控制台立即禁用该 Key 并创建新 Key。