BYOK is live — 1,000,000 free BYOK requests every month, no top-up requiredLearn more

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

  1. Create an account. An organization and a default project are created with it, and a verification code is sent to your email.
  2. 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.
  3. Create an API key on the console's Quick start page. The full key is shown once, so store it in a secrets manager.
  4. Send your first request, below.
  5. 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

ClientBase URL
OpenAI SDKs and HTTP clientshttps://api.boostrail.com/v1
Anthropic SDKs and Claude Codehttps://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

EndpointWhat it does
POST /v1/chat/completionsOpenAI Chat Completions, with streaming and tools. Reference
POST /v1/responsesOpenAI Responses, stateless. Used by Codex CLI. Reference
POST /v1/messagesAnthropic Messages. Used by Claude Code. Reference
GET /v1/modelsThe models your key can call. Reference
POST /v1/images/generationsImage generation, billed per image. Image models and prices
POST /v1/videosSubmit 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

HeaderMeaning
x-request-idSet on every request that passes authentication. Quote it when you contact support.
x-client-request-idEchoes the x-request-id you sent, if you sent one.
x-boostrail-degradedLists 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.

Last updated: 2026-10-03