Documentation

ChatWise

ChatWise utilise les mêmes trois champs pour chaque fournisseur. Nommez le fournisseur personnalisé, indiquez une URL de base API et une clé, puis cliquez sur Fetch : le sélecteur de modèles se remplit avec des identifiants Claude et GPT, tous facturés sur le même solde.

Settings → Providers → « + » crée un fournisseur personnalisé à partir de trois champs — Provider name, API Base URL défini sur https://api.kunavo.com/v1 et API Key — puis Fetch lit la liste des modèles depuis l’endpoint.

Paramètres → Fournisseurs → « + » → configuration personnalisée

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

L’URL de base API conserve son /v1. ChatWise affiche la règle sous le champ : « N’incluez PAS /chat/completions dans l’URL » ; la valeur correspond donc à la racine sur laquelle la route s’appuie, et non à la route elle-même. La seule passerelle hébergée présentée avec ce champ renseigné dans sa documentation utilise la même forme, https://aihubmix.com/v1. Une URL de base qui contient déjà la route échoue avec une erreur 404, et non une erreur d’authentification.

Cette configuration est fondée sur la documentation de ChatWise à la date indiquée ci-dessous. Kunavo n’a pas testé ChatWise avec son point de terminaison — ni session, ni tour en diffusion continue, ni échange d’outil — et il en va de même pour tous les clients de cette famille. Une page de configuration publiée ne constitue pas un test de compatibilité. Gardez à disposition toute route qui fonctionne déjà pendant que vous essayez celle-ci.

Kunavo ne fournit aucun modèle d’intégration, de synthèse vocale ou de reconnaissance vocale ; cette route répond donc uniquement aux requêtes de conversation et de génération d’images. La fonctionnalité d’entrée audio de ChatWise est différente et n’est pas affectée : elle joint un fichier audio à un message destiné à un modèle qui l’accepte, au lieu d’appeler un service de transcription.

Renseigner ce champ désactive une extension de ChatWise. La page consacrée à l’observabilité avertit : « Assurez-vous que l’URL de base API du fournisseur concerné est vide, sinon l’observabilité ne sera pas activée. » Le tableau de bord Cloudflare AI Gateway et une URL de base redirigée ne peuvent pas être utilisés simultanément pour un même fournisseur ; c’est une raison d’ajouter Kunavo dans une entrée de fournisseur distincte plutôt que de modifier une entrée intégrée.

Plusieurs produits sans lien entre eux utilisent le nom ChatWise. Cette page concerne le client de bureau disponible sur chatwise.app — macOS, Windows et Linux — dont la documentation se trouve sur docs.chatwise.app. Le flux public des versions sur GitHub s’arrête bien avant la version actuelle ; si une capture d’écran ici ne correspond pas à ce que vous voyez, consultez le téléchargement proposé dans l’application.

Pas encore de clé ? Créez un compte Kunavo, créez une clé (elle commence par sk-kn-) et ajoutez un crédit à partir de 10 $ — les appels sont payés sur ce solde et les appels échoués ne sont pas facturés. Le tableau de bord s’ouvre ensuite sur la configuration ChatWise.

Étape par étape

Créez une clé sur /app/keys et copiez-la — elle n’est affichée qu’une seule fois.
Dans ChatWise, ouvrez Settings → Providers et cliquez sur « + » pour ajouter un fournisseur. La documentation propose ensuite deux options : choisir un préréglage intégré ou créer une configuration personnalisée. Kunavo n’étant pas un préréglage, choisissez la seconde option.
Renseignez Provider name, API Base URL et API Key comme indiqué ci-dessus. Aucun champ du formulaire ne sélectionne de fournisseur : le point de terminaison résout l’identifiant du modèle. Un identifiant Claude associé à un fournisseur compatible avec OpenAI est donc la combinaison prévue, et non une incompatibilité.
Sur la ligne Models, cliquez sur Fetch. Selon la documentation de ChatWise, si l’API prend en charge le point de terminaison /models, l’application peut ajouter automatiquement les modèles disponibles ; Kunavo répond à GET /v1/models, la liste se remplit donc automatiquement. Le bouton + New permet de saisir les identifiants de votre choix.
Si vous ajoutez un modèle manuellement, la documentation précise les champs : Model ID est l’identifiant API et Display Name est uniquement une étiquette ; l’identifiant doit donc correspondre exactement à celui du catalogue. Cochez Capabilities et définissez Context length en fonction du modèle — ces options indiquent au client ce qu’il doit proposer, et non ce que le point de terminaison doit faire.
Choisissez le fournisseur dans le sélecteur de modèles et envoyez un message. Pour les modèles d’image, la page de génération d’images de ChatWise indique une étape supplémentaire : le type de modèle doit être défini sur Image pour qu’il apparaisse dans le sélecteur d’images.

Vérifié avec Page des fournisseurs personnalisés de ChatWise le 21 septembre 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.

Voici la version courte. Le guide complet — choix du modèle, coût d’une session réelle et modes d’échec — se trouve dans le coût réel d’utilisation de ChatWise.

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

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.

Identifiant du modèle	Entrée / sortie sur Kunavo	Où cela s’intègre dans ChatWise
`claude-sonnet-5`	$1.40 / $7.00	la conversation quotidienne — les échanges longs où la qualité par dollar compte
`claude-opus-5`	$3.50 / $17.50	la question difficile pour laquelle vous ouvririez autrement une deuxième application
`claude-haiku-4-5`	$0.70 / $3.50	titres, résumés et appels en arrière-plan effectués automatiquement par un client de conversation
`gpt-5-6-terra`	$0.70 / $4.20	longs documents collés, où la fenêtre de contexte est la limite
`gpt-5-6-sol`	$2.00 / $12.00	un deuxième avis issu d’une autre famille, avec la même clé

La facturation se fait au token à partir d’un solde prépayé, sans frais mensuels — consultez la facturation. Avec un contexte répété — ce qu’envoient la plupart des éditeurs et clients de chat — la mise en cache des prompts influe davantage sur la facture que le choix du modèle.

Questions fréquentes

Comment ajouter un fournisseur API personnalisé à ChatWise ?

Ouvrez Settings, accédez à Providers et cliquez sur « + » pour ajouter un fournisseur, puis choisissez un préréglage ou créez une configuration personnalisée. Renseignez Provider name, API Base URL et API Key, puis ajoutez les modèles avec le bouton Fetch ou « + New ». La documentation de ChatWise sur les fournisseurs personnalisés présente cette méthode comme permettant d’intégrer n’importe quel service d’IA compatible avec OpenAI ou Anthropic ; une passerelle est donc un cas d’utilisation pris en charge à part entière, et non un contournement.

L’URL de base API de ChatWise doit-elle se terminer par /v1 ?

Pour un point de terminaison compatible avec OpenAI, oui. ChatWise affiche la règle sous le champ : n’incluez pas /chat/completions dans l’URL. Le client ajoute la route lui-même ; la valeur doit donc être la racine /v1 — https://api.kunavo.com/v1 — et la seule passerelle hébergée documentée par ChatWise avec ce champ renseigné utilise la même forme, https://aihubmix.com/v1. Si vous omettez /v1, vous obtenez une erreur 404 plutôt qu’un échec d’authentification, ce qui permet de distinguer rapidement les deux erreurs.

Pourquoi Fetch ne renvoie-t-il aucun modèle dans ChatWise ?

La liste provient de la route /models du point de terminaison, à l’aide de la clé saisie. Un résultat vide indique généralement un problème de clé ou d’URL de base plutôt qu’un catalogue vide. Testez la même paire en dehors de l’application avec une simple commande curl vers /v1/models : si vous recevez du JSON, le problème vient du formulaire du fournisseur ; une erreur 401 indique un problème de clé, une erreur 404 un problème d’URL. Vous pouvez toujours ajouter les modèles manuellement avec « + New » ; dans ce cas, Model ID doit correspondre exactement à l’identifiant du catalogue.

Faut-il un abonnement ou une licence ChatWise pour utiliser sa propre clé API ?

Il s’agit de deux relations de paiement distinctes. ChatWise est un client que vous achetez une seule fois ; l’accès aux modèles est facturé par le détenteur de votre clé. Avec une clé Kunavo, le montant est prélevé sur un solde prépayé, au fil des jetons consommés, sans frais mensuels supplémentaires. La configuration des fournisseurs ne figure pas parmi les fonctionnalités débloquées par l’offre payante, mais aucune page de ChatWise n’affirme explicitement que l’offre gratuite permet d’ajouter un fournisseur personnalisé ; vérifiez ce point pendant la période d’essai avant de vous y fier.

ChatWise peut-il utiliser des modèles Claude sans compte Anthropic ?

Oui, via une entrée de fournisseur compatible avec OpenAI. L’identifiant du modèle est résolu par le point de terminaison que vous avez configuré, et non par ChatWise ; les identifiants utilisés sont donc ceux de ce point de terminaison. Cette méthode diffère de la connexion à un abonnement existant dans l’application, également proposée par ChatWise : cette dernière dépend des conditions d’un autre fournisseur, tandis qu’une clé qui vous est facturée directement n’en dépend pas. Kunavo n’a pas testé ChatWise avec son point de terminaison ; considérez donc cette page comme une description de configuration, et non comme un résultat testé.