Open WebUI OpenAI-compatibele API instellen in 5 minuten
Om de open webui openai compatible api-instellingen te gebruiken, voeg je één verbinding toe met een base URL en een sleutel, en verschijnt het model in de kiezer. Hier is de exacte setup voor de Abliterated API, van Docker tot de eerste chat.
Bijgewerkt

Belangrijkste punten
- Base URL is https://api.abliteratedapi.com/v1 en de model-ID is
uncensored. - Voeg dit toe in de admin-verbindingeninstellingen, of geef OPENAI_API_BASE_URL en OPENAI_API_KEY door aan Docker.
- Test de sleutel eerst met curl, zodat je een sleutelprobleem van een UI-probleem kunt onderscheiden.
- Open WebUI is alleen de front-end: je betaalt per token voor wat het model leest en schrijft, en er is geen creditcard nodig om te beginnen.
De korte versie
Als je de open webui openai compatible api-setup in één alinea wilt: open de admin-instellingen, voeg een OpenAI API-verbinding toe, stel de URL in op https://api.abliteratedapi.com/v1, plak je sleutel, sla op en kies het model met de naam uncensored. Dat is alles. Open WebUI communiceert met alles wat het OpenAI chat-completions-formaat implementeert, en deze API doet dat.
De service is een gehoste, OpenAI-compatibele tekst-API die één open-weight model draait, afgestemd op antwoorden zonder inhoudelijke weigeringen voor legaal gebruik door volwassenen. Het wordt beheerd door een onafhankelijke provider en is niet de officiële API van een model lab. Open WebUI is gewoon de chat front-end die je erop wijst.
Voordat je begint
- Een API-sleutel. Maak er een aan op de API-sleutelpagina. Aanmelden kan via Google of met e-mail en wachtwoord. Nieuwe gebruikers kunnen met één klik op die pagina $0,50 aan proeftegoed claimen, geldig voor 7 dagen en zonder dat een kaart nodig is.
- Een draaiende Open WebUI. Een Docker-installatie of een pip-installatie werken beide. De onderstaande stappen dekken Docker en het instellingenscherm.
- Netwerktoegang vanaf de machine waarop Open WebUI draait naar
api.abliteratedapi.comover HTTPS.
Controleer de sleutel voordat je de UI raakt. Als dit verzoek een lijst retourneert met daarin uncensored, dan zijn de sleutel en URL geldig:
curl https://api.abliteratedapi.com/v1/models -H "Authorization: Bearer $ABLITERATED_API_KEY"
Bevestig vervolgens dat een echte generatie werkt:
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."}]}'Methode 1: verbinding toevoegen in de instellingen
Dit is de makkelijkste route en werkt op een bestaande installatie. Menu-etiketten verschuiven tussen Open WebUI-versies, dus de namen hieronder kunnen iets verschillen.
- Log in bij Open WebUI als admin en open het Admin Panel, dan Settings, dan Connections.
- Zoek de sectie OpenAI API en voeg een nieuwe verbinding toe met de plus-knop.
- Voer in het URL-veld
https://api.abliteratedapi.com/v1in. Stop bij/v1. Voeg/chat/completionsniet toe; Open WebUI voegt het pad zelf toe. - Plak je sleutel in het sleutelveld. Deze wordt verzonden als
Authorization: Bearer <key>. - Gebruik de verificatieknop naast de velden als je versie die heeft, en sla daarna op.
Open een nieuwe chat en open de modelkiezer. Het model uncensored zou in de lijst moeten staan, omdat Open WebUI het ophaalt uit GET /v1/models. Als de lijst leeg blijft, ga dan naar de onderstaande sectie voor probleemoplossing.
Methode 2: instellen bij het opstarten met Docker
Voor een nieuwe installatie geef je het endpoint door als omgevingsvariabelen. Open WebUI leest OPENAI_API_BASE_URL en OPENAI_API_KEY bij het opstarten.
# 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
Bezoek vervolgens http://localhost:3000, maak het eerste account aan (dit wordt de admin) en start een chat. Het named volume bewaart je chats en instellingen wanneer je de container bijwerkt.
Een ding verrast mensen: veel Open WebUI-instellingen worden na de eerste lancering opgeslagen in de database, en de opgeslagen waarde kan winnen van een latere omgevingsvariabele. Als je de sleutel of URL in Docker wijzigt en er gebeurt niets, wijzig het dan in het Connections-scherm, of reset de opgeslagen instelling.
Instellingen die de moeite waard zijn om aan te passen
Zodra chatten werkt, maken een paar opties de ervaring beter en houden de rekening voorspelbaar.
Gebruik het contextvenster verstandig
Het contextvenster is 100.000 tokens, gedeeld tussen prompt en antwoord. Open WebUI stuurt de chathistorie bij elk bericht opnieuw, dus een lang gesprek wordt duurder na elke beurt. Bij $0,15 per 1M input tokens kost een geschiedenis van 20.000 tokens $0,003 om te versturen, wat goedkoop is, maar het loopt op over duizenden berichten. Start een nieuwe chat voor een nieuw onderwerp.
Streaming en sampling
Open WebUI streamt antwoorden standaard, en de API ondersteunt streaming via SSE. In de geavanceerde parameters kun je temperatuur, top_p, stop-sequenties, een seed voor herhaalbare output en de penalties instellen. Deze worden doorgegeven aan het model. Laat max_tokens leeg, tenzij je een harde limiet wilt, omdat het optioneel is.
Achtergrondtaken
Open WebUI kan op de achtergrond extra modelaanroepen doen voor taken zoals het geven van een naam aan een chat. Elk van deze is een echt verzoek op je saldo en telt mee voor de limieten. Als je modelaanroepen opmerkt die je niet zelf hebt ingetypt, bekijk dan de instellingen van het taakmodel en wijs ze naar een model waarvoor je bereid bent te betalen, of schakel de hulpprogramma's uit.
Voorinstellingen en system prompts
Open WebUI stelt je in staat een modelvoorinstelling op te slaan in de werkruimte: een naam, een basismodel, een systeemprompt en standaardparameters. Maak er een bovenop uncensored aan voor elke taak die je vaak uitvoert, zoals een redactieassistent, een code-reviewer of een personage voor een interactieve fictiesessie. Een korte systeemprompt die de rol, de toon en het formaat van de antwoorden aangeeft, levert meer op dan lange instructies die in elke chat worden geplakt.
Hier helpt het profiel van het model. Het is een open-weight model dat is afgestemd op het geven van antwoorden zonder inhoudelijke weigeringen voor legaal gebruik door volwassenen, wat past bij fictie, rollenspel en companion-style apps voor volwassenen, waar een weigering midden in een scène de flow verstoort. Het verandert de harde limiet niet: geen seksuele inhoud met minderjarigen, ooit. Houd voorinstellingen en gedeelde instanties binnen die regel en binnen de wet in jouw land.
Als andere mensen je Open WebUI-instantie gebruiken, onthoud dan dat ze allemaal je sleutel en de limieten delen. Een volledige sleutel staat 8 gelijktijdige verzoeken toe, dus een handvol actieve gebruikers is prima, terwijl een grote groep die tegelijk chat de cap kan raken. Geef elke persoon of elk team een eigen sleutel om de belasting te spreiden en het saldo makkelijker te volgen.
Wat het kost om uit te voeren
Je betaalt alleen voor tokens, van prepaid credit: $0,15 per 1M input tokens en $0,50 per 1M output tokens. Mislukte of geweigerde verzoeken worden niet in rekening gebracht en het tegoed vervalt nooit. Een typisch chatbericht met 3.000 tokens geschiedenis en een 400-token antwoord kost $0,00045 + $0,0002 = $0,00065, dus $10 aan gebruik is ongeveer 15.000 berichten.
Opwaarderingen lopen van $20 tot $500 in elk geheel bedrag, met +5% vanaf $50, +10% vanaf $100 en +15% vanaf $200. Je kunt betalen met crypto (USDT op TRC20, USDC op Base). Zie de prijzenpagina voor de details. Het resterende saldo wordt teruggegeven in de X-Balance-USD header van elk API-antwoord, als je het wilt monitoren vanuit een script.
Probleemoplossing
| Symptoom | Waarschijnlijke oorzaak | Oplossing |
|---|---|---|
| Modellenlijst is leeg | Verkeerde URL of sleutel | Voer de curl-test uit voor /v1/models. URL moet eindigen op /v1. |
| Verbinding geweigerd of time-out vanuit Docker | Geen uitgaand HTTPS-verkeer vanuit de container | Controleer DNS-, proxy- en firewall-instellingen op de host. |
| Authfout bij elk bericht | Sleutel geplakt met spaties, of oude sleutel | Kopieer de sleutel opnieuw vanaf de sleutelpagina en sla deze opnieuw op. |
| Fouten wanneer meerdere mensen tegelijk chatten | Rate limits | Een volledige sleutel staat 8 gelijktijdige verzoeken en 300 per minuut toe; een proefsleutel staat 2 en 60 toe. |
| Lang chatten stopt met werken | Contextvenster vol | Het venster is 100.000 tokens. Start een nieuw gesprek of vat samen. |
Als de curl-test slaagt maar Open WebUI faalt, ligt het probleem in de front-end instellingen. Als curl faalt, controleer dan eerst je sleutel en saldo. De quickstart in de documentatie somt elke verzoekparameter op, en het artikel over wat de uncensored chat API wel en niet is legt de scope van het model uit, inclusief de harde limiet: geen seksuele inhoud met minderjarigen.
Meer handleidingen
Vragen en antwoorden
Welke URL voer ik in in Open WebUI?
Gebruik https://api.abliteratedapi.com/v1 en niets daarna. Open WebUI voegt /chat/completions en /models automatisch toe.
Welke modelnaam kies ik?
De model-ID is uncensored. Deze verschijnt in de modelkiezer zodra de verbinding is opgeslagen en de modellenlijst is geladen.
Heb ik een creditcard nodig om het te proberen?
Nee. Nieuwe gebruikers kunnen $0,50 aan proeftegoed claimen met één klik op de API-sleutelpagina na het aanmelden. Dit tegoed is 7 dagen geldig en vereist geen creditcard.
Kan ik het naast lokale modellen draaien?
Ja. Open WebUI ondersteunt meerdere verbindingen tegelijk, dus dit endpoint kan naast lokale modellen staan en elk verschijnt in dezelfde modelkiezer.
Worden mijn chats gebruikt voor training?
Nee. Prompts die naar de API worden gestuurd, worden niet gebruikt voor training. Chathistorie die door Open WebUI wordt opgeslagen, blijft in je eigen installatie.
Je sleutel is nog maar één formulier verwijderd
Maak een account aan, kopieer de sleutel, pas de base URL aan. Dat is de hele setup.
API-sleutel aanvragen