Tu as besoin d'une passerelle d'API IA si tu veux utiliser plusieurs fournisseurs de modèles avec une seule clé, une seule facture et un seul code d'appel, ou si tu ne peux pas payer les fournisseurs directement. Tu n'en as pas besoin si tu n'utilises qu'un fournisseur et que ta carte bancaire passe sans histoire.
Je construis Tchavi, donc je ne suis pas neutre. Mais je préfère te dire tout de suite ce que ces outils ne font pas : une passerelle ne rend pas le token moins cher, et elle ajoute un saut réseau. Si tu ne sais pas pourquoi tu en veux une, tu peux t'en passer.
Cet article pose les définitions, décrit les trois façons d'en avoir une, et te donne un critère simple pour décider.
En bref
- Tchavi, une passerelle d'API IA compatible OpenAI que tu paies en mobile money, te donne une clé et une URL (
https://tchavi.com/api/v1) pour les modèles de plusieurs fournisseurs, en texte, en image, en audio et en vidéo. - Une passerelle d'API IA est un service placé entre ton application et les fournisseurs de modèles. Elle reçoit tes requêtes, les transmet au bon fournisseur, facture et garde un journal.
- Elle n'est pas moins chère au token qu'un appel direct, et elle ajoute un saut réseau. Ce qu'elle t'apporte, c'est une clé unique, un moyen de paiement local, un journal d'usage et la liberté de changer de modèle en changeant un seul champ.
- Va en direct si tu n'as qu'un fournisseur et une carte qui fonctionne. Prends une passerelle si tu en as plusieurs, ou si la carte internationale est ton vrai blocage.
- Il existe trois catégories : un proxy que tu héberges toi-même, une passerelle gérée, ou ton propre code.
Ce qu'est une passerelle d'API IA
Une passerelle d'API IA est un service intermédiaire qui expose une seule adresse et une seule clé, et qui relaie chaque requête vers le fournisseur du modèle demandé.
Sans elle, ton code parle à OpenAI avec la clé OpenAI, à Anthropic avec la clé Anthropic, à Google avec la clé Google. Chacun a son compte, sa facture, son format de requête et ses limites.
Avec elle, ton code parle à une adresse :
const res = await fetch('https://tchavi.com/api/v1/chat/completions', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
Authorization: `Bearer ${process.env.TCHAVI_API_KEY}`,
},
body: JSON.stringify({
model: 'gpt-5-mini', // change ce champ pour changer de modèle
messages: [{ role: 'user', content: 'Bonjour' }],
}),
});
Un seul champ, model, décide qui répond. Le reste ne bouge pas.
Ce qu'une passerelle fait
Chaque fonction ci-dessous a sa définition en une phrase.
La clé unique est une clé d'accès qui remplace les comptes de chaque fournisseur. Tu ne gères plus trois dashboards et trois clés à faire tourner. Si une clé fuit, tu en révoques une seule.
L'URL de base est l'adresse unique à laquelle ton client envoie ses requêtes. Si ton client suit le format OpenAI, il suffit de changer cette adresse et la clé. Chez Tchavi, la doc de l'URL de base montre les SDK courants.
La facturation unifiée est un solde unique, débité à chaque requête selon le modèle utilisé. Tu suis une seule ligne de dépense pour tous les fournisseurs. Chez Tchavi, ce solde est en crédits, rechargé en mobile money, et chaque réponse porte un en-tête X-Credits-Used avec le coût de l'appel.
Le journal d'usage est la liste de tes requêtes avec leur modèle, leurs tokens et leur coût. C'est ce qui te permet de répondre à « pourquoi la facture a doublé mardi ». Chez Tchavi, la page Usage du tableau de bord liste chaque requête avec son modèle, ses comptes de tokens et les crédits débités, et tu peux ouvrir le détail de chacune.
Les contrôles par clé sont des règles attachées à une clé plutôt qu'à tout le compte. L'idée : une clé par projet ou par client, que tu peux couper sans arrêter le reste. Chez Tchavi, tu crées plusieurs clés pour différents projets, et les limites de débit suivent ton niveau de compte (limites de débit).
La traduction de format est la conversion d'une requête d'un format d'API vers un autre. Exemple concret : Claude Code ne parle que le format Anthropic. Une passerelle qui sait recevoir ce format peut l'accepter et le servir. Chez Tchavi, c'est l'endpoint /v1/messages, qui permet de brancher Claude Code.
Le repli entre fournisseurs est le passage automatique vers un autre hébergeur quand le premier échoue. C'est la fonction qui fait la différence entre une passerelle de production et un simple relais. Selon les passerelles, le repli est un réglage que tu configures ou une décision du service. Vérifie toujours ce que le tien fait, et surtout s'il te prévient quand il change de modèle sans te le dire. Chez Tchavi, chaque identifiant de modèle est servi par lui-même : tu choisis le modèle, la passerelle ne le remplace pas.
Ce qu'une passerelle ne fait pas
Elle ne baisse pas le prix du token. Le fournisseur facture la passerelle, la passerelle te facture, et elle prend une marge. Tchavi n'est pas moins cher qu'un appel direct à OpenAI ou Anthropic : si tu as une carte qui passe, direct sera plus économe. Les prix exacts sont sur la page de chaque modèle, et je les détaille dans cet article sur les prix en FCFA.
Elle ajoute un saut réseau. Ta requête passe par un serveur de plus avant d'atteindre le fournisseur. Sur un appel de chat qui dure plusieurs secondes, la différence est difficile à sentir. Sur un appel qui doit répondre en quelques dizaines de millisecondes, elle compte. Et la passerelle est un composant de plus qui peut tomber.
Elle n'efface pas les différences entre modèles. Un format commun ne rend pas tous les modèles équivalents : un paramètre qu'un modèle ne gère pas reste un paramètre qu'il ne gère pas. Chez Tchavi, une demande qu'un modèle ne supporte pas échoue avec une erreur claire, plutôt que d'être simulée en silence.
Les trois façons d'en avoir une
Un proxy auto-hébergé est un logiciel que tu installes et que tu fais tourner sur ton propre serveur. Tu gardes le contrôle total, y compris sur les journaux. En échange, tu gères la machine, les mises à jour, la sécurité de tes clés fournisseurs, et surtout tu as toujours besoin d'un compte et d'un moyen de paiement chez chaque fournisseur. Il résout la clé unique et le format, pas le problème de la carte.
Une passerelle gérée est un service hébergé par un tiers, auquel tu te connectes avec une clé. Tu n'as rien à installer. Le service tient les comptes fournisseurs, la facturation et le journal. C'est la catégorie de Tchavi. Le compromis : tu fais confiance à un tiers pour le trafic et la disponibilité.
Construire la tienne est du code que tu écris dans ton backend. Une fonction qui choisit le fournisseur, un dictionnaire de clés, un tableau Postgres pour les coûts. Pour deux modèles et un seul développeur, c'est tout à fait raisonnable, et ça le reste jusqu'au jour où tu dois suivre les changements de prix, de format et de limites de cinq fournisseurs.
| Auto-hébergé | Gérée | Faite maison | |
|---|---|---|---|
| Tu installes et maintiens | Oui | Non | Oui |
| Comptes fournisseurs à ouvrir | Un par fournisseur | Aucun | Un par fournisseur |
| Règle le paiement sans carte | Non | Selon le service | Non |
| Contrôle des journaux | Total | Celui du service | Total |
Quand en avoir besoin, et quand aller en direct
Pose-toi quatre questions.
Tu utilises un seul fournisseur et ta carte passe : va en direct. Tu paies moins cher, tu évites un saut réseau et un intermédiaire. C'est le cas le plus courant, et personne ne devrait te vendre une passerelle ici.
Tu veux comparer ou changer de modèle souvent : prends une passerelle. Tester un modèle d'un autre fournisseur revient à changer un nom de modèle, sans nouveau compte ni nouveau code.
Tu as plusieurs types de sortie, texte, image, audio : une passerelle te simplifie la vie. Une clé, un solde, un journal pour tout.
Ta carte bancaire est le blocage : une passerelle qui accepte le mobile money est souvent la seule porte. C'est le vrai sujet pour beaucoup de développeurs en Afrique francophone. Les fournisseurs demandent une carte internationale ; la tienne est refusée, plafonnée, ou tu n'en as pas. Dans ce cas, le prix du token passe après la question « puis-je seulement payer ? ». J'ai détaillé ce point dans Payer une API IA sans carte Visa. Il y a aussi le taux de change : un fournisseur facture en dollars, ta banque convertit avec ses frais, et ton budget en FCFA bouge sans que tu y sois pour quelque chose.
Comment Tchavi se place
Voici ce qui est vrai aujourd'hui, vérifié dans la documentation :
- Compatible OpenAI. Tu changes l'URL de base et la clé, le reste de ton code ne bouge pas. Les requêtes et réponses suivent le format OpenAI (principes).
- Un endpoint Anthropic.
/v1/messagesexiste pour Claude Code et les clients au format Anthropic. L'URL de base s'arrête alors à/api(agents de code). - Paiement en mobile money. Tu recharges un solde de crédits, sans abonnement. Les opérateurs et pays sont sur la page paiements.
- Plusieurs types de modèles. Texte, image, audio, embeddings, vidéo et décisions passent par la même clé.
- Un journal d'usage. Chaque requête facturée y apparaît avec son modèle, ses tokens et ses crédits. Les endpoints de découverte
GET /v1/modelsne sont pas facturés ni comptés comme usage (modèles). - Des en-têtes sur chaque réponse.
X-Credits-Used,X-Credits-RemainingetX-Request-Id, pour suivre un appel précis.
Ce que Tchavi ne fait pas : être moins cher qu'un appel direct, ni te dispenser de choisir ton modèle.
FAQ
Qu'est-ce qu'une passerelle d'API IA ?
C'est un service qui se place entre ton application et les fournisseurs de modèles. Tu lui envoies tes requêtes avec une seule clé ; elle les relaie vers le modèle demandé, facture et garde un journal.
Une passerelle d'API IA est-elle moins chère qu'un appel direct ?
Non. La passerelle prend une marge sur le prix du fournisseur. Elle te fait gagner du temps et de l'accès, pas de l'argent par token.
Une passerelle ralentit-elle mes requêtes ?
Elle ajoute un saut réseau. Sur un appel de chat de plusieurs secondes, c'est rarement perceptible. Sur un usage très sensible à la latence, mesure avant de choisir.
Quand vaut-il mieux appeler le fournisseur directement ?
Quand tu n'utilises qu'un fournisseur et que ta carte bancaire fonctionne. Tu paies moins cher et tu as un intermédiaire de moins.
Puis-je utiliser mon code OpenAI existant avec une passerelle ?
Oui, si elle est compatible avec le format OpenAI. Tu changes l'URL de base et la clé API. Avec Tchavi, l'URL est https://tchavi.com/api/v1.
Une passerelle sert-elle si je n'ai pas de carte bancaire internationale ?
C'est souvent sa raison principale. Chez Tchavi, tu recharges en mobile money et tu paies tes appels en crédits, sans carte.
Crée ton compte et recharge 1 000 F
Cet article fait partie de la série « Construire un SaaS IA depuis l'Afrique francophone ». Tchavi est une passerelle d'API IA compatible OpenAI : une seule clé donne accès à plus de 100 modèles de texte, d'image, d'audio et de vidéo, et tu la paies en mobile money, sans carte bancaire (pays et opérateurs). Plus de guides sur le blog. Pour suivre les prochains : LinkedIn et X.