Openbare API

Libre WebUI biedt een OpenAI-compatibele API, zodat bestaande SDK's, editors en scripts met alleen een wijziging van de basis-URL naar je instantie kunnen wijzen.

Verificatie

Maak een afgebakend API-token via Instellingen → Account → API-tokens (tokens gebruiken het voorvoegsel lwk_ en worden gehasht opgeslagen). Het /v1-oppervlak vereist het bereik chat. Geef het token door als gewone bearer-sleutel:

export OPENAI_BASE_URL="https://your-instance/v1"
export OPENAI_API_KEY="lwk_..."

Verzoeken vallen onder de snelheidslimiet per token (600 verzoeken per minuut) en de gedeelde chatsnelheidslimiet.

Eindpunten

Eindpunt	Doel
GET /v1/models	Beschikbare modellen, lokaal en via providerplugins
POST /v1/chat/completions	Staatloze chatvoltooiing, met of zonder streaming

POST /v1/chat/completions accepteert de bekende body: model, messages (system/user/assistant; multimodale tekstdelen worden afgevlakt), stream, temperature, top_p, max_tokens/max_completion_tokens, seed en stop. Streamingantwoorden zijn SSE-frames van het type chat.completion.chunk, beëindigd met data: [DONE]; niet-streamingantwoorden bevatten tokenaantallen in usage wanneer de provider ze meldt.

curl "$OPENAI_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "llama3.2",
    "messages": [{"role": "user", "content": "One sentence on herons."}]
  }'

Bewuste grenzen

Het /v1-oppervlak is staatloze inferentie: het maakt nooit chats, raakt je kennisbank niet aan en voert geen tools uit. Gesprekken met status, duurzame herhaalbare gebeurtenissen, annulering op identiteit, idempotent in de wachtrij plaatsen en de eigen toolcyclus bevinden zich in de eigen gebeurtenis-API /api/chat. Dezelfde tokens kunnen die met het bereik chat aanroepen. Rollen anders dan system/user/assistant, bijvoorbeeld tool, worden geweigerd in plaats van stilzwijgend geaccepteerd.

Gerelateerde documentatie

• Verificatie — accounts, sessies en API-tokens
• Chattools — de eigen toolcyclus in de gebeurtenis-API