Configurar a BetterToken no Open WebUI: conexão OpenAI, API Key e modelos
Adicione a BetterToken ao Open WebUI como conexão compatível com OpenAI, escolha modelos, verifique a conexão e corrija erros comuns.
Para conectar o Open WebUI à BetterToken, adicione uma conexão com a API OpenAI com a Base URL e a BetterToken API Key. O Open WebUI carrega automaticamente os modelos disponíveis.
Configurações principais
| Campo | Valor |
|---|---|
| Base URL | https://bettertoken.ai/v1 |
| API Key | BetterToken API Key |
| Modelo | Model IDs: Deixe vazio para carregar todos os modelos, ou adicione Model IDs selecionados do catálogo de modelos |
Pré-requisitos
- Uma instância do Open WebUI em execução e uma conta de administrador
- Uma BetterToken API Key: cadastre-se e obtenha uma
- Um Model ID do catálogo de modelos
Já tem uma conta? Entre, recarregue o saldo e crie uma chave no console.
Instalação
Execute o Open WebUI com Docker ou pip conforme a documentação do Open WebUI e entre com a conta de administrador. Nenhum plugin extra é necessário.
Configuração manual
Configure a conexão na interface de configurações do Open WebUI. Não é preciso editar nenhum arquivo de configuração.
Abrir as configurações de conexão
Acesse Admin Settings → Connections. Na seção OpenAI API, clique em + Add Connection.
Preencher os dados da conexão
- URL →
https://bettertoken.ai/v1 - API Key → sua BetterToken API Key
Escolher modelos (opcional)
Deixe Model IDs vazio para exibir todos os modelos da BetterToken. Para exibir apenas alguns, adicione Model IDs como claude-sonnet-5-5, gpt-6-sol ou deepseek-flash. Uma lista não vazia substitui a lista automática.
Verificar e salvar
Clique em Verify Connection, aguarde a mensagem de sucesso e clique em Save.
Verificar a conexão
Inicie um novo chat, selecione um modelo da BetterToken e envie Responda com uma só palavra: OK.
Trocar de modelo
Escolha outro modelo da BetterToken no seletor de modelo do chat. Se você limitou Model IDs, adicione primeiro à conexão o novo Model ID do catálogo de modelos.
Erros comuns
| Erro | O que verificar |
|---|---|
401 / Unauthorized | Verifique a BetterToken API Key e remova espaços no início ou no fim. |
404 | A URL deve ser https://bettertoken.ai/v1. Não adicione /chat/completions. |
| Nenhum modelo no seletor | Clique em Verify Connection ou adicione os Model IDs manualmente. |
| O Docker não alcança a URL | Garanta que o contêiner tenha acesso HTTPS de saída para bettertoken.ai. |
Configuração avançada
Guias relacionados
Detalhes técnicos
Protocolo e endpoint
O Open WebUI acrescenta /chat/completions e /models a https://bettertoken.ai/v1. Não adicione um caminho de endpoint à URL.

