Přeskočit na hlavní obsah

Veřejné API

Libre WebUI zpřístupňuje API kompatibilní s OpenAI, takže existující sady SDK, editory a skripty mohou vaši instanci používat pouhou změnou základní adresy URL.

Ověřování​

Vytvořte token API s omezeným rozsahem v Settings → Account → API tokens (tokeny používají předponu lwk_ a ukládají se jako hash). Rozhraní /v1 vyžaduje rozsah chat. Token předejte jako běžný bearer klíč:

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

Požadavky podléhají limitu pro jednotlivý token (600 požadavků za minutu) a společnému limitu chatu.

Koncové body​

Koncový bodÚčel
GET /v1/modelsDostupné modely (místní i z pluginů poskytovatelů)
POST /v1/chat/completionsBezstavové dokončení chatu, streamované či nikoli

POST /v1/chat/completions přijímá známé tělo: model, messages (system/user/assistant; multimodální textové části se zploští), stream, temperature, top_p, max_tokens/max_completion_tokens, seed a stop. Streamované odpovědi tvoří rámce SSE chat.completion.chunk ukončené data: [DONE]. Nestramované odpovědi obsahují počty tokenů v usage, pokud je poskytovatel vykáže.

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

Záměrné hranice​

Rozhraní /v1 poskytuje bezstavovou inferenci: nikdy nevytváří chaty, nemění znalostní bázi a nespouští nástroje. Stavové konverzace s trvalými událostmi, které lze znovu přehrát, rušením podle identity, idempotentním zařazením do fronty a nativní smyčkou nástrojů jsou v nativním událostním API /api/chat. Stejné tokeny ho mohou volat s rozsahem chat. Jiné role než system/user/assistant (například tool) se odmítnou, nikoli potichu přijmou.

Související dokumentace​