Zum Hauptinhalt springen

Öffentliche API

Libre WebUI stellt eine OpenAI-kompatible API bereit. Vorhandene SDKs, Editoren und Skripte können dadurch mit einer Änderung der Basis-URL auf deine Instanz zugreifen.

Authentifizierung​

Erstelle unter Einstellungen → Konto → API-Tokens ein API-Token mit begrenztem Umfang (Tokens verwenden das Präfix lwk_ und werden gehasht gespeichert). Die Oberfläche /v1 erfordert den Umfang chat. Übergib das Token als gewöhnlichen Bearer-Schlüssel:

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

Anfragen unterliegen der Rate-Limitierung des Tokens (600 Anfragen pro Minute) sowie dem gemeinsamen Chat-Limit.

Endpunkte​

EndpunktZweck
GET /v1/modelsVerfügbare Modelle (lokal oder über Anbieter-Plugins)
POST /v1/chat/completionsZustandslose Chat-Vervollständigung mit oder ohne Streaming

POST /v1/chat/completions akzeptiert den vertrauten Body: model, messages (system/user/assistant; multimodale Textteile werden abgeflacht), stream, temperature, top_p, max_tokens/max_completion_tokens, seed und stop. Streaming-Antworten bestehen aus SSE-Frames vom Typ chat.completion.chunk und enden mit data: [DONE]; Antworten ohne Streaming enthalten Token-Zahlen in usage, sofern der Anbieter sie meldet.

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."}]
  }'

Bewusste Grenzen​

Die /v1-Oberfläche bietet zustandslose Inferenz: Sie erstellt keine Chats, ändert deine Wissensbasis nicht und führt keine Werkzeuge aus. Zustandsbehaftete Unterhaltungen mit dauerhaften, wiederholbaren Ereignissen, identitätsbezogener Abbruchmöglichkeit, idempotenter Einreihung und der nativen Werkzeugschleife liegen in der nativen Ereignis-API /api/chat. Dieselben Tokens können sie mit dem Umfang chat aufrufen. Andere Rollen als system/user/assistant (beispielsweise tool) werden abgelehnt, nicht stillschweigend akzeptiert.

Verwandte Dokumentation​