Configuração da API compatível com OpenAI no Open WebUI em 5 minutos
Para usar as configurações da API compatível com OpenAI do open webui, você adiciona uma conexão com uma URL base e uma chave, e o modelo aparece no seletor. Aqui está a configuração exata para o Abliterated API, do Docker ao primeiro chat.
Atualizado

Pontos principais
- A URL base é https://api.abliteratedapi.com/v1 e o ID do modelo é
uncensored. - Adicione-o nas configurações de conexões do admin ou passe OPENAI_API_BASE_URL e OPENAI_API_KEY para o Docker.
- Teste a chave com curl primeiro, para distinguir um problema de chave de um problema de interface.
- O Open WebUI é apenas o front end: você paga por token pelo que o modelo lê e escreve, e nenhum cartão é necessário para começar.
O resumo
Se você quer a configuração da API compatível com OpenAI do open webui em um parágrafo: abra as configurações do admin, adicione uma conexão de API OpenAI, defina a URL para https://api.abliteratedapi.com/v1, cole sua chave, salve e selecione o modelo chamado uncensored. É isso. O Open WebUI conversa com qualquer coisa que implemente o formato de chat completions da OpenAI, e esta API faz isso.
O serviço é uma API de texto hospedada e compatível com OpenAI que executa um único modelo de pesos abertos, ajustado para responder sem recusas de conteúdo para uso adulto legal. É operado por um provedor independente e não é a API oficial de nenhum laboratório de modelos. O Open WebUI é apenas o front end de chat que você aponta para ele.
Antes de começar
- Uma chave de API. Crie uma na página da chave de API. O cadastro é feito com Google ou com e-mail e senha. Novos usuários podem reivindicar $0,50 de crédito de teste com um clique nessa página, válido por 7 dias e sem necessidade de cartão.
- Um Open WebUI em execução. Uma instalação via Docker ou via pip funcionam. Os passos abaixo cobrem o Docker e a tela de configurações.
- Acesso à rede da máquina que executa o Open WebUI para
api.abliteratedapi.comvia HTTPS.
Verifique a chave antes de mexer na interface. Se esta chamada retornar uma lista contendo uncensored, a chave e a URL estão corretas:
curl https://api.abliteratedapi.com/v1/models -H "Authorization: Bearer $ABLITERATED_API_KEY"
Em seguida, confirme que uma conclusão real funciona:
curl https://api.abliteratedapi.com/v1/chat/completions -H "Authorization: Bearer $ABLITERATED_API_KEY" -H "Content-Type: application/json" -d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello in five words."}]}'Método 1: adicione a conexão nas configurações
Esta é a rota mais fácil e funciona em uma instalação existente. Os rótulos do menu mudam entre versões do Open WebUI, então os nomes abaixo podem variar ligeiramente.
- Entre no Open WebUI como admin e abra o Painel do Admin, depois Configurações e, em seguida, Conexões.
- Encontre a seção API OpenAI e adicione uma nova conexão com o botão de mais.
- No campo de URL, insira
https://api.abliteratedapi.com/v1. Pare em/v1. Não adicione/chat/completions; o Open WebUI anexa o caminho automaticamente. - Cole sua chave no campo de chave. Ela é enviada como
Authorization: Bearer <key>. - Use o botão de verificação ao lado dos campos, se sua versão tiver um, e depois salve.
Abra um novo chat e abra o seletor de modelos. O modelo uncensored deve estar na lista, porque o Open WebUI o lê de GET /v1/models. Se a lista permanecer vazia, vá para a seção de solução de problemas abaixo.
Método 2: configure na inicialização com Docker
Para uma instalação nova, passe o endpoint como variáveis de ambiente. O Open WebUI lê OPENAI_API_BASE_URL e OPENAI_API_KEY ao iniciar.
# base URL: https://api.abliteratedapi.com/v1 model to pick in the UI: uncensored
docker run -d -p 3000:8080 -e OPENAI_API_BASE_URL="https://api.abliteratedapi.com/v1" -e OPENAI_API_KEY="$ABLITERATED_API_KEY" -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main
Em seguida, acesse http://localhost:3000, crie a primeira conta (ela se tornará a admin) e inicie um chat. O volume nomeado mantém seus chats e configurações quando você atualiza o container.
Uma coisa que pega as pessoas desprevenidas: muitas configurações do Open WebUI são salvas no banco de dados após o primeiro lançamento, e o valor salvo pode prevalecer sobre uma variável de ambiente posterior. Se você alterar a chave ou URL no Docker e nada acontecer, altere na tela de Conexões ou redefina a configuração armazenada.
Configurações que valem a pena ajustar
Uma vez que o chat funciona, algumas opções tornam a experiência melhor e mantêm a conta previsível.
Use a janela de contexto com sensatez
A janela de contexto tem 100.000 tokens, compartilhada entre prompt e resposta. O Open WebUI reenvia o histórico de chat em cada mensagem, então uma conversa longa fica mais cara a cada turno. A $0,15 por 1M de tokens de entrada, um histórico de 20.000 tokens custa $0,003 para enviar, o que é barato, mas se acumula em milhares de mensagens. Inicie um novo chat para um novo tópico.
Streaming e amostragem
O Open WebUI faz streaming das respostas por padrão, e a API suporta streaming via SSE. Nos parâmetros avançados, você pode definir temperatura, top_p, sequências de parada, uma semente para saída repetível e as penalidades. Eles são passados diretamente para o modelo. Deixe max_tokens vazio, a menos que você queira um limite rígido, já que é opcional.
Tarefas em segundo plano
O Open WebUI pode fazer chamadas extras de modelo em segundo plano para coisas como nomear um chat. Cada uma é uma requisição real no seu saldo e conta para os limites. Se você notar chamadas que não digitou, verifique as configurações do modelo de tarefas e aponte-as para um modelo pelo qual você esteja disposto a pagar, ou desative os recursos auxiliares.
Presets e system prompts
O Open WebUI permite salvar um preset de modelo na seção de workspace: um nome, um modelo base, um system prompt e parâmetros padrão. Crie um sobre uncensored para cada trabalho que você faz com frequência, como um assistente de edição, um revisor de código ou um personagem para uma sessão de ficção interativa. Um system prompt curto que define o papel, o tom e o formato das respostas faz mais do que instruções longas coladas em cada chat.
É aqui que o perfil do modelo ajuda. É um modelo de pesos abertos ajustado para responder sem recusas de conteúdo para uso adulto legal, o que se adequa a ficção, roleplay e aplicativos estilo companheiro para adultos, onde uma recusa no meio de uma cena quebra o fluxo. Isso não altera o limite rígido: nenhum conteúdo sexual envolvendo menores de idade, nunca. Mantenha presets e instâncias compartilhadas dentro dessa regra e dentro da lei onde você mora.
Se outras pessoas usam sua instância do Open WebUI, lembre-se de que elas compartilham sua chave e seus limites. Uma chave completa permite 8 requisições simultâneas, então um punhado de usuários ativos é tranquilo, enquanto um grande grupo conversando ao mesmo tempo pode atingir o limite. Dar a cada pessoa ou equipe sua própria chave distribui a carga e torna o saldo mais fácil de rastrear.
Quanto custa para executar
Você paga apenas por tokens, a partir do crédito pré-pago: $0,15 por 1M de tokens de entrada e $0,50 por 1M de tokens de saída. Requisições falhas ou recusadas não são cobradas e o crédito nunca expira. Uma mensagem de chat típica com 3.000 tokens de histórico e uma resposta de 400 tokens custa $0,00045 + $0,0002 = $0,00065, então $10 de uso equivalem a cerca de 15.000 mensagens.
Recargas variam de $20 a $500 em qualquer valor inteiro, com +5% a partir de $50, +10% a partir de $100 e +15% a partir de $200. Você pode pagar com cripto (USDT na TRC20, USDC na Base). Veja a página de preços para os detalhes. O saldo restante é retornado no cabeçalho X-Balance-USD de cada resposta da API, se você quiser monitorá-lo de um script.
Solução de Problemas
| Sintoma | Causa provável | Correção |
|---|---|---|
| Lista de modelos vazia | URL ou chave incorretos | Execute o teste curl para /v1/models. A URL deve terminar em /v1. |
| Conexão recusada ou timeout do Docker | Sem HTTPS de saída do container | Verifique as configurações de DNS, proxy e firewall no host. |
| Erro de autenticação em todas as mensagens | Chave colada com espaços ou chave antiga | Copie novamente a chave na página de chaves e salve novamente. |
| Erros quando várias pessoas conversam ao mesmo tempo | Limites de requisições | Uma chave completa permite 8 requisições simultâneas e 300 por minuto; uma chave de teste permite 2 e 60. |
| Conversas longas param de funcionar | Janela de contexto cheia | A janela tem 100.000 tokens. Inicie uma nova conversa ou resuma. |
Se o teste com curl passar, mas o Open WebUI falhar, o problema está nas configurações do front end. Se o curl falhar, verifique sua chave e saldo primeiro. O quickstart da documentação lista todos os parâmetros de requisição, e o artigo sobre o que é e o que não é a API de chat sem censura explica o escopo do modelo, incluindo o limite rígido: sem conteúdo sexual envolvendo menores de idade.
Mais guias
Perguntas e respostas
Qual URL eu insiro no Open WebUI?
Use https://api.abliteratedapi.com/v1 e nada depois dele. O Open WebUI adiciona /chat/completions e /models por conta própria.
Qual nome de modelo eu escolho?
O ID do modelo é uncensored. Ele aparece no seletor de modelos assim que a conexão é salva e a lista de modelos é carregada.
Preciso de um cartão para testar?
Não. Novos usuários podem reivindicar $0,50 de crédito de teste com um clique na página da chave de API após o login. É válido por 7 dias e não precisa de cartão.
Posso executá-lo junto com modelos locais?
Sim. O Open WebUI suporta várias conexões ao mesmo tempo, então este endpoint pode ficar ao lado de modelos locais e cada um aparece no mesmo seletor de modelos.
Minhas conversas são usadas para treinamento?
Não. Os prompts enviados para a API não são usados para treinamento. O histórico de conversas armazenado pelo Open WebUI permanece na sua própria instalação.
Sua chave está a um formulário de distância
Crie uma conta, copie a chave e altere a URL base. Essa é toda a configuração.
Obter chave de API