Dokumentation

Chatbox

Chatbox teilt den Endpunkt in Host und Pfad auf und trägt den Pfad für Sie ein. Der Host ist daher der Ursprung — /v1 dort einzutragen, ist der typische Fehler, zu dem dieser Client verleitet.

Einen Anbieter vom Typ OpenAI API Compatible hinzufügen und als API Host die Service-Stamm-URL festlegen — Chatbox hängt /v1/chat/completions selbst an.

Chatbox-Einstellungen

Settings → Model Providers → Add

  API 提供方名称 / Provider name   Kunavo
  API 类型 / Type                 OpenAI API 兼容 (OpenAI API compatible)
  API 密钥 / API Key              sk-kn-...
  API 主机 / API Host             https://api.kunavo.com
  API 路径 / API Path             (leave empty → /v1/chat/completions)
  Model                           claude-sonnet-5

Der API Host ist https://api.kunavo.com, ohne /v1. Chatbox hat ein separates Feld API Path, dessen Standardwert /v1/chat/completions ist. Ein Host, der bereits mit /v1 endet, führt daher zu Anfragen an /v1/v1/chat/completions. Lassen Sie den Pfad leer, sofern Sie nicht sicher wissen, dass Sie etwas anderes benötigen.

Die Auswahlliste für den Anbietertyp in Chatbox bezeichnet ein Übertragungsformat. Wählen Sie OpenAI API 兼容 (OpenAI API-kompatibel) und geben Sie anschließend eine Claude-Modell-ID ein — die ID wird am Endpunkt aufgelöst, daher stehen die beiden Angaben nicht im Widerspruch.

Noch kein Schlüssel? Erstelle ein Kunavo-Konto, erstelle einen Schlüssel (er beginnt mit sk-kn-) und füge ab $10 Guthaben hinzu – Aufrufe werden aus diesem Guthaben bezahlt, fehlgeschlagene Aufrufe werden nicht berechnet. Das Dashboard öffnet anschließend die Chatbox-Einrichtung.

Schritt für Schritt

Erstellen Sie unter /app/keys einen Schlüssel und kopieren Sie ihn — er wird nur einmal angezeigt.
Öffnen Sie Einstellungen → Modellanbieter und klicken Sie auf Hinzufügen.
Geben Sie dem Anbieter einen Namen, setzen Sie den Typ auf OpenAI API 兼容 und fügen Sie den API-Schlüssel ein.
Setzen Sie API 主机 / API Host auf https://api.kunavo.com und lassen Sie API 路径 / API Path leer.
Fügen Sie die gewünschten Modell-IDs hinzu, speichern Sie und starten Sie ein Gespräch.

Abgeglichen mit Chatbox-Anleitung zur Anbieterkonfiguration am 6. September 2026. Einstellungen von Drittanbietern können sich ändern; wenn ein Feldname hier nicht mehr mit deiner Ansicht übereinstimmt, ist diese Seite maßgeblich, nicht diese hier.

Vor dem Debugging des Clients prüfen

Eine Anfrage klärt, ob der Fehler am Endpunkt, am Schlüssel oder an der Konfigurationsdatei liegt. Wenn diese Anfrage JSON zurückgibt, funktionieren dieselbe Basis-URL und derselbe Schlüssel in Chatbox.

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

Welche Modell-ID in das Feld gehört

Jedes Textmodell ist über eine Modell-ID erreichbar – die aktuelle Liste findest du unter GET /v1/models, den Katalog mit Preisen auf der Modellseite. Die Tarife sind USD pro 1 Mio. Token, Eingabe / Ausgabe.

Modell-ID	Kunavo: Ein- und Ausgabe	Wo es in Chatbox hineinpasst
`claude-sonnet-5`	$1.40 / $7.00	das standardmäßige Gesprächsmodell
`claude-haiku-4-5`	$0.70 / $3.50	kurze Gespräche, bei denen sowohl Latenz als auch Preis zählen
`claude-opus-5`	$3.50 / $17.50	ein zweiter Anbietereintrag für schwierige Fragen
`gpt-5-6-terra`	$0.70 / $4.20	eine andere Modellfamilie mit demselben Schlüssel

Die Abrechnung erfolgt pro Token aus einem vorausbezahlten Guthaben ohne Monatsgebühr – siehe Abrechnung. Bei wiederholtem Kontext – dem Großteil dessen, was ein Editor oder Chat-Client sendet – verändert Prompt-Caching die Rechnung stärker als die Modellwahl.

Häufig gestellte Fragen

Was sollte als API Host für einen OpenAI-kompatiblen Endpunkt in Chatbox eingetragen werden?

Der Ursprung ohne Pfad — zum Beispiel https://api.example.com. Chatbox hat ein separates Feld API Path, dessen Standardwert /v1/chat/completions ist und das laut Dokumentation im Allgemeinen nicht ausgefüllt werden muss. /v1 kommt also aus dem Pfad, nicht aus dem Host. Ein Host mit /v1 am Ende führt zu Anfragen an /v1/v1/chat/completions und einem 404-Fehler.

Wie füge ich in Chatbox einen benutzerdefinierten Modellanbieter hinzu?

Öffnen Sie Einstellungen → Modellanbieter und klicken Sie auf Hinzufügen. Geben Sie dem Anbieter anschließend einen Namen, wählen Sie den API-Typ „OpenAI-kompatibel“, fügen Sie den API-Schlüssel ein, setzen Sie API Host auf den Ursprung des Endpunkts und lassen Sie API Path leer. Fügen Sie die gewünschten Modell-IDs hinzu und speichern Sie. Der Anbieter erscheint dann in jeder Unterhaltung in der Modellauswahl.

Kann Chatbox mit Claude-Modellen kommunizieren?

Ja, über einen OpenAI-kompatiblen Endpunkt, der sie bereitstellt. Chatbox sendet die eingegebene Modell-ID an den konfigurierten Host. Daher wird eine Claude-ID dort aufgelöst, nicht in Chatbox, und die App benötigt keine eigenen Anthropic-Zugangsdaten. Die Auswahl des Anbietertyps legt das Übertragungsformat fest, nicht den Anbieter.

Wann sollte ich Chatboxs API Path ausfüllen?

Nur wenn der Endpunkt Chat Completions nicht unter /v1/chat/completions bereitstellt. Das Feld ist für Gateways mit ungewöhnlichem Routing vorgesehen. Bei einem standardmäßigen OpenAI-kompatiblen Dienst ist es richtig, das Feld leer zu lassen. Die Eingabe eines Pfads ist eine häufige Ursache für 404-Fehler, die wie ein Authentifizierungsproblem aussehen.