Dokumentation

ChatWise

ChatWise verwaltet jeden Anbieter mit denselben drei Feldern. Geben Sie dem benutzerdefinierten Anbieter einen Namen, eine API Base URL und einen Schlüssel, klicken Sie auf Fetch, und die Modellauswahl wird mit Claude- und GPT-IDs für ein gemeinsames Guthaben gefüllt.

Settings → Providers → „+“ erstellt einen benutzerdefinierten Anbieter aus drei Feldern — Provider name, API Base URL auf https://api.kunavo.com/v1 und API Key — danach lädt Fetch die Modellliste vom Endpunkt.

Settings → Providers → "+" → benutzerdefinierte Konfiguration

Provider name    Kunavo
API Base URL     https://api.kunavo.com/v1
                 field help: "Do NOT include /chat/completions in the URL"
API Key          sk-kn-...
Models           click Fetch to read the list from the endpoint,
                 or "+ New" and type an id by hand

"+ New" → Chat Models, the fields the docs name:
  Model ID       claude-sonnet-5
  Display Name   Claude Sonnet 5 (Kunavo)
  Capabilities   image input / reasoning flag — tick what the model does
  Context length as published on the models page

Die API Base URL behält ihr /v1. ChatWise zeigt die Regel direkt unter dem Feld an: „Fügen Sie /chat/completions NICHT in die URL ein“ — der Wert ist also der Root, an den die Route angehängt wird, nicht die Route selbst. Das einzige in der Dokumentation gezeigte gehostete Gateway mit ausgefülltem Feld hat dieselbe Form: https://aihubmix.com/v1. Eine Basis-URL, die die Route bereits enthält, führt zu einem 404, nicht zu einem Authentifizierungsfehler.

Diese Konfiguration ist eine Auswertung der eigenen Dokumentation von ChatWise mit Stand des unten angegebenen Datums. Kunavo hat ChatWise nicht mit seinem Endpunkt ausgeführt — weder eine Sitzung noch einen gestreamten Durchlauf oder einen Tool-Roundtrip. Dasselbe gilt für jeden Client dieser Gruppe. Eine veröffentlichte Einrichtungsseite ist kein Kompatibilitätstest. Halten Sie die derzeit funktionierende Route verfügbar, während Sie diese ausprobieren.

Kunavo bietet keine Einbettungs-, Text-zu-Sprache- oder Sprache-zu-Text-Modelle an. Daher unterstützt diese Route nur Chat und Bildgenerierung. Die Audioeingabefunktion von ChatWise ist davon unabhängig und bleibt unbeeinflusst: Sie hängt eine Audiodatei an eine Nachricht für ein Modell an, das diese akzeptiert, statt einen Transkriptionsdienst aufzurufen.

Wenn Sie dieses Feld ausfüllen, wird eine ChatWise-Erweiterung deaktiviert. Auf der Observability-Seite steht der Warnhinweis: „Stellen Sie sicher, dass die API Base URL des jeweiligen Anbieters leer ist, andernfalls wird Observability nicht aktiviert.“ Das Cloudflare AI Gateway-Dashboard und eine geänderte Basis-URL schließen sich pro Anbieter gegenseitig aus — ein Grund, Kunavo als eigenen Anbietereintrag hinzuzufügen, statt einen integrierten Eintrag zu bearbeiten.

Mehrere nicht miteinander verbundene Produkte werden unter dem Namen ChatWise angeboten. Diese Seite bezieht sich auf den Desktop-Client unter chatwise.app — für macOS, Windows und Linux — dessen Dokumentation unter docs.chatwise.app zu finden ist. Der öffentliche GitHub-Release-Feed endet lange vor der ausgelieferten Version. Wenn ein Screenshot hier nicht mit Ihrer Ansicht übereinstimmt, prüfen Sie daher den Download in der App selbst statt diesen Feed.

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 ChatWise-Einrichtung.

Schritt für Schritt

Erstellen Sie unter /app/keys einen Schlüssel und kopieren Sie ihn — er wird nur einmal angezeigt.
Öffnen Sie in ChatWise Einstellungen → Anbieter und klicken Sie auf „+“, um einen neuen Anbieter hinzuzufügen. Die Dokumentation bietet anschließend zwei Möglichkeiten: eine der integrierten Voreinstellungen auswählen oder eine benutzerdefinierte Konfiguration erstellen — Kunavo ist keine Voreinstellung, wählen Sie also die zweite Möglichkeit.
Füllen Sie wie oben Provider name, API Base URL und API Key aus. Im Formular wird kein Anbieter ausgewählt: Der Endpunkt löst die Modell-ID auf. Eine Claude-ID hinter einem OpenAI-kompatiblen Anbieter ist daher die vorgesehene Kombination und kein Widerspruch.
Klicken Sie in der Zeile Models auf Fetch. Laut ChatWise-Dokumentation kann das Programm die verfügbaren Modelle hinzufügen, wenn die API den Endpunkt /models unterstützt. Kunavo beantwortet GET /v1/models, daher wird die Liste automatisch gefüllt. + New ist für IDs vorgesehen, die Sie lieber selbst eingeben möchten.
Wenn Sie ein Modell manuell hinzufügen, nennt die Dokumentation die Felder: Model ID ist die API-Kennung, während Display Name nur eine Bezeichnung ist. Die ID muss daher genau mit dem Katalog übereinstimmen. Aktivieren Sie Capabilities und setzen Sie Context length passend zum Modell — diese Einstellungen geben dem Client vor, was er anbieten soll, nicht dem Endpunkt, was er tun soll.
Wählen Sie den Anbieter in der Modellauswahl aus und senden Sie eine Nachricht. Bei Bildmodellen ist laut ChatWise-Seite zur Bildgenerierung ein zusätzlicher Schritt erforderlich: Der Modelltyp muss auf Image gesetzt werden, bevor das Modell in der Bildauswahl erscheint.

Abgeglichen mit ChatWise-Seite zu benutzerdefinierten Anbietern am 21. 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.

Dies ist die Kurzfassung. Die vollständige Anleitung – Modellauswahl, Kosten einer tatsächlichen Sitzung und Fehlerszenarien – findest du in was ChatWise im tatsächlichen Betrieb kostet.

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 ChatWise.

# 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 ChatWise hineinpasst
`claude-sonnet-5`	$1.40 / $7.00	der alltägliche Chat — lange Gespräche, bei denen die Qualität pro Euro entscheidend ist
`claude-opus-5`	$3.50 / $17.50	die schwierige Frage, für die Sie sonst eine zweite App öffnen würden
`claude-haiku-4-5`	$0.70 / $3.50	Titel, Zusammenfassungen und Hintergrundaufrufe, die ein Chat-Client selbst ausführt
`gpt-5-6-terra`	$0.70 / $4.20	lange eingefügte Dokumente, bei denen das Kontextfenster den begrenzenden Faktor darstellt
`gpt-5-6-sol`	$2.00 / $12.00	eine Zweitmeinung aus einer anderen 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

Wie füge ich ChatWise einen benutzerdefinierten API-Anbieter hinzu?

Öffnen Sie die Einstellungen, gehen Sie zu Anbieter und klicken Sie auf „+“, um einen neuen Anbieter hinzuzufügen. Wählen Sie anschließend eine Voreinstellung oder erstellen Sie eine benutzerdefinierte Konfiguration. Füllen Sie Provider name, API Base URL und API Key aus und fügen Sie Modelle entweder über die Schaltfläche Fetch oder mit „+ New“ hinzu. In der Dokumentation von ChatWise zu benutzerdefinierten Anbietern wird beschrieben, wie sich damit beliebige OpenAI-kompatible oder Anthropic-kompatible KI-Dienste integrieren lassen. Ein Gateway ist also ein regulärer Anwendungsfall und keine Behelfslösung.

Muss die API Base URL von ChatWise mit /v1 enden?

Bei einem OpenAI-kompatiblen Endpunkt: ja. ChatWise weist unter dem Feld darauf hin, dass /chat/completions nicht in die URL gehört. Der Client hängt die Route selbst an, daher lautet der Wert der /v1-Root — https://api.kunavo.com/v1. Auch das einzige von ChatWise dokumentierte gehostete Gateway mit ausgefülltem Feld hat die Form https://aihubmix.com/v1. Wenn /v1 fehlt, kommt es zu einem 404-Fehler statt zu einem Authentifizierungsfehler. So lassen sich die beiden Fehlerarten am schnellsten unterscheiden.

Warum ruft Fetch in ChatWise keine Modelle ab?

Die Liste wird über die Route /models des Endpunkts mit dem eingegebenen Schlüssel abgerufen. Ein leeres Ergebnis deutet daher gewöhnlich auf den Schlüssel oder die Basis-URL hin, nicht auf einen leeren Katalog. Testen Sie dasselbe Wertepaar außerhalb der App mit einem einfachen curl-Aufruf an /v1/models: Eine JSON-Antwort bedeutet, dass das Problem im Anbieterformular liegt, ein 401 weist auf den Schlüssel hin und ein 404 auf die URL. Modelle können stattdessen jederzeit manuell über „+ New“ hinzugefügt werden. In diesem Fall muss die Model ID genau mit der Katalog-ID übereinstimmen.

Benötige ich ein ChatWise-Abonnement oder eine Lizenz, um meinen eigenen API-Schlüssel zu verwenden?

Das sind zwei getrennte Zahlungsverhältnisse. ChatWise ist ein Client, den Sie einmalig kaufen. Der Modellzugriff wird von der Stelle abgerechnet, die Ihren Schlüssel ausgibt — bei einem Kunavo-Schlüssel wird ein vorausbezahltes Guthaben pro Token belastet, ohne zusätzliche monatliche Gebühr. Die Anbieterkonfiguration wird nicht unter den Funktionen aufgeführt, die durch die kostenpflichtige Stufe freigeschaltet werden. Allerdings erklärt keine ChatWise-Seite ausdrücklich, dass die kostenlose Stufe einen benutzerdefinierten Anbieter hinzufügen kann. Prüfen Sie das daher während der Testphase, bevor Sie sich darauf verlassen.

Kann ChatWise Claude-Modelle ohne ein Anthropic-Konto verwenden?

Ja, über einen OpenAI-kompatiblen Anbietereintrag. Die Modell-ID wird am konfigurierten Endpunkt aufgelöst, nicht in ChatWise. Daher ist der dort verwendete Schlüssel die Zugangsinformation, die Sie benötigen. Das unterscheidet sich von der Anmeldung bei einem bestehenden Abonnement in der App, für die ChatWise ebenfalls wirbt: Dieser Weg hängt von den Bedingungen eines anderen Anbieters ab, während ein Schlüssel, den Sie selbst bezahlen, das nicht tut. Kunavo hat ChatWise nicht mit seinem Endpunkt ausgeführt. Betrachten Sie diese Seite daher als Konfigurationsbeschreibung, nicht als Testergebnis.