Supported providers
URL construction
Every Tokonomics proxy call follows this pattern:{slug}— the provider identifier from the table above (e.g.openai,anthropic){path}— the upstream API path you would normally append to the provider’s base URL, without repeating the base URL itself
https://tokonomics.ca/proxy/{slug} prefix and reconstructs the full upstream URL automatically before forwarding your request.
Authentication to providers
Every proxied request carries two sets of credentials:- Your Tokonomics key — passed in the standard
Authorizationheader as a Bearer token. Tokonomics reads this to authenticate you, meter usage, and enforce budget caps. - Your provider API key — passed in whichever header the upstream provider requires (e.g.
Authorizationfor OpenAI,x-api-keyfor Anthropic). Tokonomics forwards this header to the upstream provider unchanged.
Authorization: Bearer mk_... header before it reaches the upstream provider, and passes all other headers — including your provider key — through unchanged.
OpenAI-compatible providers (DeepSeek, Mistral, xAI, Groq, and Together AI) work out of the box with the official
openai Python or Node.js SDK. Simply set base_url to the Tokonomics proxy URL for that provider — no other changes required.