Dokumentation

TypingMind

TypingMind hat bei benutzerdefinierten Modellen kein Feld für eine Basis-URL. Stattdessen wird jedes Modell als separater Eintrag mit vollständiger Endpunkt-Route, Modell-ID, Kontextlänge und einem manuell als Header eingetragenen Schlüssel hinzugefügt. Hier sehen Sie den Eintrag für Kunavo und erfahren, warum er jetzt im Browser funktioniert, obwohl das vor einem Monat noch nicht der Fall war.

Models → Add custom model: die vollständige Endpoint URL https://api.kunavo.com/v1/chat/completions, ein Authorization-Header mit Bearer und deinem Schlüssel, die Model ID und ihre Kontextlänge — ein Eintrag pro Modell, direkt aus dem Browser aufgerufen.

typingmind.com — Add Custom Model

Models  →  Add custom model  →  Create Manually

Name                    Kunavo · Claude Sonnet 5
Model ID                claude-sonnet-5
Context Length          1000000

Authentication tab
  API Type              OpenAI Chat Completions API
  Endpoint URL          https://api.kunavo.com/v1/chat/completions
  Authentication Type   API Key via HTTP Header
    Header Key          Authorization
    Header Value        Bearer sk-kn-...

Capabilities tab        tick only what you have checked (see below)
Request Options tab     leave "Route requests via TypingMind Cloud" off

                        → Test & Save

Endpoint URL ist die vollständige Route und keine Basis-URL. Beim API-Typ OpenAI Chat Completions ist das https://api.kunavo.com/v1/chat/completions. TypingMind fügt nichts an – in den eigenen ausgearbeiteten Beispielen werden vollständige Routen wie https://api.minimax.io/v1/chat/completions eingefügt. Mit https://api.kunavo.com/v1 allein wird die Chat-Anfrage daher an einen nicht vorhandenen Pfad gesendet.

Die Anfrage läuft über Ihren Browser, und das funktioniert jetzt mit Kunavo. Laut TypingMind-Dokumentation werden Anfragen „direkt vom Browser“ gesendet. Deshalb muss der Endpunkt den Ursprung der Seite zulassen. Kunavos API wurde am 29. September 2026 um CORS-Header ergänzt. Am 1. Oktober 2026 lieferte eine von der Seite typingmind.com gesendete Anfrage eine lesbare Antwort mit access-control-allow-origin: * zurück, und zwar von /v1/chat/completions, /v1/messages und /v1/models. Für diesen Endpunkt benötigen Sie die Option Route requests via TypingMind Cloud nicht.

Was getestet wurde und was nicht. Die Feldbezeichnungen oben wurden am 1. Oktober 2026 in der aktiven App abgelesen. Die ursprungsübergreifende Anfrage wurde von dieser Seite aus mit absichtlich ungültigem Schlüssel gesendet. Damit ist nachgewiesen, dass der Browser TypingMind Kunavo erreichen und die Antwort lesen lässt. Über TypingMind wurde mit einem echten Schlüssel weder eine Completion noch ein Stream oder Toolaufruf an Kunavo gesendet. Auch die Schaltfläche Test & Save wurde nicht gedrückt. Ihr eigener Klick auf Test & Save ist die erste Ende-zu-Ende-Prüfung.

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 TypingMind-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 TypingMind im linken Seitenbereich Models und klicken Sie auf Add custom model. Wählen Sie Create Manually. Import JSON und Import OpenRouter sind für andere Quellen vorgesehen.
Füllen Sie Name (beliebiger Wert), Model ID (genau so, wie sie auf GET /v1/models aufgeführt ist, zum Beispiel claude-sonnet-5) und Context Length aus. Im Formular ist 128000 vorausgefüllt. Tragen Sie das tatsächliche Kontextfenster des Modells von der Modellseite ein, denn TypingMind verwendet diesen Wert, um zu bestimmen, wie viel Gesprächsverlauf gesendet wird.
Wählen Sie im Tab Authentication unter API Type die Option OpenAI Chat Completions API aus, fügen Sie die vollständige Endpoint URL ein, setzen Sie Authentication Type auf API Key via HTTP Header und geben Sie unter Header Key Authorization und unter Header Value Bearer sk-kn-... ein — das Wort Bearer, ein Leerzeichen, dann den Schlüssel.
Aktivieren Sie unter Capabilities die Funktionen entweder manuell oder lassen Sie Auto check capabilities on save aktiviert — laut Formular werden beim Speichern „einige Testanfragen“ gesendet, wodurch eine Handvoll Token berechnet werden. Optional können Sie unter Pricing die Preise pro Million aus der folgenden Tabelle eintragen, damit die Kostenanzeige von TypingMind Ihrer Rechnung entspricht. Klicken Sie anschließend auf Test & Save.
Wiederholen Sie den Vorgang für jedes Modell. Für einen benutzerdefinierten Endpunkt gibt es keinen Eintrag auf Anbieterebene: Claude Sonnet, Claude Haiku und ein GPT-Modell sind drei separate benutzerdefinierte Modelle mit derselben Endpoint URL und demselben Header.

Abgeglichen mit TypingMind-Modell-Dokumentation am 1. Oktober 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 TypingMind-Preise und API-Kosten.

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

# 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 TypingMind hineinpasst
`claude-sonnet-5`	$1.40 / $7.00	Das Alltagsmodell für lange Chats und Dokumente — Kontextlänge 1000000
`claude-haiku-4-5`	$0.70 / $3.50	Ein günstigeres Zweitmodell für schnelle Fragen und Titel — Kontextlänge 200000
`claude-opus-5`	$3.50 / $17.50	Anspruchsvolle Schlussfolgerungen in einem Chat, gezielt eingesetzt — Kontextlänge 1000000

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.

Die anderen drei API-Typen

Das Dropdown-Menü API Type im aktuellen Formular bietet OpenAI Chat Completions API, OpenAI Responses API, Claude Messages API und Gemini API. Kunavo unterstützt die ersten drei; für jeden Typ muss die vollständige Route unter Endpoint URL angegeben werden.

Claude Messages API — Endpoint URL https://api.kunavo.com/v1/messages. Das Claude-Format-Beispiel von TypingMind verwendet einen Header x-api-key; Kunavo akzeptiert für diese Route entweder diesen oder Authorization: Bearer. Kunavo stellt über diese Route nur IDs aus der Claude-Familie bereit.
OpenAI Responses API — Endpoint URL https://api.kunavo.com/v1/responses, derselbe Bearer-Header. Die Dokumentation von TypingMind enthält kein ausgearbeitetes Beispiel für diesen Typ, daher ist das vollständige Routenformat aus den anderen drei abgeleitet und nicht wörtlich übernommen.
Gemini API — nicht für diesen Endpunkt. Sie erwartet das native Anfrageformat von Google; Gemini-Modelle lassen sich stattdessen über den Typ Chat Completions aufrufen.

Dies ist nicht die TypingMind API

Mit „TypingMind API“ ist üblicherweise die REST-API einer TypingMind-Teams-Instanz (custom.typingmind.com) gemeint, die diese Chat-Instanz verwaltet. Sie verkauft keine Modell-Token und hat nichts mit dieser Einrichtung zu tun. Bei einem benutzerdefinierten Modell ruft TypingMind einfach den Endpunkt eines anderen Anbieters mit einem von Ihnen bereitgestellten Schlüssel auf.

Zwei getrennte Rechnungen

Die TypingMind-Lizenz bezahlt die App. Jede Nachricht, die Sie über ein benutzerdefiniertes Modell senden, wird pro Token von demjenigen abgerechnet, dem der im Header angegebene Schlüssel gehört — hier Kunavo, aus einem vorausbezahlten Guthaben. Die Lizenzstufen und die Kosten eines Chat-Monats zu diesen Preisen werden unter TypingMind-Preise und API-Kosten erläutert.

Wenn Test & Save fehlschlägt

404 mit „POST /v1 ist die Basis-URL, kein Endpunkt“ (oder „Not found: /“, wenn die URL beim Host endet) — in der Endpoint URL fehlt die Route. Sie muss mit /v1/chat/completions enden (oder für diese Typen mit /v1/messages, /v1/responses). Vor dem 1. Oktober 2026 gaben beide Fälle eine HTML-Seite zurück.
404 mit „No such endpoint“ — die Route ist falsch geschrieben, zum Beispiel /v1/chat/completion. Dieselbe Meldung nennt die nächstgelegene von Kunavo bereitgestellte Route.
404 mit „Not found: /chat/completions. Kunavo's API lives under /v1“ — die Route ist vorhanden, aber /v1 fehlt: Die Endpoint URL lautet https://api.kunavo.com/chat/completions. Fügen Sie vor der Route /v1 ein. (Überprüft am 1. Oktober 2026; vor diesem Datum gab derselbe Fehler eine HTML-Seite zurück.)
401 „Missing or invalid API key“ — der Header ist falsch: Header Key muss Authorization lauten und der Wert mit Bearer beginnen, oder der Schlüssel wurde widerrufen.
Fehler, dass ein Modell nicht verfügbar ist — die Model ID ist nicht so geschrieben, wie GET /v1/models sie aufführt. IDs werden kleingeschrieben und mit Bindestrichen getrennt.
Netzwerk- oder CORS-Fehler in der Browserkonsole — prüfen Sie, ob die Endpoint URL https://api.kunavo.com ist und nicht die Website-Domain; der API-Host sendet die CORS-Header.

Häufig gestellte Fragen

Wie füge ich in TypingMind ein benutzerdefiniertes Modell mit meinem eigenen API-Schlüssel hinzu?

Öffnen Sie in der linken Seitenleiste Models und klicken Sie auf Add custom model, dann auf Create Manually. Geben Sie einen Namen, die genaue Model ID und die Context Length an. Wählen Sie im Tab Authentication den API-Typ aus, fügen Sie die vollständige Endpoint URL ein — bei einem OpenAI-kompatiblen Anbieter endet sie mit /v1/chat/completions — und setzen Sie Authentication Type auf API Key via HTTP Header. Geben Sie bei Header Key Authorization und bei Header Value Bearer gefolgt von Ihrem Schlüssel ein. Klicken Sie auf Test & Save. Diese Bezeichnungen wurden am 1. Oktober 2026 in der aktuellen App abgelesen; die ältere Dokumentation von TypingMind beschreibt denselben Ablauf mit leicht abweichender Wortwahl.

Benötigt TypingMind eine Basis-URL oder den vollständigen Endpunkt?

Den vollständigen Endpunkt. Das Feld heißt Endpoint URL, und alle ausgearbeiteten Beispiele in der Dokumentation von TypingMind fügen eine vollständige Route ein, etwa https://api.minimax.io/v1/chat/completions oder eine Azure-URL, die mit /anthropic/v1/messages endet. TypingMind hängt keinen Pfad an. Eine Basis-URL wie https://api.kunavo.com/v1 allein leitet die Anfrage daher an eine nicht vorhandene Route weiter und gibt einen 404 zurück.

Kann TypingMind Kunavo direkt aus dem Browser aufrufen?

Ja, seit dem 29. September 2026, als Kunavos API CORS-Header zu senden begann. TypingMind stellt Modellanfragen direkt von der Webseite aus, daher muss der Endpunkt den Ursprung dieser Seite zulassen. Am 1. Oktober 2026 gaben Anfragen von typingmind.com an Kunavos /v1/chat/completions, /v1/messages und /v1/models access-control-allow-origin: * mit einem lesbaren Antworttext zurück. Diese Anfragen verwendeten absichtlich einen ungültigen Schlüssel. Sie belegen also, dass der Browserzugriff möglich ist, nicht, dass ein vollständiger Chat durchgeführt wurde.

Benötige ich den Proxy von TypingMind oder das Routing über TypingMind Cloud?

Für Kunavo nicht. Im Tab Request Options gibt es den Schalter Route requests via TypingMind Cloud, der laut Formular Anfragen über den Server von TypingMind leitet, um Browser-CORS-Beschränkungen zu umgehen. Kunavos API erlaubt Browseraufrufe bereits. Wenn Sie die Option deaktiviert lassen, wird die Anfrage direkt von Ihrem Browser an den Endpunkt gesendet.

Hat Kunavo TypingMind von Anfang bis Ende getestet?

Nicht mit einem funktionierenden Schlüssel. Am 1. Oktober 2026 wurden das aktuelle Formular Add Custom Model und eine Browseranfrage von der Seite typingmind.com an Kunavo mit ungültigem Schlüssel überprüft; sie kam mit CORS-Headern und lesbarem Inhalt zurück. Über TypingMind wurde keine Completion, Streaming-Antwort oder Tool-Aufruf an Kunavo ausgeführt, und die Schaltfläche Test & Save wurde nicht betätigt. Betrachten Sie Ihren eigenen Test & Save-Vorgang und die erste Nachricht als Ende-zu-Ende-Prüfung.