NL ▾

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

Chatinterface gekoppeld aan een gehoste API-server via een gloeiende kabel, ter representatie van een Open WebUI-verbinding

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.com over 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.

  1. Log in bij Open WebUI als admin en open het Admin Panel, dan Settings, dan Connections.
  2. Zoek de sectie OpenAI API en voeg een nieuwe verbinding toe met de plus-knop.
  3. Voer in het URL-veld https://api.abliteratedapi.com/v1 in. Stop bij /v1. Voeg /chat/completions niet toe; Open WebUI voegt het pad zelf toe.
  4. Plak je sleutel in het sleutelveld. Deze wordt verzonden als Authorization: Bearer <key>.
  5. 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

SymptoomWaarschijnlijke oorzaakOplossing
Modellenlijst is leegVerkeerde URL of sleutelVoer de curl-test uit voor /v1/models. URL moet eindigen op /v1.
Verbinding geweigerd of time-out vanuit DockerGeen uitgaand HTTPS-verkeer vanuit de containerControleer DNS-, proxy- en firewall-instellingen op de host.
Authfout bij elk berichtSleutel geplakt met spaties, of oude sleutelKopieer de sleutel opnieuw vanaf de sleutelpagina en sla deze opnieuw op.
Fouten wanneer meerdere mensen tegelijk chattenRate limitsEen volledige sleutel staat 8 gelijktijdige verzoeken en 300 per minuut toe; een proefsleutel staat 2 en 60 toe.
Lang chatten stopt met werkenContextvenster volHet 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.

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