Docs
Quickstart
One base URL and one key reach every model in the catalog. The API accepts three request formats — OpenAI Chat Completions, OpenAI Responses and Anthropic Messages — so existing SDKs and coding agents only need a new base URL and key.
Set up an account
- Create an account. An organization and a default project are created with it, and a verification code is sent to your email.
- Verify your email in the console. Accounts that sign up in the console and verify their email receive $1 in trial credit, valid for 7 days, while this month's trial budget lasts. Eligible addresses: personal mailboxes from Gmail, Outlook / Hotmail / Live, iCloud, Yahoo, Proton, AOL, Zoho, Yandex, Mail.ru, Naver, GMX, Web.de, QQ, Foxmail, 163, 126, Yeah.net, Sina, Sohu, Aliyun, 139 and 189.cn, or a company domain whose mail is hosted on Google Workspace, Microsoft 365, Feishu / Lark, Tencent Exmail, NetEase, Alibaba Mail, Zoho, Fastmail, Proton, Yandex 360 or iCloud+ (a limited number of accounts per company domain each month). Other addresses can sign up and top up as usual.
- Create an API key on the console's Quick start page. The full key is shown once, so store it in a secrets manager.
- Send your first request, below.
- Add balance to keep going: card top-ups start at $5; USDT and Wise bank transfers in USD are also accepted. Or use your own keys instead: the free BYOK plan calls supported labs' models with keys you add, no top-up needed.
Base URL and authentication
| Client | Base URL |
|---|---|
| OpenAI SDKs and HTTP clients | https://api.boostrail.com/v1 |
| Anthropic SDKs and Claude Code | https://api.boostrail.com (the SDK adds /v1/messages) |
Send the key as Authorization: Bearer YOUR_API_KEY. Anthropic clients may send x-api-key: YOUR_API_KEY instead. If both headers are present, the Bearer token is used.
First request
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": "Hello"}]
}'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": "Hello"}],
)
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: "Hello" }],
});
console.log(completion.choices[0].message.content);Model ids are listed on the Models page and returned by GET /v1/models.
Endpoints
| Endpoint | What it does |
|---|---|
POST /v1/chat/completions | OpenAI Chat Completions, with streaming and tools. Reference |
POST /v1/responses | OpenAI Responses, stateless. Used by Codex CLI. Reference |
POST /v1/messages | Anthropic Messages. Used by Claude Code. Reference |
GET /v1/models | The models your key can call. Reference |
POST /v1/images/generations | Image generation, billed per image. Image models and prices |
POST /v1/videos | Submit a video generation task, then poll GET /v1/videos/{id} or cancel with POST /v1/videos/{id}/cancel. Failed or cancelled tasks are not charged. Video models and prices |
Response headers
| Header | Meaning |
|---|---|
x-request-id | Set on every request that passes authentication. Quote it when you contact support. |
x-client-request-id | Echoes the x-request-id you sent, if you sent one. |
x-boostrail-degraded | Lists request fields that were accepted but not applied. Each endpoint page says which fields this covers. |
Key safety
Keep API keys out of frontend code, public repositories, logs and screenshots. If a key may have leaked, disable it in the console and create a new one.
Next steps
- Errors and failover: status codes, retries, and when a request moves to another route.
- Coding agents: settings for Claude Code, Codex CLI, Cline and other tools.
- Pricing: how billing, top-ups and fees work.