开发文档
快速上手
一个 base URL 加一个 Key,就能调用目录里的所有模型。接口支持三种请求格式:OpenAI Chat Completions、OpenAI Responses 和 Anthropic Messages。已有的 SDK 和编程 agent 只需换上新的 base URL 和 Key。
开通账号
- 注册账号。注册时会一并建好组织和默认项目,并向你的邮箱发送验证码。
- 在控制台验证邮箱。在控制台注册并验证邮箱的账号可领 $1 试用额度,7 天内有效,本月试用预算发完即止。可领试用的邮箱:Gmail、Outlook / Hotmail / Live、iCloud、Yahoo、Proton、AOL、Zoho、Yandex、Mail.ru、Naver、GMX、Web.de、QQ、Foxmail、163、126、Yeah.net、新浪、搜狐、阿里云、139、189.cn 的个人邮箱;或者收信托管在 Google Workspace、Microsoft 365、飞书 / Lark、腾讯企业邮、网易企业邮、阿里企业邮、Zoho、Fastmail、Proton、Yandex 360、iCloud+ 的公司域名(每个公司域名每月限若干个账号)。其他邮箱照常注册和充值。
- 在控制台的「快速开始」页创建 API Key。完整的 Key 只显示一次,请存进密钥管理工具。
- 按下面的示例发出第一个请求。
- 充值后继续使用:银行卡充值 $5 起,也支持 USDT 和美元 Wise 银行转账。也可以改用自己的 Key:免费的 BYOK 套餐 用你添加的 Key 调用所支持厂商的模型,不需要充值。
base URL 与鉴权
| 客户端 | base URL |
|---|---|
| OpenAI SDK 和 HTTP 客户端 | https://api.boostrail.com/v1 |
| Anthropic SDK 和 Claude Code | https://api.boostrail.com(SDK 会自动补上 /v1/messages) |
用 Authorization: Bearer YOUR_API_KEY 发送 Key。Anthropic 客户端也可以改用 x-api-key: YOUR_API_KEY。两个请求头同时出现时,以 Bearer 为准。
第一个请求
curl https://api.boostrail.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v4.1-flash",
"messages": [{"role": "user", "content": "你好"}]
}'from openai import OpenAI
client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.boostrail.com/v1")
response = client.chat.completions.create(
model="deepseek-v4.1-flash",
messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)import OpenAI from "openai";
const client = new OpenAI({ apiKey: "YOUR_API_KEY", baseURL: "https://api.boostrail.com/v1" });
const completion = await client.chat.completions.create({
model: "deepseek-v4.1-flash",
messages: [{ role: "user", content: "你好" }],
});
console.log(completion.choices[0].message.content);模型 ID 见 模型页,也可以用 GET /v1/models 获取。
接口一览
| 接口 | 用途 |
|---|---|
POST /v1/chat/completions | OpenAI Chat Completions,支持流式和工具调用。参考 |
POST /v1/responses | OpenAI Responses,无状态。Codex CLI 用这个接口。参考 |
POST /v1/messages | Anthropic Messages。Claude Code 用这个接口。参考 |
GET /v1/models | 列出你的 Key 能调用的模型。参考 |
POST /v1/images/generations | 图片生成,按张计费。图片模型与价格 |
POST /v1/videos | 提交视频生成任务,之后轮询 GET /v1/videos/{id},或用 POST /v1/videos/{id}/cancel 取消。失败或取消的任务不计费。视频模型与价格 |
响应头
| 响应头 | 含义 |
|---|---|
x-request-id | 通过鉴权的请求都会带上。联系客服时请提供这个值。 |
x-client-request-id | 如果你在请求里带了 x-request-id,这里原样返回。 |
x-boostrail-degraded | 列出已接收但没有生效的请求字段。各接口页写明了它覆盖哪些字段。 |
Key 安全
不要把 API Key 放进前端代码、公开仓库、日志或截图。Key 可能泄露时,先在控制台停用,再新建一个。
下一步
- 报错与换线:状态码、重试,以及请求在什么情况下会换到另一条线路。
- 编程 agent 接入:Claude Code、Codex CLI、Cline 等工具的配置。
- 价格:计费、充值和手续费的规则。