Browse docs ▾
Getting started

Introduction

boldrouter is a unified, OpenAI-compatible API gateway to every major LLM provider. Point your existing OpenAI client at one endpoint, pass any model id, and we handle routing, format translation, failover, metering, and billing.

Instead of integrating each provider separately - juggling SDKs, keys, billing, and rate limits - you integrate once. Today the gateway routes 146 models across 26 providers behind a single endpoint.

Why boldrouter

  • One API, every model. Full /v1/chat/completions with streaming, tools, and multimodal pass-through - no SDK changes.
  • Switch models with one string. Change the model field and you're on a different provider.
  • Automatic routing & failover. We pick the best provider by price, latency, or live health, and fail over when one is down or rate-limited.
  • One prepaid balance. Buy credits once, pay per token at provider list price (one small fee on top-ups) - one bill across all providers.

Base URL

The gateway is a drop-in replacement for the OpenAI API. Set your client's base URL to:

text
https://boldrouter.com/v1

Your first request

Any OpenAI SDK works unchanged - just swap the base URL and key. Here it is with curl:

bash
curl https://boldrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $BOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bold/auto",
    "messages": [{ "role": "user", "content": "Hello!" }]
  }'

Endpoints

All under the base URL above, with the same API key:

  • POST /chat/completions - chat, tools, images and documents in, streaming. Chat completions
  • POST /messages - Anthropic's Messages API, for Claude Code and the Anthropic SDK. Claude Code & Anthropic SDK
  • POST /embeddings - vectors for search and RAG. Embeddings
  • POST /audio/speech - text to speech. Text to speech
  • POST /videos - video generation, editing and extension. Video generation
  • POST /files, POST /batches - half-price asynchronous jobs from an uploaded file. Batch API
  • GET /models - the catalog with prices and capabilities. Models
  • GET /credits - balance, spend caps and spend this month. Credits & payments

Where to next