Chatbox est un client IA multiplateforme, utilisable sur ordinateur comme sur mobile. Il peut exploiter directement le service Chatbox AI intégré, ou fonctionner avec votre propre clé API pour accéder à vos modèles. Cet article ne traite que le second cas : depuis l'installation, connecter un fournisseur compatible OpenAI à Chatbox, puis vérifier, synchroniser et configurer l'usage en équipe.

Remarque : Chatbox est une marque de son détenteur. Cet article est purement technique et n'implique aucune affiliation avec l'équipe Chatbox ; les noms d'interface et entrées de menu dépendent de la version installée. Modèles et prix figurent sur la page tarifs des modèles.

1. Installation : vérifier d'abord la plateforme et la version

La version de bureau convient aux conversations longues, aux documents volumineux et aux captures d'écran ; la version mobile aux questions glanées dans les moments libres. Les deux peuvent coexister, mais les entrées de configuration ne sont pas identiques.

Trois points à l'installation :

  1. Téléchargez depuis une source fiable et vérifiez le nom de l'application et l'éditeur avant d'installer.
  2. Sur un ordinateur d'entreprise, confirmez la liste blanche logicielle pour éviter un blocage réseau après installation.
  3. Après installation, passez d'abord à la version stable courante, puis configurez.

Les anciennes versions peuvent ne pas proposer « fournisseur de modèles personnalisé », ou utiliser des libellés différents. Forcer une configuration selon un ancien tutoriel conduit souvent à saisir la clé dans le mauvais champ. Mettez à jour avant de suivre l'interface.

2. Trois paramètres à préparer avant l'intégration

Quelle que soit la passerelle, un fournisseur personnalisé ne demande que trois éléments :

Paramètre Exemple Erreur fréquente
Clé API sk-... Espace ou retour à la ligne copié avec
URL de base https://ai.zhongshangqihang.com/v1 Adresse complète de l'interface saisie
Identifiant de modèle Selon la page tarifs Nom affiché au lieu de l'identifiant API

La clé se crée après inscription sur ZSQH AI Gateway ; nommez-la selon l'appareil et l'usage, par exemple chatbox-mac-travail. L'URL de base est l'adresse compatible OpenAI de la passerelle. Copiez l'identifiant de modèle depuis la page tarifs des modèles, en respectant casse, suffixe de version et tirets.

Notez d'abord les trois paramètres dans un emplacement temporaire ; décidez ensuite s'il faut les conserver. N'écrivez jamais la clé dans un document public ou un historique de discussion.

3. Ajouter un fournisseur compatible OpenAI

Les libellés varient selon les versions, mais l'ordre est stable :

  1. Ouvrez Chatbox et rendez-vous dans « Paramètres ».
  2. Trouvez « Fournisseurs de modèles » ou « Services de modèles ».
  3. Cliquez sur « Ajouter » ou « + » pour créer un fournisseur.
  4. Donnez un nom reconnaissable, par exemple « ZSQH AI Gateway ».
  5. Choisissez le mode API compatible OpenAI, pas les modes Anthropic ou Gemini.
  6. Renseignez la clé API et l'URL de base.
  7. Cliquez sur « Récupérer » pour charger la liste des modèles ; en cas d'échec, ajoutez l'identifiant à la main.
  8. Cliquez sur « Vérifier » pour tester la connexion, puis sélectionnez le modèle ajouté.

Un même fournisseur peut contenir plusieurs modèles. Regroupez dialogue, vision et raisonnement dans le même fournisseur pour éviter les erreurs de sélection. Si vous avez un environnement de test et un environnement de production, créez deux fournisseurs avec des préfixes distincts.

4. Comment renseigner l'URL de base et l'identifiant de modèle

L'URL de base est le champ le plus source d'erreurs. Elle doit s'arrêter à /v1, le client ajoutant lui-même le chemin de l'interface. Si vous incluez aussi /chat/completions, le client peut l'ajouter une seconde fois et provoquer un 404.

Deux règles de diagnostic :

  • 401 : vérifiez d'abord la clé — expirée, supprimée, ou entourée d'espaces.
  • 404 : vérifiez d'abord le chemin — ajoutez ou retirez /v1 en ne changeant qu'une chose à la fois.

L'identifiant de modèle doit correspondre exactement à l'identifiant API de la page tarifs. Le nom affiché est plus lisible, mais inutilisable dans une requête. Pour les modèles avec date, numéro de version ou suffixe comme -mini, vérifiez caractère par caractère.

5. Vérification : curl d'abord, client ensuite

Validez d'abord la passerelle dans le terminal ; cela élimine la moitié des causes possibles :

export ZSQH_API_KEY="sk-votre-clé"

curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
  -H "Authorization: Bearer $ZSQH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "votre-ID-de-modèle",
    "messages": [{"role": "user", "content": "Réponds seulement OK"}]
  }'

Si le JSON renvoyé contient choices, la clé, l'adresse et le modèle sont valides. Revenez ensuite au client pour trois contrôles :

  1. Envoyez une question courte et vérifiez que les premiers mots arrivent.
  2. Enchaînez deux tours pour confirmer que le contexte est conservé.
  3. Demandez une réponse longue pour vérifier qu'elle ne se coupe pas.

Si seule la réponse longue se coupe, examinez le réseau et le streaming ; si toutes les requêtes échouent, revenez à la clé et à l'URL de base. Un « Vérifier » réussi dans le client ne prouve que la connectivité de base, pas que toutes les capacités fonctionnent.

6. Réglages et synchronisation : bureau et mobile

Les paramètres de Chatbox comprennent généralement le modèle par défaut, la température, la longueur de contexte, le proxy et le répertoire de données. Modifiez d'abord trois éléments : modèle par défaut, streaming activé ou non, emplacement des données. Laissez le reste par défaut jusqu'à validation.

Scénario Pratique conseillée Attention
Usage quotidien sur bureau Enregistrer le fournisseur, fixer le modèle par défaut Exporter régulièrement les conversations
Questions ponctuelles sur mobile Configurer un fournisseur séparé, peu de modèles Ne pas conserver une clé durablement sur un téléphone partagé
Changement d'ordinateur Ressaisir la clé et l'identifiant de modèle Ne pas copier tout le répertoire de configuration
Appareil partagé Comptes système distincts Éviter que conversations et clés soient visibles de tous

La synchronisation cloud des comptes et son périmètre dépendent de la version et du mode de connexion ; consultez la page de paramètres de données de l'application. Ne présumez pas que « les conversations se synchronisent, donc les clés aussi ». Le plus souvent, la clé est une configuration locale à ressaisir sur un nouvel appareil ; un fichier de sauvegarde peut contenir des informations sensibles et doit être traité comme un fichier de clés.

7. Usage en équipe : traiter la configuration comme une infrastructure

Ce que les petites équipes négligent le plus n'est pas l'intégration, mais la transmission. Prévoir au minimum :

  • Une clé par personne, pas une clé commune à tous.
  • Des noms de fournisseurs homogènes, par exemple tous préfixés ZSQH-.
  • Des alertes de budget ou d'usage côté passerelle pour éviter une consommation oubliée.
  • En cas de départ ou de perte d'appareil, révoquer la clé avant de traiter les autres comptes.
  • Documenter en interne l'URL de base, les identifiants de modèles et la version du client.

L'intérêt n'est pas seulement la « bonne gouvernance » : en cas d'incident, vous identifiez vite si c'est la clé d'une personne qui a expiré, un modèle retiré ou une version de client différente.

8. Questions fréquentes

Peut-on utiliser Chatbox sans clé API ?

Oui, avec le service Chatbox AI intégré ; quotas et tarification dépendent de la version courante. Le mode clé personnelle passe par le fournisseur d'API que vous configurez, et la facture est calculée à l'usage par ce fournisseur. Les deux modes ne doivent pas être confondus.

L'URL de base doit-elle inclure /v1 ?

La plupart des configurations compatibles OpenAI l'exigent. Si les deux variantes échouent, utilisez curl pour trouver l'adresse complète qui renvoie un résultat, puis reportez-la dans le client, sans deviner.

Un échec de « Récupérer la liste des modèles » signifie-t-il une clé défectueuse ?

Pas nécessairement. La passerelle peut ne pas exposer l'interface de liste, ou le chemin être incorrect. Ajoutez d'abord un identifiant de modèle à la main, puis validez par « Vérifier » ou une vraie conversation. Si l'ajout manuel fonctionne, seule l'interface de liste n'est pas prise en charge.

Le bureau fonctionne mais le mobile ne se connecte pas ?

Vérifiez d'abord que les deux utilisent la même URL de base et le même identifiant de modèle, puis si le réseau mobile bloque les requêtes. L'entrée et les capacités mobiles peuvent différer de la version bureau ; référez-vous à la version installée. Ne conservez pas durablement une clé à droits élevés sur un téléphone.

La configuration survit-elle à un changement d'ordinateur ?

Cela dépend de la connexion à un compte, de l'utilisation de la synchronisation et de l'existence d'un export. Il est conseillé de ressaisir la clé ; révoquez celle de l'ancien appareil dès qu'il n'est plus utilisé.

Prochaines étapes

Trois étapes suffisent pour connecter une API personnalisée à Chatbox : bonne version, bonne URL de base, bon identifiant de modèle. Validez avec curl avant d'ouvrir le client ; en cas d'erreur, cherchez 401 côté clé, 404 côté chemin, modèle inexistant côté identifiant. Pour un point d'entrée unifié et la gestion de l'usage, vous pouvez créer un compte ZSQH AI Gateway ; modèles et prix figurent sur la page tarifs des modèles.

Lectures associées :