One API et New API sont deux projets open source courants de passerelle API AI. Ils permettent de regrouper plusieurs fournisseurs de modèles derrière une interface compatible OpenAI. Lorsque le volume augmente, de nombreuses équipes se demandent s'il faut « monter sa propre passerelle » ou « utiliser directement un service managé ».

Cet article explique la différence entre les deux approches, ce que nécessite l'auto-hébergement, dans quels cas il est adapté et comment migrer.

Remarque : One API et New API sont les noms de leurs projets ou détenteurs respectifs. Cet article sert uniquement à une discussion technique ; les fonctionnalités et licences applicables sont celles du dépôt de chaque projet.

1. Qu'est-ce que One API et New API

Il s'agit essentiellement de passerelles API :

votre application → passerelle (clé/quota/routage/journaux) → OpenAI / Claude / Gemini / DeepSeek

Fonctions courantes :

  • interface compatible OpenAI ;
  • gestion de plusieurs canaux et modèles ;
  • utilisateurs, jetons, quotas et groupes ;
  • journaux d'usage et facturation ;
  • limitation, nouvelles tentatives et bascule de canal ;
  • interface d'administration.

One API est apparu plus tôt ; New API est l'un des projets qui ont poursuivi son développement, avec des fonctions et une interface d'administration plus modernes. Les deux conviennent à une équipe disposant de compétences techniques.

2. Ce que nécessite l'auto-hébergement

2.1 Serveur

Un serveur Linux capable d'exécuter Docker. La configuration dépend de la concurrence et du volume de journaux ; une petite équipe n'a pas besoin d'une machine très puissante au départ, mais doit tenir compte de la bande passante et du disque.

2.2 Base de données

Choix courants : SQLite (simple), MySQL, PostgreSQL. En production, MySQL ou PostgreSQL sont recommandés, avec des sauvegardes régulières.

2.3 Redis (facultatif mais recommandé)

Pour le cache, les sessions et la limitation de débit, notamment en déploiement multi-nœuds.

2.4 Nom de domaine et HTTPS

Il faut un domaine, un DNS, un reverse proxy (Caddy ou Nginx) et un certificat. Les callbacks de paiement et la connexion OAuth exigent une URL HTTPS publique.

2.5 Comptes et canaux amont

Vous devez préparer vous-même les clés ou canaux amont OpenAI, Claude, Gemini, DeepSeek, etc. La passerelle ne fournit pas de quota de modèles.

2.6 Exploitation

Mises à jour, sauvegardes, supervision, journaux, correctifs de sécurité, rapprochement des paiements et alertes. C'est le principal coût caché de l'auto-hébergement.

3. Auto-hébergement ou service managé

Dimension One API/New API auto-hébergé Service managé (par exemple ZSQH)
Coût initial Serveur + domaine + temps Inscription immédiate
Maîtrise des données Élevée, données sur votre serveur Selon les conditions du fournisseur
Canaux de modèles À demander et maintenir soi-même Fournis par la plateforme
Exploitation À votre charge À la charge de la plateforme
Mises à jour et sécurité À suivre soi-même Suivies par la plateforme
Paiement et facture À gérer soi-même Gérés par la plateforme
Personnalisation Élevée Limitée aux fonctions de la plateforme
Public adapté Équipe technique, personnalisation poussée Mise en production rapide, peu d'exploitation

4. Étapes générales de l'auto-hébergement

4.1 Préparer le serveur et le domaine

Installez Docker, configurez le DNS et le pare-feu. N'ouvrez que les ports 22, 80 et 443 ; n'exposez pas la base de données ni Redis sur Internet.

4.2 Déployer la base de données et Redis

Utilisez des mots de passe aléatoires robustes, des volumes persistants et une sauvegarde quotidienne.

4.3 Déployer la passerelle

Lancez l'application, la base de données et Redis avec Docker Compose. Configurez les variables d'environnement :

  • connexion à la base de données ;
  • connexion à Redis ;
  • clé de session ;
  • adresse du site ;
  • CORS et domaines de confiance.

4.4 Configurer le reverse proxy et HTTPS

Faites pointer Caddy ou Nginx vers le port de l'application et activez HTTPS/HSTS.

4.5 Configurer les canaux amont

Ajoutez les canaux, modèles, groupes et multiplicateurs dans l'administration. Validez d'abord avec une clé à faible montant.

4.6 Configurer le paiement et OAuth (facultatif)

Les callbacks de paiement et la connexion Google/GitHub nécessitent une URL HTTPS publique et des adresses de retour correctes.

4.7 Supervision et sauvegardes

Prévoyez au minimum : supervision de disponibilité, journaux d'erreurs, sauvegarde de la base de données et alerte sur l'espace disque.

5. Quand l'auto-hébergement est adapté

  • Vous avez une équipe technique capable de gérer le serveur et les mises à jour.
  • Les données doivent rester sur votre propre serveur.
  • Vous avez besoin d'une personnalisation poussée du routage, de la facturation ou des permissions.
  • Les canaux amont sont stables et vous pouvez les maintenir.
  • Le volume est important et le coût d'un service managé dépasse nettement le coût total de l'auto-hébergement.

6. Quand l'auto-hébergement n'est pas adapté

  • Vous n'avez pas de personnel d'exploitation.
  • Vous voulez seulement valider rapidement un produit.
  • Les comptes amont, le paiement ou la conformité ne sont pas maîtrisés.
  • Vous ne pouvez pas assurer les mises à jour de sécurité et les sauvegardes.
  • Votre objectif principal est d'« économiser un peu de frais d'API ».

L'auto-hébergement n'est pas gratuit : serveur, domaine, certificat, sauvegardes, supervision, diagnostic et mises à jour de sécurité ont tous un coût.

7. Migrer vers un service managé

Si vous avez déjà une passerelle auto-hébergée et souhaitez passer à un service managé :

  1. Exportez les utilisateurs, jetons et configurations de canaux (pour l'inventaire uniquement, sans divulguer les clés).
  2. Créez un compte et une clé sur la plateforme managée.
  3. Remplacez l'URL de base par l'adresse du service managé.
  4. Établissez la correspondance des modèles.
  5. Basculez 5 à 10 % du trafic pendant 3 à 7 jours.
  6. Conservez l'instance auto-hébergée en secours, puis l'arrêter une fois la stabilité confirmée.

8. Questions fréquentes

New API ou One API : lequel choisir ?

Cela dépend de vos besoins, de la version et de votre capacité de maintenance. Examinez l'activité du projet, la documentation, la licence, la communauté et votre stack technique, plutôt que la seule liste de fonctionnalités.

Une passerelle auto-hébergée peut-elle appeler directement les modèles officiels ?

Oui, mais vous devez préparer vous-même les clés ou canaux amont et respecter les conditions de chaque fournisseur.

Combien coûte l'auto-hébergement ?

Serveur, domaine, sauvegardes, supervision et main-d'œuvre représentent des coûts. Pour un petit volume, la facture peut rester faible ; une entreprise doit toutefois investir dans la haute disponibilité, les sauvegardes et la sécurité.

Un service managé crée-t-il une dépendance ?

Cela dépend de la façon dont vous configurez l'URL de base et les noms de modèles. En restant compatible OpenAI et piloté par configuration, le coût de migration reste bien plus faible.

Pour aller plus loin

Si vous ne souhaitez pas maintenir serveur, base de données, paiement et mises à jour, vous pouvez d'abord valider votre activité avec le service managé ZSQH AI Gateway. Si l'auto-hébergement est obligatoire, évaluez les coûts humains et de sécurité à l'aide de la liste ci-dessus. Les modèles et prix applicables sont ceux de la page Tarifs des modèles.

À lire aussi :