OpenAI-compatible clients
Set the base URL tohttps://platform.belvedir.ai/api/v1/route and the key to your bv_live_ key.
gpt-5.2); every other provider’s id is written provider-prefixed (x-ai/grok-4.6, anthropic/claude-sonnet-5). If a call site used a provider-native SDK (xAI, Google), swap it for the OpenAI client pointed at Belvedir and write the model in the prefixed spelling; bare ids are normalized too, so a missed one still routes. The full catalog is on Available Models.
Anthropic SDK clients
Anthropic SDK call sites do not swap to the OpenAI client. Point the Anthropic client athttps://platform.belvedir.ai/api instead: requests pass through to the Messages API untranslated, with prompt caching, thinking, beta headers and native streaming intact. That surface is model-pinned, so routing stays with the OpenAI-shaped endpoint. Details on Messages.
What happens
The first call naming a model creates a router anchored on it, listed on the Routers page as “From your code”. That model is the ceiling: it answers every conversational call, so people always talk to the model your code named. With Smart routing on (the default), cheaper tiers take the machine-shaped tasks underneath it (classification, extraction, formatting, tool loops), so you pay less when a smaller model is enough for the busywork. Turned off, every call serves exactly the model it names. Every project also has an auto router;model: "auto" hands a call to it outright. The response’s model field tells you what actually ran, and the x-belvedir-* response headers say why. How routers, tiers and Automatic updates work is on Model Routing.
Billing
Belvedir runs the call and bills your organization per token at the rates on the Pricing page (Inference → Pricing), attributed to the calling API key. Every response carriesusage.cost, the amount billed for that call.
Next steps
- Model Routing: tiers, task-group routes, Smart routing and Automatic updates.
- Available Models: every model and its identifier.
- Capabilities and Limits: what each surface supports and every hard limit.
- Chat completions: the full request and response contract.