DocsStart
Introduction
What Rhumb does: tell it what you need and which providers you use, and get one model to call, with its price and the reason.
Rhumb, the model compass, tells your app which AI model to call (it is said “rum”: a rhumb line holds one compass bearing). You send what you need (a task or a purpose, required capabilities, a budget) and the providers you have accounts with. It answers with one model, named exactly as your provider's API expects it, on the provider where it costs least, plus the same model on your other providers and the next alternatives.
01
Your server asks
GET /v1/resolve with your need and your providers.
02
Rhumb ranks
Every offering on your providers, by capability, quality and price.
03
You call the model
With your own provider SDK and key; Rhumb is not in the path.
It is plain HTTPS: no client library to install. The answer is the same for the same catalog version and need, so you call it at start-up or configuration time and cache it, not on every request.
Where to start
- QuickstartA key and your first call in five minutes.
- ConceptsNeeds, providers, the cheapest offering, capabilities, purposes, budgets and quality.
- API referenceEvery operation, parameter, answer, error and header, generated from the OpenAPI spec.
- SandboxAsk the live API from the browser, no account needed, price a single-model answer against the model you use now, and copy the call.