Skip to content
Sign Up Free
AI application platform setup

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

FieldValue
Base URLhttps://bettertoken.ai/v1
API KeyBetterToken API Key
ModelModel IDs: Leave empty to load all models, or add selected Model IDs from the model plaza

Prerequisites

Sign up and get a BetterToken API Key

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

ErrorWhat to check
401 or UnauthorizedCheck the BetterToken API Key and remove leading or trailing spaces.
404The URL must be https://bettertoken.ai/v1. Do not add /chat/completions.
No models in the selectorClick Verify Connection, or add Model IDs manually.
Docker cannot reach the URLMake sure the container has outbound HTTPS access to bettertoken.ai.

Advanced setup

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.