Documentation

Chatbox

Chatbox sépare le point de terminaison en un hôte et un chemin, puis renseigne le chemin à votre place. L’hôte correspond donc à l’origine : le seul piège de ce client consiste à y inclure /v1.

Ajoutez un fournisseur de type OpenAI API Compatible avec l’API Host défini sur la racine du service — Chatbox ajoute lui-même /v1/chat/completions.

Paramètres de Chatbox

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

L’API Host est https://api.kunavo.com, sans /v1. Chatbox dispose d’un champ API Path distinct, défini par défaut sur /v1/chat/completions ; si l’hôte se termine déjà par /v1, les requêtes sont envoyées à /v1/v1/chat/completions. Laissez le chemin vide, sauf si vous savez qu’une autre valeur est nécessaire.

Le sélecteur de type de fournisseur de Chatbox désigne un format de transmission. Choisissez OpenAI API 兼容 (compatible avec l’API OpenAI), puis saisissez un identifiant de modèle Claude : l’identifiant est résolu par le point de terminaison, les deux ne sont donc pas incompatibles.

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

Étape par étape

Créez une clé sur /app/keys et copiez-la — elle n’est affichée qu’une seule fois.
Ouvrez Settings → Model Providers, puis cliquez sur Add.
Nommez le fournisseur, définissez le type sur OpenAI API 兼容 et collez la clé API.
Définissez API 主机 / API Host sur https://api.kunavo.com et laissez API 路径 / API Path vide.
Ajoutez les identifiants de modèle souhaités, enregistrez et démarrez une conversation.

Vérifié avec Guide de configuration des fournisseurs de Chatbox le 6 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.

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

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 Chatbox
`claude-sonnet-5`	$1.40 / $7.00	le modèle de conversation par défaut
`claude-haiku-4-5`	$0.70 / $3.50	les échanges courts, où la latence et le prix comptent tous deux
`claude-opus-5`	$3.50 / $17.50	une seconde entrée de fournisseur réservée aux questions difficiles
`gpt-5-6-terra`	$0.70 / $4.20	une autre famille de modèles 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

Quelle valeur indiquer dans API Host de Chatbox pour un point de terminaison compatible avec OpenAI ?

L’origine, sans chemin — par exemple https://api.example.com. Chatbox dispose d’un champ API Path distinct, défini par défaut sur /v1/chat/completions, qu’il n’est généralement pas nécessaire de renseigner selon sa documentation. /v1 provient donc du chemin, pas de l’hôte. Si l’hôte se termine par /v1, les requêtes sont envoyées à /v1/v1/chat/completions et renvoient une erreur 404.

Comment ajouter un fournisseur de modèles personnalisé dans Chatbox ?

Ouvrez Settings → Model Providers et cliquez sur Add, puis donnez un nom au fournisseur, choisissez le type d’API compatible avec OpenAI, collez la clé API, définissez API Host sur l’origine du point de terminaison et laissez API Path vide. Ajoutez les identifiants des modèles souhaités et enregistrez ; le fournisseur apparaît alors dans le sélecteur de modèle de chaque conversation.

Chatbox peut-il communiquer avec des modèles Claude ?

Oui, via un point de terminaison compatible avec OpenAI qui les fournit. Chatbox envoie l’identifiant de modèle que vous avez saisi à l’hôte configuré ; c’est donc là que l’identifiant Claude est résolu, et l’application n’a besoin d’aucun identifiant Anthropic. Le sélecteur de type de fournisseur choisit un format de transmission, pas un fournisseur.

Quand faut-il renseigner le champ API Path de Chatbox ?

Uniquement si le point de terminaison ne fournit pas Chat Completions à /v1/chat/completions. Ce champ existe pour les passerelles dont le routage est inhabituel ; pour un service standard compatible avec OpenAI, il est correct de le laisser vide. Saisir un chemin est une cause fréquente d’erreurs 404 qui ressemblent à des problèmes d’authentification.