Open WebUI BetterToken setup: OpenAI connection, API key, and models
Add BetterToken to Open WebUI as an OpenAI-compatible connection, choose models, verify the connection, and fix common errors.
To connect Open WebUI to BetterToken, add an OpenAI API connection with the BetterToken Base URL and API Key. Open WebUI reads the available models from BetterToken automatically.
Key settings
| Field | Value |
|---|---|
| Base URL | https://bettertoken.ai/v1 |
| API Key | BetterToken API Key |
| Model | Model IDs: Leave empty to load all models, or add selected Model IDs from the model plaza |
Prerequisites
- A running Open WebUI instance and an administrator account
- A BetterToken API Key: register and get one
- A Model ID from the model plaza
Already have an account? Sign in, top up, then create a key in the console.
Install
Run Open WebUI with Docker or pip as described in the Open WebUI documentation, then sign in with the administrator account. No extra plugin is needed.
Manual setup
Complete this setup in the Open WebUI settings UI. You do not need to edit a configuration file.
Open the connection settings
Go to Admin Settings → Connections. In the OpenAI API section, click + Add Connection.
Fill in the connection
- URL →
https://bettertoken.ai/v1 - API Key → your BetterToken API Key
Choose models (optional)
Leave Model IDs empty to show every BetterToken model. To show only a few, add Model IDs such as claude-sonnet-5-5, gpt-6-sol, or deepseek-flash. A non-empty list replaces the automatic list.
Verify and save
Click Verify Connection, wait for the success message, and click Save.
Verify the connection
Start a new chat, select a BetterToken model, and send Reply with one word: OK.
Switch models
Choose another BetterToken model in the model selector of the chat. If you limited Model IDs, add the new Model ID from the model plaza to the connection first.
Common errors
| Error | What to check |
|---|---|
401 or Unauthorized | Check the BetterToken API Key and remove leading or trailing spaces. |
404 | The URL must be https://bettertoken.ai/v1. Do not add /chat/completions. |
| No models in the selector | Click Verify Connection, or add Model IDs manually. |
| Docker cannot reach the URL | Make sure the container has outbound HTTPS access to bettertoken.ai. |
Advanced setup
Related guides
Technical details
Protocol and endpoint
Open WebUI appends /chat/completions and /models to https://bettertoken.ai/v1. Do not add an endpoint path to the URL.

