Heeft OpenWebUI een API? Ja, in twee richtingen

Twee verschillende API's waar mensen naar verwijzen

Als iemand vraagt of Open WebUI een API heeft, kan dat over beide richtingen gaan. Het verwarren van beide is de belangrijkste reden waarom installatiehandleidingen verwarrend aanvoelen, dus het helpt om ze eerst te scheiden.

• Inbound: je programma stuurt verzoeken naar Open WebUI. Het fungeert als server met endpoints voor chat, modellen en bestanden, beschermd door een API-sleutel die je in de app genereert.
• Outbound: Open WebUI stuurt verzoeken naar een modelserver zodat het chatvenster iets heeft om tegen te praten. Dit is de verbinding die je configureert onder Beheerdersinstellingen.

Het korte antwoord is dus ja op beide. Het project documenteert een API met een chatendpoint in OpenAI-stijl, en het ondersteunt het verbinden met elke server die het OpenAI-protocol spreekt. Details zoals exacte paden en sleutelafhandeling kunnen tussen versies veranderen, dus controleer de documentatie voor de release die je draait.

Deze site biedt de model API aan de outbound-kant: een gehoste, OpenAI-compatible tekst-API met de enkele model ID uncensored. Het is niet Open WebUI en draait het niet voor je. Open WebUI is software die je zelf host.

De eigen API van Open WebUI gebruiken

Open WebUI laat een ingelogde gebruiker een API-sleutel aanmaken in hun accountinstellingen. Met die sleutel kun je zijn endpoints vanuit scripts aanroepen. Het chatendpoint volgt de OpenAI-vorm, dus bestaande clientcode kan er vaak op worden gericht. Het door het project gedocumenteerde pad op het moment van schrijven is /api/chat/completions; controleer dit tegen jouw versie.

Copy# Open WebUI running locally on port 3000, key created in Settings > Account
curl http://localhost:3000/api/chat/completions \
  -H "Authorization: Bearer $OPENWEBUI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Summarize this scene in one line."}]}'

Let op dat hier de modelnaam de modelnaam is die Open WebUI heeft geregistreerd. Als je deze API hebt verbonden als backend, is die naam uncensored. De sleutel in dit verzoek is een Open WebUI-sleutel, niet de model API-sleutel. Het zijn twee aparte referenties met twee aparte taken.

Waarom de inbound-API gebruiken? Het is nuttig als je de extra's van Open WebUI achter je programma wilt, zoals de opgeslagen kennisverzamelingen, de per-gebruiker accounts of de model presets, en je wilt ze bereiken zonder een browser.

Een externe API als backend gebruiken

De andere richting is degene die de meeste mensen nodig hebben. Open WebUI heeft een sectie voor OpenAI-compatible verbindingen waar je een URL en sleutel invoert. Voor deze service zijn de waarden:

• URL: https://api.nsfwvideo.top/v1
• Sleutel: die van de sleutelpagina
• Model: uncensored, automatisch gedetecteerd via GET /v1/models

Stap voor stap: open Beheerdersinstellingen, ga naar Verbindingen, voeg een OpenAI API-verbinding toe, plak de URL en sleutel, sla op en kies het model in een nieuwe chat. Als je de voorkeur geeft aan een start via de commandoregel, stel dan de omgevingsvariabelen OPENAI_API_BASE_URL en OPENAI_API_KEY in bij het starten van de container.

Copydocker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://api.nsfwvideo.top/v1 \
  -e OPENAI_API_KEY=$API_KEY \
  -v open-webui:/app/backend/data \
  ghcr.io/open-webui/open-webui:main

Let op dat Open WebUI veel instellingen bij de eerste start opslaat in de database. Als je later een omgevingsvariabele wijzigt en er gebeurt niets, bewerk dan de verbinding in het beheerderspaneel. De quickstart heeft het verzoekformaat dat de backend verwacht als je dit wilt verifiëren met curl.

Deze aan elkaar koppelen

Je kunt beide richtingen tegelijk gebruiken. Je applicatie roept de inbound-API van Open WebUI aan met een Open WebUI-sleutel, Open WebUI stuurt de chat door naar de backend die je hebt geconfigureerd, en het antwoord stroomt terug. Deze opstelling heeft zin in een paar situaties: een team draait al Open WebUI met accounts en wil scripts die zijn voorkeuren delen, of je wilt één plek die persona-instellingen bevat voor zowel mensen als programma's.

Het voegt een hop toe. Elk verzoek kruist nu je Open WebUI-server voordat het de model API bereikt, dus er is nog een ding om te laten draaien, te patchen en te beveiligen. Rate limits stapelen zich ook op een onduidelijke manier: de backend-sleutel staat 8 gelijktijdige verzoeken en 300 per minuut toe voor een volledige sleutel, en elke gebruiker en script die via je Open WebUI-instantie gaat, deelt die toelage. Als de backend antwoordt met HTTP 429, met foutcode rate_limited of concurrency, verschijnt de fout meestal als een fout in Open WebUI en in je aanroeper.

Wanneer je Open WebUI kunt overslaan en de API direct kunt aanroepen

Als je alleen een script nodig hebt dat tekst genereert, zoals outlines, shotbeschrijvingen of conceptvoice-over, is Open WebUI onnodig. Deze service is een normale OpenAI-compatible endpoint, dus de standaard SDK praat er direct mee.

Copyimport os
from openai import OpenAI

client = OpenAI(base_url="https://api.nsfwvideo.top/v1", api_key=os.environ["API_KEY"])

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You write concise shot lists for short films."},
        {"role": "user", "content": "Shot list for a ninety second chase through a night market."},
    ],
    temperature=0.7,
)
print(resp.choices[0].message.content)

Directe aanroepen geven je streaming over SSE, tool calling, JSON-modus en elke sampling parameter zonder een tussenlaag. Open WebUI is de betere keuze als je een chatinterface voor mensen wilt, met geschiedenis, accounts en presets. Een script is de betere keuze voor batchwerk. De API produceert alleen tekst: hij rendert geen video, afbeeldingen of audio, dus voor een video-project levert het de geschreven delen zoals scripts en prompts voor andere tools. De video pipeline pagina gaat daarover.

Een snelle beslissingsgids

• Je wilt een chatvenster voor jezelf of een team: draai Open WebUI en voeg de outbound-verbinding toe.
• Je wilt dat scripts Open WebUI-voorkeuren of accounts hergebruiken: gebruik de inbound-API met een Open WebUI-sleutel.
• Je wilt batch tekstgeneratie: roep de model API direct aan met de OpenAI SDK en sla de extra laag over.
• Je wilt afbeeldingen of stem: noch Open WebUI noch deze tekst-API zullen ze zelf produceren. Verbind aparte tools voor die stap.

Welk pad je ook kiest, de feiten aan de modelkant blijven hetzelfde: een contextvenster van 100.000 tokens gedeeld door prompt en antwoord, tool calling en JSON-modus beschikbaar, en een harde regel tegen seksuele inhoud die minderjarigen betreft.

Beveiligingstips voor het blootstellen van de API's

Behandel beide sleutels als geheimen. De Open WebUI-sleutel geeft wat de aanmakende gebruiker kan doen binnen je instantie; de model-API-sleutel verbruikt je prepaid tegoed. Plak geen van beide in client-side code of publieke repositories.

• Zet Open WebUI achter HTTPS als het bereikbaar is buiten je eigen machine.
• Maak aparte Open WebUI-sleutels per script aan, zodat je er één kunt intrekken zonder de anderen te breken.
• Draai de modelsleutel rond als deze ooit in een log of screenshot verschijnt.
• Houd de X-Balance-USD response header op de backend in de gaten om de uitgave per aanroep te zien.

Op het gebied van privacy worden prompts die naar deze API worden gestuurd, niet gebruikt voor training. Open WebUI zelf slaat chatgeschiedenis op in zijn eigen database op je server, dus je hostingkeuzes bepalen wie dat kan lezen.

Wat het kost om deze opstelling te draaien

Open WebUI is gratis software die je host; je kosten zijn de server plus de tokens. Tokens worden gefactureerd tegen $0,15 per 1M input en $0,50 per 1M output, van prepaid tegoed met geen abonnement. Neem een chatbeurt met 3.000 input tokens en 500 output tokens: 3.000 x $0,15 / 1M = $0,00045 voor input en 500 x $0,50 / 1M = $0,00025 voor output, een totaal van $0,0007. Duizend zulke beurten kosten $0,70.

Opwaarderingen zijn elk geheel bedrag van $20 tot $500, met +5% vanaf $50, +10% vanaf $100 en +15% vanaf $200. Betaling is via crypto, USDT op TRC20 of USDC op Base. Mislukte of geweigerde verzoeken worden niet in rekening gebracht, en tegoed verloopt nooit. Nieuwe gebruikers kunnen een $0,50 proefbedrag claimen voor 7 dagen met één klik en zonder betalingsgegevens. Zie de prijzen pagina voor het volledige beeld.

Een herinnering over inhoud: het model is afgestemd op het beantwoorden zonder inhoudelijke weigeringen voor wettelijk gebruik door volwassenen, en seksuele inhoud die minderjarigen betreft is nooit toegestaan.

Meer handleidingen

• Ongecensureerd LLM API voor NSFW-video pipelines