Ugrás a fő tartalomra

Nyilvános API

A Libre WebUI OpenAI-kompatibilis API-t biztosít, így a meglévő SDK-k, szerkesztők és szkriptek csak az alap-URL módosításával használhatják a példányt.

Hitelesítés​

Hozzon létre hatókörös API-tokent a Settings → Account → API tokens alatt (lwk_ előtag, hashként tárolva). A /v1 felülethez chat hatókör kell. Bearer kulcsként adja át:

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

Tokenenként 600 kérés/perc és közös chatkorlát érvényes.

Végpontok​

VégpontCél
GET /v1/modelsHelyi és pluginmodellek
POST /v1/chat/completionsÁllapotmentes chat completion, streamelve vagy sem

A test elfogadja a model, messages (system/user/assistant; multimodális szöveg lapítva), stream, temperature, top_p, max_tokens/max_completion_tokens, seed, stop mezőket. A stream SSE chat.completion.chunk, végén data: [DONE]; a normál válasz usage értéket tartalmaz, ha a szolgáltató jelenti.

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

Szándékos határok​

A /v1 állapotmentes inferencia: nem hoz létre chatet, nem módosít tudásbázist és nem futtat eszközt. A tartós, visszajátszható események, identitáshoz kötött megszakítás, idempotens sor és natív eszközhurok a /api/chat API-ban található, ugyanazzal a chat hatókörrel. A system/user/assistant szerepeken kívüliek (pl. tool) elutasításra kerülnek.

Kapcsolódó dokumentáció​