Ajoutez tout le catalogue de modèles à Chatbox avec un seul fournisseur personnalisé.

Updated 2026-07-29

Chatbox fournit un flux Add Custom Provider pour tout endpoint compatible OpenAI : choisissez le mode OpenAI API Compatible, réglez l'API Host sur https://api.apisrouter.com/v1, collez une seule clé, et les id Claude, GPT, Gemini et DeepSeek se retrouvent côte à côte dans le sélecteur de modèle sur desktop, mobile et web.

Réponse rapide : une boîte de dialogue dans les réglages Model Provider.

Ouvrez les réglages (Settings) de Chatbox et passez à l'onglet Model Provider. Cliquez sur Add, puis Add Custom Provider. Remplissez la boîte de dialogue avec cinq valeurs : un Name (APIsRouter), API Mode réglé sur OpenAI API Compatible, votre clé dans API Key, https://api.apisrouter.com/v1 dans API Host, et laissez API Path sur le défaut /chat/completions que Chatbox remplit pour un hôte se terminant en /v1. Ajoutez ensuite des modèles. Le bouton Fetch tire la liste de modèles de l'endpoint via /v1/models, ce qui vous permet d'activer directement des id du catalogue, et New vous permet de taper un id à la main si vous préférez un sélecteur court et curé. Cliquez sur Check à côté du champ clé et Chatbox lance une requête en direct ; une confirmation verte signifie que le fournisseur est câblé. Nous avons validé exactement ce flux sur l'application web actuelle de Chatbox, et la même boîte de dialogue équipe les versions desktop et mobile.

Comment Chatbox parle à un fournisseur personnalisé.

Chatbox (chatboxai sur GitHub, environ 41 000 étoiles) est l'un des clients de chat IA les plus installés : applications natives pour Windows, macOS et Linux, versions mobiles pour iOS et Android, et une version navigateur sur web.chatboxai.app. Il livre des entrées maison pour les grands fournisseurs, chacune voulant sa propre clé, et la boîte de dialogue de fournisseur personnalisé est le chemin documenté pour tout le reste. Un fournisseur personnalisé en mode OpenAI API Compatible est une simple description d'un endpoint : hôte, chemin, clé, et une liste d'id de modèles. Chaque tour de conversation devient une requête chat-completions standard contre cet hôte, avec l'id de modèle du sélecteur voyageant comme une chaîne. Chatbox ne se soucie pas de quel fournisseur a entraîné le modèle derrière un id, ce qui est exactement ce qui rend une passerelle multi-fournisseurs utile ici : une seule entrée de fournisseur met claude-sonnet-4-6, gpt-5.5, gemini-3.5-flash et deepseek-v4-flash dans le même sélecteur, facturés via la même clé. La différence pratique par rapport à empiler quatre fournisseurs maison n'est pas seulement moins de clés. Les réglages de Chatbox se synchronisent par appareil, donc chaque compte fournisseur que vous ajoutez est une clé de plus à coller sur votre téléphone, votre portable et l'application web. Un seul fournisseur personnalisé, c'est un seul collage par appareil, et basculer une conversation de Claude à DeepSeek est un changement de sélecteur plutôt qu'un changement de fournisseur.

Configuration complète : chaque champ de la boîte de dialogue.

Name n'est qu'un libellé ; APIsRouter garde le sélecteur lisible. API Mode doit être OpenAI API Compatible, ce qui indique à Chatbox de parler des chat completions standard ; l'autre mode du menu déroulant est pour les endpoints natifs Gemini et n'est pas ce que veut une passerelle. API Host et API Path se composent en l'URL de requête, et c'est cette paire qui fait dérailler les configurations. Avec l'hôte réglé sur https://api.apisrouter.com/v1, le chemin est /chat/completions, et Chatbox remplit exactement cela quand il reconnaît un hôte /v1. La doc de Chatbox décrit aussi la convention d'hôte nu, où l'hôte omet /v1 et le chemin vaut par défaut /v1/chat/completions ; les deux composent la même URL, donc choisissez une forme et laissez l'autre champ à son défaut. Ce qui casse, c'est de les mélanger, un hôte /v1 avec un chemin /v1/chat/completions, ce qui produit une URL /v1/v1 doublée qui échoue en 404. Les libellés de champ et le comportement d'autofill bougent un peu d'une version de Chatbox à l'autre, donc faites confiance à l'URL composée plutôt qu'à votre mémoire. Pour les modèles, Fetch est la voie à faible effort : Chatbox liste tout ce que sert l'endpoint et vous activez ce que vous voulez. New est la voie curée : tapez les id à la main et le sélecteur reste court. Chaque ligne de modèle a des interrupteurs de capacité (vision, usage d'outils) ; laissez-les désactivés à moins de savoir que le modèle prend en charge la capacité, car un modèle non configuré est traité comme du texte brut, ce qui est le défaut sûr. Terminez avec Check, puis démarrez une conversation et choisissez un modèle sous le nom de votre nouveau fournisseur.

Name:      APIsRouter
API Mode:  OpenAI API Compatible
API Key:   sk-YOUR-APISROUTER-KEY
API Host:  https://api.apisrouter.com/v1
API Path:  /chat/completions   (autofilled)

Models: Fetch (pull the catalog) or New (type ids)
Then:   Check → green confirmation

Choisir des modèles pour un client de chat quotidien.

Comme chaque modèle activé facture via une seule clé, comparer deux id se résume à changer de sélecteur plutôt qu'à décider d'un compte. Lancez le même genre de conversations sur les deux pendant quelques jours, puis lisez la dépense par modèle dans la console APIsRouter et gardez ce qui a mérité sa place.

  • Les questions du quotidien et les réécritures rapides sont du travail par rafales. claude-haiku-4-5-20251001 et gemini-3.5-flash répondent assez vite pour que l'application semble instantanée, et ils portent bien la majeure partie du trafic quotidien.
  • La rédaction longue, le raisonnement soigné et les discussions de code justifient claude-sonnet-4-6 ou gpt-5.5. Gardez un modèle de chaque palier activé et changez par conversation plutôt que par fournisseur.
  • deepseek-v4-flash est le choix volume si Chatbox est votre panneau latéral toujours ouvert ; les petites conversations constantes s'additionnent et le palier rapide garde le solde qui bouge lentement.
  • Les conversations avec entrée d'image ont besoin d'un id capable de vision avec l'interrupteur vision activé sur cette ligne de modèle ; confirmez la capacité par rapport à la documentation du modèle avant d'activer l'interrupteur.
  • Activez délibérément peu de modèles plutôt que de tout récupérer : chaque interrupteur est une ligne du sélecteur, et ajouter un autre id plus tard est une modification de dix secondes.

Paiement à l'usage · en dessous du tarif officiel

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

ModèlePrix officielNotre prix
Claude Sonnet 4.6$3.00 / $15.00 per M$2.40 / $12.00 per M
Claude Haiku 4.5 20251001$1.00 / $5.00 per M$0.80 / $4.00 per M
GPT-5.5$5.00 / $30.00 per M$4.00 / $24.00 per M
Gemini 3.5 Flash$1.50 / $9.00 per M$1.20 / $7.20 per M
DeepSeek V4 Flash$0.14 / $0.28 per M$0.10 / $0.30 per M

Modes d'échec spécifiques à Chatbox.

Le chemin doublé est le classique. Un 404 sur chaque message signifie qu'API Host et API Path portent tous les deux un /v1, ou que le chemin répète ce sur quoi l'hôte se termine déjà ; ouvrez l'entrée de fournisseur et lisez les deux champs comme une seule URL. Un résultat vide de Fetch signifie généralement que la clé est incorrecte ou manquante, car le listing des modèles est lui-même une requête authentifiée. Vérifiez le champ API Key et utilisez le bouton Check, qui fait remonter directement les erreurs d'authentification. Un modèle qui échoue seulement dans certaines conversations vient généralement d'un interrupteur de capacité : vision activée sur un modèle qui n'a pas d'entrée image, ou un flux dépendant d'outils qui touche un modèle avec les outils désactivés. Réinitialisez la ligne de modèle aux valeurs par défaut et réactivez les capacités une par une. Et rappelez-vous que l'entrée de fournisseur vit par installation. Ajouter APIsRouter sur votre bureau ne configure pas votre téléphone ; répétez la boîte de dialogue là-bas, ou utilisez le partage de config propre à Chatbox si votre version le propose. La seule chose qui n'a jamais besoin d'être répétée, ce sont les inscriptions fournisseur, puisqu'une seule clé couvre chaque modèle sur chaque appareil.

Qui route Chatbox via une passerelle.

  • Les personnes qui veulent Claude, GPT, Gemini et DeepSeek dans un seul sélecteur sans maintenir quatre comptes fournisseur et quatre clés sur trois appareils.
  • Les utilisateurs dans des régions où certaines inscriptions fournisseur sont pénibles ; un accès basé sur la recharge, sans exigence de carte, supprime la dépendance par fournisseur.
  • Les développeurs qui routent déjà leurs outils d'éditeur et de terminal via une passerelle et veulent leur client de chat sur la même clé et le même journal d'usage.
  • Les acheteurs de modèles qui comparent des id sur de vraies conversations avant d'engager un projet sur l'un d'eux ; chaque candidat est une ligne de sélecteur, pas un compte.
  • Les foyers et petites équipes qui standardisent sur un seul endpoint, un seul solde, et une visibilité d'usage par clé plutôt que des abonnements éparpillés.

Vérifiez l'endpoint et déboguez le premier message.

Prouvez d'abord la moitié passerelle en dehors de Chatbox : listez les modèles avec votre clé, puis lancez une completion de chat contre un id que vous prévoyez d'activer. Si les deux réussissent, tout ce qui reste se trouve dans la boîte de dialogue de fournisseur. Dans Chatbox, le bouton Check est le signal le plus rapide. Les erreurs d'authentification renvoient au champ clé. Les erreurs de modèle introuvable à l'envoi sont un décalage d'id, ce qui arrive surtout avec les entrées New tapées à la main ; copiez les id depuis la sortie de /v1/models plutôt que de mémoire. Les 404 sur chaque requête viennent de la composition hôte/chemin couverte plus haut. Une fois que les messages circulent, la console APIsRouter affiche le modèle par requête, le nombre de tokens et la dépense. Un client de chat génère de nombreuses petites requêtes au fil de la journée, et le journal d'usage est là où cette habitude devient un chiffre par modèle, par jour, que vous pouvez réellement lire.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-4-5-20251001",
       "messages":[{"role":"user","content":"ping"}]}'

Questions fréquentes

Comment ajouter un API host personnalisé à Chatbox ?

Settings, onglet Model Provider, Add, puis Add Custom Provider. Réglez API Mode sur OpenAI API Compatible, API Host sur https://api.apisrouter.com/v1, collez votre clé, et laissez API Path sur son défaut /chat/completions. Ajoutez des modèles avec Fetch ou New, puis appuyez sur Check.

L'API Host doit-elle inclure /v1 ?

Les deux formes fonctionnent tant que l'hôte et le chemin composent /v1/chat/completions exactement une fois. Avec l'hôte https://api.apisrouter.com/v1, le chemin est /chat/completions ; avec un hôte nu, le chemin vaut par défaut /v1/chat/completions. Mélanger les deux double le /v1 et produit des 404.

Chatbox peut-il faire tourner Claude, Gemini et DeepSeek via une seule entrée de fournisseur ?

Oui. En mode OpenAI API Compatible, l'id du modèle voyage vers l'API Host comme simple chaîne, donc une seule entrée peut activer ensemble claude-sonnet-4-6, gemini-3.5-flash et deepseek-v4-flash, tous facturés via la même clé et modifiables dans le sélecteur.

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

Fetch appelle le listing /v1/models de l'endpoint avec votre clé, donc un résultat vide est presque toujours un problème d'authentification. Revérifiez le champ API Key et lancez le bouton Check ; une fois la clé validée, Fetch liste chaque id que sert la passerelle.

Le fournisseur personnalisé fonctionne-t-il aussi sur Chatbox mobile et web ?

Oui, la boîte de dialogue Add Custom Provider équipe les versions desktop, mobile et web. Les entrées de fournisseur se configurent par installation, donc répétez la configuration en une boîte de dialogue sur chaque appareil avec la même clé.

Ai-je besoin d'interrupteurs de capacité sur chaque modèle ?

Non. Un modèle non configuré fonctionne comme un chat en texte brut, ce qui est le défaut sûr. N'activez les interrupteurs vision ou outils que sur les modèles qui prennent réellement en charge la capacité, car un interrupteur activé à tort produit des erreurs déroutantes précisément dans les conversations qui l'utilisent.