TypingMind

Models → Add custom model : l’Endpoint URL complet https://api.kunavo.com/v1/chat/completions, un en-tête Authorization avec Bearer et votre clé, le Model ID et sa longueur de contexte — une entrée par modèle, appelée directement depuis votre navigateur.

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

Étape par étape

1. Créez une clé sur /app/keys et copiez-la — elle n’est affichée qu’une seule fois.
2. Dans TypingMind, ouvrez Models dans la barre latérale gauche et cliquez sur Add custom model. Restez sur Create Manually ; Import JSON et Import OpenRouter sont destinés à d’autres sources.
3. Renseignez Name (au choix), Model ID (exactement comme indiqué par GET /v1/models — par exemple claude-sonnet-5) et Context Length. Le formulaire préremplit 128000 ; définissez la véritable fenêtre de contexte du modèle à partir de la page des modèles, car TypingMind utilise ce nombre pour déterminer la quantité d’historique à envoyer.
4. Dans l’onglet Authentification, choisissez Type d’API = OpenAI Chat Completions API, collez l’URL complète du point de terminaison, définissez Type d’authentification sur Clé API via l’en-tête HTTP, puis saisissez Clé d’en-tête Authorization et Valeur de l’en-tête Bearer sk-kn-... — le mot Bearer, une espace, puis la clé.
5. Dans Fonctionnalités, cochez les options manuellement ou laissez Vérifier automatiquement les fonctionnalités lors de l’enregistrement activé : le formulaire indique qu’il envoie « quelques requêtes de test » lors de l’enregistrement, ce qui consomme quelques jetons facturés. Vous pouvez aussi renseigner Tarification avec les tarifs par million du tableau ci-dessous afin que l’affichage des coûts de TypingMind corresponde à votre facture. Cliquez ensuite sur Tester et enregistrer.
6. Répétez l’opération pour chaque modèle. Il n’existe pas d’entrée au niveau du fournisseur pour un point de terminaison personnalisé : Claude Sonnet, Claude Haiku et un modèle GPT sont trois modèles personnalisés distincts utilisant la même URL de point de terminaison et le même en-tête.

Vérifié avec Documentation des modèles de TypingMind le 1 octobre 2026. Les paramètres tiers évoluent ; si le nom d’un champ ne correspond plus à ce que vous voyez ici, cette page fait autorité, pas celle-ci.

Vérifiez avant de déboguer le client

Une requête suffit à déterminer si l’échec vient de l’endpoint, de la clé ou du fichier de configuration. Si cette requête renvoie du JSON, la même URL de base et la même clé fonctionnent dans 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-..."

Quel identifiant de modèle saisir dans le champ

Tous les modèles textuels sont accessibles sous forme d’identifiant de modèle — la liste à jour se trouve sur GET /v1/models, et le catalogue avec les prix sur la page des modèles. Les tarifs sont en USD par million de tokens, entrée / sortie.

Les trois autres types d’API

La liste déroulante Type d’API du formulaire en ligne propose OpenAI Chat Completions API, OpenAI Responses API, Claude Messages API et Gemini API. Kunavo prend en charge les trois premiers ; chacun nécessite sa propre route complète dans Endpoint URL.

• Claude Messages API — URL du point de terminaison : https://api.kunavo.com/v1/messages. L’exemple au format Claude de TypingMind utilise un en-tête x-api-key ; sur cette route, Kunavo accepte celui-ci ou Authorization: Bearer. Kunavo ne sert que les identifiants de la famille Claude sur cette route.
• OpenAI Responses API — URL du point de terminaison : https://api.kunavo.com/v1/responses, même en-tête Bearer. La documentation de TypingMind ne fournit aucun exemple complet pour ce type ; la forme avec route complète est donc déduite des trois autres, elle n’est pas citée.
• Gemini API — ne convient pas à ce point de terminaison. Elle attend le format de requête natif de Google ; accédez aux modèles Gemini via le type Chat Completions.

Il ne s’agit pas de l’API TypingMind

L’expression « API TypingMind » désigne généralement l’API REST d’une instance TypingMind Teams (custom.typingmind.com), qui gère cette instance de chat. Elle ne vend pas de jetons de modèle et n’a aucun lien avec cette configuration. Un modèle personnalisé signifie simplement que TypingMind appelle le point de terminaison d’un tiers avec une clé que vous fournissez.

Deux factures distinctes

La licence TypingMind paie l’application. Chaque message envoyé via un modèle personnalisé est facturé au jeton par le détenteur de la clé figurant dans l’en-tête — ici, Kunavo, à partir d’un solde prépayé. Les niveaux de licence et le coût d’un mois de chat à ces tarifs sont détaillés dans Tarification de TypingMind et coût de l’API.

Échec de « Tester et enregistrer »

• 404 avec « POST /v1 est l’URL de base, pas un point de terminaison » (ou « Not found: / » si l’URL s’arrête au nom d’hôte) — il manque la route dans l’URL du point de terminaison. Celle-ci doit se terminer par /v1/chat/completions (ou /v1/messages, /v1/responses pour ces types). Avant le 1er octobre 2026, ces deux cas renvoyaient une page HTML.
• 404 avec « No such endpoint » — la route est mal orthographiée, par exemple /v1/chat/completion. Le même message indique la route Kunavo la plus proche disponible.
• 404 avec « Not found: /chat/completions. Kunavo's API lives under /v1 » — la route existe, mais /v1 manque : l’URL du point de terminaison est https://api.kunavo.com/chat/completions. Ajoutez /v1 avant la route. (Vérifié le 1er octobre 2026 ; avant cette date, la même erreur renvoyait une page HTML.)
• 401 « Missing or invalid API key » — l’en-tête est incorrect : Header Key doit être Authorization et la valeur doit commencer par Bearer , ou bien la clé a été révoquée.
• Erreur de modèle indisponible — l’identifiant du modèle ne correspond pas exactement à celui indiqué par GET /v1/models. Les identifiants sont en minuscules et séparés par des traits d’union.
• Erreur réseau ou CORS dans la console du navigateur — vérifiez que l’URL du point de terminaison est https://api.kunavo.com et non le domaine du site web ; c’est l’hôte de l’API qui envoie les en-têtes CORS.