自带 Key(BYOK)已上线,每月 1,000,000 次免费 BYOK 请求,不需要充值了解详情

开发文档

快速上手

一个 base URL 加一个 Key,就能调用目录里的所有模型。接口支持三种请求格式:OpenAI Chat Completions、OpenAI Responses 和 Anthropic Messages。已有的 SDK 和编程 agent 只需换上新的 base URL 和 Key。

开通账号

  1. 注册账号。注册时会一并建好组织和默认项目,并向你的邮箱发送验证码。
  2. 在控制台验证邮箱。在控制台注册并验证邮箱的账号可领 $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+ 的公司域名(每个公司域名每月限若干个账号)。其他邮箱照常注册和充值。
  3. 在控制台的「快速开始」页创建 API Key。完整的 Key 只显示一次,请存进密钥管理工具。
  4. 按下面的示例发出第一个请求。
  5. 充值后继续使用:银行卡充值 $5 起,也支持 USDT 和美元 Wise 银行转账。也可以改用自己的 Key:免费的 BYOK 套餐 用你添加的 Key 调用所支持厂商的模型,不需要充值。

base URL 与鉴权

客户端base URL
OpenAI SDK 和 HTTP 客户端https://api.boostrail.com/v1
Anthropic SDK 和 Claude Codehttps://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/completionsOpenAI Chat Completions,支持流式和工具调用。参考
POST /v1/responsesOpenAI Responses,无状态。Codex CLI 用这个接口。参考
POST /v1/messagesAnthropic 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 等工具的配置。
  • 价格:计费、充值和手续费的规则。

更新日期:2026-10-05