FAQ
Common questions about OneRouter
Getting started
Why should I use OneRouter?
OneRouter provides a unified API to access all the major LLM models on the market. It also allows users to aggregate their billing in one place and keep track of all of their usage using our analytics.
OneRouter passes through the pricing of the underlying providers, while pooling their uptime, so you get the same pricing you’d get from the provider directly, with a unified API and fallbacks so that you get much better uptime.
How do I get started with OneRouter?
To get started, create an account and add credits on the Credits page. Credits are simply deposits on OneRouter that you use for LLM inference. When you use the API or chat interface, we deduct the request cost from your credits. Each model and provider has a different price per million tokens.
Once you have credits you can create API keys and start using the API. You can read our quickstart guide for code samples and more.
How do I get support?
The best way to get support is to submit an issue.
How do I get billed for my usage on OneRouter?
For each model we have the pricing displayed per million tokens. There is usually a different price for prompt and completion tokens. There are also models that charge per request, for images and for reasoning tokens. All of these details will be visible on the Logs tab.
When you make a request to OneRouter, we receive the total number of tokens processed by the provider. We then calculate the corresponding cost and deduct it from your credits. You can review your complete usage history in the Activities tab.
You can also add the usage: {include: true} parameter to your chat request to get the usage information in the response.
We offer different discounts ranging from 20% to 80% based on the pricing of underlying providers.
Pricing
What are the prices for using OneRouter?
We offer different discounts ranging from 20% to 80% based on the pricing of underlying providers. So you pay a lower rate than you would directly with the provider.
The total cost is calculated using the formula:
total_cost = (total_prompt_tokens * prompt_price_per_token) + (total_completions_tokens - prompt_price_per_completion)
For more details on our model price, please see our Models tab.
For more details about every request cost, please see our Logs tab.
Models and Providers
What LLM models does OneRouter support?
OneRouter provides access to a wide variety of LLM models, including frontier models from major AI labs.
For a complete list of models you can visit the Models tab or fetch the list through the models api.
How frequently are new models added?
We work on adding models as quickly as we can. We often have partnerships with the labs releasing models and can release models as soon as they are available.
If there is a model missing that you’d like OneRouter to support, feel free to message us on issue.
I am an inference provider, how can I get listed on OneRouter?
If you would like to contact us, the best place to reach us is over email.
How does model fallback work if a provider is unavailable?
If a provider returns an error OneRouter will automatically fall back to the next provider. This happens transparently to the user and allows production apps to be much more resilient.
API Technical Specifications
What authentication methods are supported?
OneRouter uses three authentication methods:
API keys (passed as Bearer tokens) for accessing the completions API and other core endpoints
What API endpoints are available?
OneRouter implements the OpenAI API specification for /completions and /chat/completions endpoints, allowing you to use any model with the same request/response format.
Additional endpoints like /api/v1/models are also available. See our API documentation for detailed specifications.
What are the supported formats?
The API supports text and images. Images can be passed as URLs or base64 encoded images. PDF and other file types are coming soon.
How does streaming work?
Streaming uses server-sent events (SSE) for real-time token delivery.
Set stream: true in your request to enable streaming responses.
What SDK support is available?
OneRouter is a drop-in replacement for OpenAI. Therefore, any SDKs that support OpenAI by default also support OneRouter. Check out our docs for more details.
Privacy and Data Logging
Please see our Terms of Service and Privacy Policy.
What data is logged during API use?
We log basic request metadata (timestamps, model used, token counts). Prompt and completion are not logged by default. We do zero logging of your prompts/completions, even if an error occurs.
What third-party sharing occurs?
OneRouter is a proxy that sends your requests to the model provider for it to be completed. We work with all providers to, when possible, ensure that prompts and completions are not logged or used for training. Providers that do log, or where we have been unable to confirm their policy, will not be routed to unless the model training toggle is switched on in the privacy.
Credit and Billing Systems
What purchase options exist?
OneRouter uses a credit system where the base currency is US dollars.
All of the pricing on our site and API is denoted in dollars. Users can top up their balance manually.
Do credits expire?
Per our terms, we reserve the right to expire unused credits after one year of purchase.
My credits haven't showed up in my account
If you paid using Stripe, sometimes there is an issue with the Stripe integration and credits can get delayed in showing up on your account. Please allow up to one hour. If your credits still have not appeared after an hour, contact us on email and we will look into it.
How do volume discounts work?
OneRouter does not currently offer volume discounts, but you can reach out to us over email if you think you have an exceptional use case.
What payment methods are accepted?
We accept all major credit cards, AliPay, PayPal and WechatPay. if there are any payment methods that you would like us to support please reach out on issue.
Account Management
What analytics are available?
Our activity dashboard provides real-time usage metrics. If you would like any specific reports or metrics please contact us.
How can I contact support?
The best way to reach us is to submit new issue. and email us.
Last updated