Dokumentation

LobeChat

Eine selbst gehostete LobeChat-Instanz benötigt drei Umgebungsvariablen, um Kunavo anzusprechen: einen Schlüssel, eine Proxy-URL und die Liste der Modell-IDs, die in der Auswahlliste erscheinen sollen.

Setzen Sie OPENAI_API_KEY auf Ihren Kunavo-sk-kn-…-Schlüssel, OPENAI_PROXY_URL auf https://api.kunavo.com/v1 und tragen Sie die gewünschten IDs in OPENAI_MODEL_LIST ein. Claude und GPT erscheinen dann in derselben Auswahlliste und verwenden dasselbe Guthaben.

.env

OPENAI_API_KEY=sk-kn-...
OPENAI_PROXY_URL=https://api.kunavo.com/v1

# LobeChat only shows models it knows about, so name the ones you want.
OPENAI_MODEL_LIST=claude-sonnet-5,claude-haiku-4-5,claude-opus-5,gpt-5-6-terra

Das Suffix /v1 gehört in OPENAI_PROXY_URL. LobeChat leitet Anfragen an die angegebene URL weiter, statt den OpenAI-Pfad selbst wiederherzustellen. Deshalb enthält der Standardwert in der Dokumentation von LobeChat unter .env.example auch das Suffix: https://api.openai.com/v1.

Schritt für Schritt

Erstellen Sie unter /app/keys einen Schlüssel und kopieren Sie ihn — er wird nur einmal angezeigt.
Fügen Sie die drei Variablen der Umgebung Ihrer Bereitstellung hinzu: der Datei .env bei einer manuellen Installation oder dem Block environment für Docker.
Starten Sie den Container neu, damit die neuen Umgebungsvariablen übernommen werden.
Öffnen Sie LobeChat, starten Sie eine Sitzung und wählen Sie eine der IDs aus, die Sie in OPENAI_MODEL_LIST eingetragen haben.

docker-compose.yml

services:
  lobe-chat:
    image: lobehub/lobe-chat
    ports:
      - "3210:3210"
    environment:
      OPENAI_API_KEY: sk-kn-...
      OPENAI_PROXY_URL: https://api.kunavo.com/v1
      OPENAI_MODEL_LIST: claude-sonnet-5,claude-haiku-4-5,gpt-5-6-terra

Die Referenz von LobeChat zu diesen Variablen finden Sie auf der Seite Umgebungsvariablen für Modell-Provider.

Prüfen Sie dies, bevor Sie den Container debuggen

Eine Anfrage klärt, ob der Fehler am Endpunkt, am Schlüssel oder an der Modellliste von LobeChat liegt. Wenn diese Anfrage eine JSON-Liste mit Modell-IDs zurückgibt, funktionieren dieselbe URL und derselbe Schlüssel. Ist die Auswahlliste danach leer, liegt es an OPENAI_MODEL_LIST und nicht am Endpunkt.

# Settles whether a failure is the endpoint, the key, or LobeChat.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Welche IDs sollten eingetragen werden?

Jedes Textmodell auf Kunavo kann in OPENAI_MODEL_LIST eingetragen werden. Die vollständige Liste finden Sie auf der Modellseite; sie wird live von GET /v1/models abgerufen. Die Preise sind in USD pro 1M Tokens angegeben, Eingabe / Ausgabe.

Modell-ID	Kunavo: Ein- und Ausgabe	Einsatzbereich
`claude-haiku-4-5`	$0.70 / $3.50	Das günstigste Claude-Modell – für lange Chatsitzungen, bei denen die Kosten pro Gesprächsrunde entscheidend sind
`claude-sonnet-5`	$1.40 / $7.00	Das standardmäßige Verhältnis von Qualität und Preis
`claude-opus-5`	$3.50 / $17.50	Claude-Modell der höchsten Qualitätsstufe
`gpt-5-6-terra`	$0.70 / $4.20	Derselbe Schlüssel, eine andere Modellfamilie – kein zweiter Provider muss eingerichtet werden

Ein Chat-Client sendet bei jedem Gesprächsschritt den gesamten bisherigen Verlauf erneut. Daher steigen die Tokenkosten in LobeChat mit der Länge der Sitzung, statt pro Nachricht gleich zu bleiben. Bei diesem Muster ist Prompt-Caching der wichtigste Hebel. Die Abrechnung erfolgt pro Token von einem vorausbezahlten Guthaben, ohne monatliche Gebühr. Ein Monat ohne Nutzung kostet also nichts. Einzelheiten finden Sie unter Abrechnung.

Häufig gestellte Fragen

Wie richte ich LobeChat auf einen benutzerdefinierten OpenAI-kompatiblen Endpunkt aus?

Setzen Sie in der Umgebung Ihrer Bereitstellung OPENAI_PROXY_URL auf die Basis-URL des Endpunkts und OPENAI_API_KEY auf Ihren Schlüssel. Für Kunavo lautet die URL https://api.kunavo.com/v1. Im eigenen Beispielwert für diese Variable in der .env.example von LobeChat steht https://api.openai.com/v1. Das zeigt, dass das Suffix /v1 zum Wert gehört und nicht automatisch angehängt wird.

Warum erscheint mein benutzerdefiniertes Modell nicht in der Modellliste von LobeChat?

LobeChat zeigt die Modelle an, über die es informiert wurde, und nicht alle Modelle, die der Endpunkt bereitstellen kann. Eine Modell-ID, die nicht in der Liste steht, ist daher unsichtbar, selbst wenn der Endpunkt darauf antwortet. Tragen Sie die IDs als durch Kommas getrennte Liste in OPENAI_MODEL_LIST ein. Die Dokumentation von LobeChat definiert für diese Variable außerdem eine Präfixsyntax: Ein vorangestelltes + fügt ein Modell hinzu, ein vorangestelltes - blendet eines aus, und model_name=display_name benennt eines in der Auswahlliste um.

Kann LobeChat Claude-Modelle über den OpenAI-Provider verwenden?

Ja, wenn sie über einen OpenAI-kompatiblen Endpunkt bereitgestellt werden. LobeChats OpenAI-Provider sendet die Modell-ID an die URL, die in OPENAI_PROXY_URL angegeben ist. Eine Claude-ID wird also am Gateway aufgelöst und nicht innerhalb von LobeChat; Anthropic-Zugangsdaten sind nicht erforderlich. Bei Kunavo verwenden Claude- und GPT-IDs denselben Schlüssel. Um eine Modellfamilie hinzuzufügen, ergänzen Sie daher eine ID in OPENAI_MODEL_LIST.

Funktioniert die Bildgenerierung von LobeChat über einen benutzerdefinierten Endpunkt?

Das hängt davon ab, welche Routen der Endpunkt implementiert, nicht von LobeChat. Der Chat-Provider benötigt /v1/chat/completions; die Bildgenerierung verwendet eine separate Route. Kunavo stellt Bild- und Videogenerierung über eigene Endpunkte bereit, die unter „images“ und „video“ dokumentiert sind. Das zuverlässige Vorgehen ist daher, LobeChat für den Chat zu verwenden und die Medienendpunkte direkt aufzurufen, statt davon auszugehen, dass eine einzelne Provider-Einstellung beides abdeckt.