Ana içeriğe geç

Genel API

Libre WebUI, OpenAI ile uyumlu bir API sağlar; böylece mevcut SDK’ların, düzenleyicilerin ve betiklerin yalnızca temel URL’yi değiştirmesi yeterlidir.

Kimlik doğrulama​

Ayarlar → Hesap → API Belirteçleri bölümünde kapsamlı bir API belirteci oluşturun (lwk_ önekli, karma olarak saklanır). /v1 için chat kapsamı gerekir. Belirteci Bearer şemasıyla iletin:

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

Sınır, belirteç başına dakikada 600 istektir; sohbetin ortak sınırı da ayrıca uygulanır.

Uç noktalar​

Uç noktaAmaç
GET /v1/modelsKullanılabilir yerel ve sağlayıcı modelleri
POST /v1/chat/completionsAkışlı veya akışsız, durumsuz sohbet

POST /v1/chat/completions; model, messages (system/user/assistant), stream, temperature, top_p, max_tokens/max_completion_tokens, seed ve stop alanlarını kabul eder. Akış, data: [DONE] satırına kadar SSE chat.completion.chunk olayları gönderir; akışsız yanıt, sağlayıcı bildirdiyse usage alanını içerir.

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

Tasarlanmış sınırlar​

/v1, durumsuz çıkarım içindir: sohbet oluşturmaz, bilgi tabanını değiştirmez ve araç çalıştırmaz. Durumlu konuşmalar, kalıcı olaylar, kimliğe bağlı iptal, eşgüçlü kuyruk ve yerel araç döngüsü /api/chat altında bulunur; aynı belirteçle chat kapsamı üzerinden erişilebilir. system/user/assistant dışındaki roller, örneğin tool, reddedilir.

İlgili belgeler​