Blank white background with no objects or features visible.

Bonjour, zone EMEA ! TrueFoundry étend sa présence en Europe, au Moyen-Orient et en Afrique. En savoir plus. →

Comment migrer de Portkey vers TrueFoundry

Published: novembre 20, 2026

En résumé
  • Les fonctionnalités de Portkey sont segmentées par offres, et cette segmentation est le déclencheur de la migration. Son noyau open-source ne gère que le routage, le fallback et le load balancing. L'observabilité, les clés virtuelles, la mise en cache et la gestion des prompts se trouvent dans le produit hébergé. Le SSO, la conformité, le VPC et l'anonymisation des PII sont réservés à l'offre Enterprise.
  • Le forfait Pro vous limite rapidement : 49 $/mois couvrent environ 100K requêtes avec une rétention des logs de 30 jours et sans SSO. Les équipes qui ont besoin du SSO, d'une rétention plus longue ou d'un VPC doivent basculer vers les tarifs sur mesure de l'offre Enterprise.
  • Les équipes migrent pour consolider. Elles souhaitent bénéficier du SSO, de la conformité et du VPC sans le saut opaque vers l'offre enterprise, d'une gouvernance approfondie des coûts ou d'un plan de contrôle unique couvrant gateway + gouvernance + observabilité + MCP avec un déploiement on-prem ou air-gapped.
  • La migration présente peu de risques car les deux solutions utilisent l'API compatible OpenAI. Le principal changement côté client est l'URL de base ; vous exécutez les deux en parallèle et effectuez le basculement équipe par équipe.
  • Mappez les concepts, ne reconstruisez pas : les clés virtuelles de Portkey deviennent du RBAC avec des budgets, les configurations deviennent des politiques, les guardrails se transposent directement, et les logs hébergés deviennent une observabilité par requête avec la durée de rétention que vous contrôlez.

Portkey est une AI gateway performante, et pour une équipe qui s'inscrit dans la grille de ses forfaits, elle fonctionne très bien. La difficulté à laquelle de nombreuses équipes se heurtent ne réside pas dans les capacités absolues de l'outil, mais dans la répartition de chaque fonctionnalité au sein de la structure tarifaire. L'élément dont vous avez besoin ensuite — le SSO, une fenêtre de logs plus longue, un déploiement VPC, l'anonymisation des PII — a tendance à se trouver un niveau au-dessus de votre forfait actuel, et l'offre supérieure est sur devis et opaque.

Cette segmentation tarifaire est ce qui transforme une évaluation de Portkey en une discussion de migration. Une équipe utilisant le forfait Pro découvre que le SSO n'est pas du tout disponible à son niveau, qu'une rétention des logs de 30 jours est insuffisante pour une enquête sur un incident ou un audit de conformité, et que l'exécution du data plane au sein de son propre VPC nécessite l'offre Enterprise. À ce stade, la question devient : faut-il négocier un contrat enterprise opaque pour des fonctionnalités qui devraient être standard, ou migrer vers une gateway où la gouvernance et la flexibilité de déploiement ne sont pas verrouillées derrière le niveau le plus élevé ?

Ce document est un guide de migration pour les équipes dans cette situation. Il décrit la réalité des forfaits de Portkey en toute transparence, nomme les raisons précises pour lesquelles les équipes migrent, et détaille une démarche pas à pas vers TrueFoundry. Cette migration comporte peu de risques, car les deux gateways utilisent l'API compatible OpenAI. Dans la plupart des cas, la modification côté client se limite à une seule URL de base.

Vous souhaitez bénéficier du SSO, du VPC et d'une gouvernance approfondie des coûts sans paliers tarifaires restrictifs ? Réservez une démo.

La réalité des forfaits Portkey

Pour planifier une migration, vous avez besoin d'une cartographie fidèle de ce que Portkey propose à chaque niveau, car toute la décision repose sur cet arbitrage.

Portkey tier reality: what the OSS core, Pro, and Enterprise tiers each include, versus a single unified control plane where governance is not gated.
Réalité des forfaits Portkey : ce que le noyau OSS, Pro et Enterprise incluent respectivement, face à un plan de contrôle unifié où la gouvernance n'est pas restreinte.

Le noyau open-source gère uniquement le routage. La gateway OSS de Portkey gère le routage, le fallback et le load balancing. Elle n'inclut pas l'observabilité, le caching, les clés virtuelles ni le RBAC. Si vous avez adopté Portkey OSS en vous attendant au produit complet, vous n'avez obtenu que la couche de routage de requêtes.

Le produit hébergé ajoute la couche opérationnelle. Les logs et traces, les clés virtuelles, le caching et la gestion des prompts sont fournis avec le produit hébergé (managé), pas avec le noyau OSS. C'est là que la plupart des équipes exécutent réellement Portkey.

L'offre Enterprise verrouille les fonctionnalités de gouvernance et de déploiement. Le SSO, les fonctionnalités de conformité, le VPC / la souscription privée, l'anonymisation des PII et un BAA sont réservés à l'offre Enterprise, sur devis. Les capacités les plus critiques pour une entreprise réglementée se situent derrière le forfait sans prix public.

Les limites spécifiques du forfait Pro. Les tarifs publiés rendent ce plafond très concret :

Forfait PortkeyPrixRequêtesRétention des logsSSOVPC / Conformité
DevGratuit~10K/mois3 joursNonNon
Pro49 $/mois~100K/mois30 joursNonNon
EnterpriseSur mesureSur mesureSur mesureOuiOui (VPC, PII, BAA)

Le passage de Pro à Enterprise n'est pas progressif. Il n'existe pas de niveau intermédiaire permettant d'acheter uniquement le SSO ou seulement une rétention de 90 jours. Dès que vous avez besoin d'une fonctionnalité verrouillée par l'offre Enterprise, vous entrez dans une négociation tarifaire sur mesure : c'est exactement ce point de friction qui pousse les équipes à évaluer d'autres solutions.

Pourquoi les équipes migrent vers TrueFoundry

Les raisons sont précises et correspondent directement aux limitations tarifaires mentionnées ci-dessus.

  • SSO, conformité et VPC sans augmentation opaque des coûts. Les équipes ont besoin d'un SSO adossé à leur fournisseur d'identité, du provisionnement SCIM, d'audits et de la possibilité d'exécuter le data plane dans leur propre réseau, sans que ces fonctionnalités élémentaires de gouvernance ne soient verrouillées derrière un contrat enterprise sur mesure.
  • Une gouvernance approfondie des coûts. Au-delà des limites par clé, les équipes recherchent des budgets et des limites de débit par utilisateur, équipe et modèle, accompagnés d'une véritable attribution des coûts étiquetée par équipe, afin que le FinOps puisse répartir les dépenses avec précision au lieu de lire un log global.
  • Consolidation au sein d'un plan de contrôle unique. Plutôt que d'avoir une gateway d'un côté, l'observabilité de l'autre et la gouvernance MCP ailleurs, les équipes préfèrent regrouper gateway + gouvernance + observabilité + MCP dans un seul plan de contrôle, avec la possibilité d'un déploiement on-prem ou air-gapped, et non pas un simple VPC au forfait le plus élevé.
  • Une rétention qu'elles contrôlent. Une fenêtre fixe de logs de 30 jours est trop juste pour l'analyse d'incidents et les audits. Les équipes veulent ajuster la rétention selon leurs exigences de conformité, et non selon leur grille tarifaire.

TrueFoundry est conçu exactement pour cela : une gateway unifiée compatible OpenAI intégrant le routage (latence, poids, priorité), le fallback avec réessais intra-requête, le caching exact et sémantique, des budgets et limites de débit par utilisateur/équipe/modèle, une observabilité par requête avec attribution des coûts, des guardrails intégrés, ainsi que le RBAC, le SSO, le SCIM et l'audit, plus une MCP gateway, le tout dans un seul plan de contrôle déployable en SaaS, dans votre VPC, on-prem ou air-gapped avec le data plane restant dans votre réseau. La gouvernance n'est pas un forfait supérieur : c'est le cœur même du produit. Pour une vision globale du cadre de sélection, consultez comment choisir une AI gateway.

Découvrez comment TrueFoundry consolide gateway, gouvernance et observabilité dans une plateforme unique. Réservez une démo.

Le parcours de migration

La migration est progressive et réversible. Vous ne basculez pas tout d'un coup, et comme les deux gateways s'appuient sur l'API compatible OpenAI, les modifications côté client sont minimales.

The migration path: inventory configs and virtual keys, map concepts, run both in parallel via a base-URL swap, migrate observability and retention expectations, cut over by team, then decommission.
Le parcours de migration : inventorier les configurations et clés virtuelles, mapper les concepts, exécuter en parallèle via le changement de base-URL, migrer les attentes en matière d'observabilité et de rétention, basculer par équipe, puis décommissionner.

Étape 1 : Inventaire

Lister l'ensemble des éléments pris en charge par Portkey :

  • Chaque config (les définitions de routage, fallback, caching et réessai).
  • Chaque clé virtuelle, l'application ou l'équipe qui l'utilise, ainsi que ses limites.
  • Tous les guardrails configurés et les ressources de gestion des prompts si vous utilisez cette fonctionnalité.
  • Les identifiants de fournisseurs détenus par Portkey.
  • Vos exigences en matière de rétention des logs et de conformité.
  • Chaque appelant : les applications, services et batchs pointant vers le endpoint de Portkey, ainsi que leurs URL de base.

Formulez explicitement vos exigences de rétention et de conformité. L'une des raisons de votre migration étant probablement que 30 jours ne suffisent pas, définissez votre cible dès maintenant (par exemple 180 ou 365 jours) comme une exigence clé du projet.

Étape 2 : Mapper les concepts

Traduisez les concepts Portkey vers leurs équivalents TrueFoundry. Les fonctionnalités se recoupent, il s'agit donc d'une réorganisation et non d'une reconstruction complète.

Concept PortkeyÉquivalent TrueFoundry
Clé virtuelle (clé API restreinte)Accès lié à l'identité via RBAC + budgets et limites de débit par utilisateur/équipe/modèle
Config (routage/fallback/réessai)Politique déclarative : routage et fallback avec réessais intra-requête, sous contrôle de version et d'audit
Caching (hébergé)Caching exact et sémantique
Logs hébergés (30 jours en Pro)Observabilité par requête avec rétention personnalisée, étiquetée par utilisateur/équipe/modèle
GuardrailsGuardrails intégrés sur le parcours de la requête (PII, injection de prompt, secrets)
Gestion des promptsRessources de gestion des prompts
SSO/PII/VPC (réservés à l'offre Enterprise)RBAC, SSO, SCIM, audit et déploiement VPC/on-prem/air-gapped inclus en standard
Clés de fournisseurs disperséesSecrets centralisés, restreints et renouvelés

Étape 3 : Exécution en parallèle

C'est ce qui garantit la sécurité de la migration. Portkey et TrueFoundry proposant tous deux une API compatible OpenAI, le seul changement requis pour un client est l'URL de base. Aucun changement de SDK, aucune réécriture du format de requête, aucune modification du parsing de réponse.

Déployez TrueFoundry aux côtés de Portkey. Orientez un service peu critique vers la nouvelle URL de base et vérifiez : les réponses correspondent, l'observabilité affiche le trafic avec une attribution précise des coûts, les budgets et guardrails réagissent comme configuré, et le cache fonctionne comme prévu. Les deux endpoints étant actifs simultanément, vous pouvez les comparer directement et rétablir l'URL de base de Portkey en quelques secondes en cas d'anomalie.

Un exemple concret : si votre service lit son endpoint depuis OPENAI_API_BASE, migrer ce service consiste à changer une seule variable d'environnement puis à redémarrer ; faire marche arrière implique simplement la manipulation inverse. C'est le seul impact côté client lorsque les deux gateways partagent la même API.

Étape 4 : Migrer les exigences d'observabilité et de rétention

Cette étape est propre à la migration depuis Portkey, car la durée de rétention est souvent le déclencheur de la démarche. Avant de basculer le trafic de production, confirmez que l'observabilité de TrueFoundry capture bien les données présentes dans les logs de Portkey — jetons par requête, latence, modèle et coût — et que la rétention est ajustée sur votre durée cible plutôt que limitée aux 30 jours imposés. Validez que l'attribution des coûts catégorise les données par équipe conformément aux besoins du FinOps : passer de logs hébergés agrégés à une observabilité par requête étiquetée par équipe constitue l'un des bénéfices majeurs de cette migration. Notre vue d'ensemble sur les outils d'observabilité LLM détaille ce que doit intégrer une observabilité par requête performante.

Étape 5 : Basculer équipe par équipe

Migrez le trafic par vagues, par équipe ou par application :

  1. Sélectionnez une équipe. Créez ses accès TrueFoundry, son rôle RBAC, ses budgets et son périmètre de catalogue de modèles, en répliquant les limites de ses anciennes clés virtuelles Portkey.
  2. Remplacez l'URL de base de ses services par celle de TrueFoundry.
  3. Suivez l'observabilité pendant une période de rodage définie : attribution des coûts, latence, taux d'erreur, taux de réussite du cache et comportement des guardrails.
  4. Passez à l'équipe suivante.

Ce basculement par équipe offre un périmètre de retour en arrière très clair et vous permet de définir précisément les budgets et les accès de chacune au fur et me mesure, plutôt que de transposer un ensemble complexe de clés virtuelles partagées en une seule étape risquée.

Étape 6 : Décommissionnement

Lorsque tous les services pointent vers TrueFoundry et ont tourné suffisamment longtemps pour confirmer la stabilité, vous pouvez décommissionner Portkey : interrompez le routage vers celui-ci, supprimez les secrets des fournisseurs dans ses configurations et renouvelez ces identifiants pour invalider les anciennes copies. Assurez-vous qu'aucun job, notebook ou étape de CI ne pointe encore vers l'ancien endpoint avant de le couper. La migration est terminée lorsqu'il n'existe plus qu'un seul chemin sécurisé vers chaque modèle, sans aucune configuration Portkey orpheline contenant des clés actives.

Portkey face à un plan de contrôle unifié

La différence structurelle — et la raison pour laquelle cette migration est pertinente pour les équipes concernées — réside dans la localisation de la gouvernance.

FonctionnalitéPortkeyPlan de contrôle unifié (TrueFoundry)
Routage / fallback / load balancingNoyau OSS et supérieurStandard
Observabilité, clés virtuelles, caching, gestion des promptsProduit hébergéStandard
SSO, SCIM, auditOffre Enterprise uniquementStandard
VPC / souscription privéeOffre Enterprise uniquementVPC, on-prem ou air-gapped ; data plane dans votre réseau
Gestion des PII / conformité (BAA)Offre Enterprise uniquementGuardrails intégrés + gouvernance en standard
Rétention des logs3 jours (Dev), 30 jours (Pro), sur mesure (Ent)Définie par vos soins
Gouvernance des coûtsLimites par cléBudgets + limites de débit par utilisateur/équipe/modèle, attribution des coûts par équipe
Gouvernance MCPOutil séparéMCP gateway intégrée au même plan de contrôle
Transparence tarifaire de la gouvernanceSur devis (Enterprise)Gouvernance accessible sans palier tarifaire restreint

L'enjeu n'est pas de dire que Portkey ne propose pas ces fonctionnalités : son offre Enterprise en couvre une grande partie. L'élément déterminant est que, pour une équipe nécessitant le SSO, un VPC et une rétention adaptée, ces éléments sont inclus en standard dans un plan de contrôle unifié, au lieu de servir de levier pour une négociation commerciale sur mesure. Pour les équipes qui encadrent également l'accès aux outils MCP, la consolidation au sein d'une même plateforme est détaillée dans notre guide sur la gouvernance enterprise de MCP.

Les erreurs fréquentes à éviter

Migrer sans avoir défini la cible de rétention. La raison principale pour laquelle de nombreuses équipes quittent Portkey est le plafond de 30 jours sur les logs ; pourtant, certaines migrent sans formaliser la durée dont elles ont réellement besoin. Définissez la fenêtre cible comme une exigence explicite dès le départ afin de la valider lors de la phase de fonctionnement en parallèle, et non après le basculement définitif.

Recréer les clés virtuelles partagées à l'identique. Les environnements Portkey accumulent souvent des clés virtuelles partagées. Les reproduire à l'identique réintroduit des accès non contrôlés dans le nouveau système. Profitez du basculement pour configurer le RBAC par équipe en vous appuyant sur votre fournisseur d'identité, ce qui constitue l'un des bénéfices majeurs de cette démarche.

Réduire la migration à un simple changement d'URL de base. Si l'API compatible OpenAI simplifie la modification côté client, la valeur ajoutée réside dans la gouvernance : SSO, RBAC, budgets, audits et rétention sous votre contrôle. Modifier les URL sans paramétrer cette gouvernance revient à changer de gateway tout en conservant les mêmes manques.

Oublier de renouveler les secrets lors du décommissionnement. Si vous coupez Portkey mais laissez actives les clés de fournisseurs qu'il contenait, ces identifiants restent exploitables dans un système arrêté et non surveillé. Renouvelez systématiquement chaque secret présent dans l'ancienne gateway au moment de sa fermeture.

Bascule globale instantanée (« Big-bang »). Faire basculer l'ensemble de l'organisation en une seule fois supprime toute possibilité de retour arrière ciblé. L'exécution en parallèle et la migration progressive par équipe permettent de meuler chaque problème à l'échelle d'une seule équipe, avec la possibilité de revenir en arrière via un simple changement d'URL de base.

Conclusion

Migrer depuis Portkey est rarement une question de fonctionnalités globales : c'est avant tout une question de répartition de ces fonctionnalités dans la grille tarifaire. Lorsque le SSO, le VPC, la gestion des PII et une rétention étendue des logs sont réservés à une offre Enterprise sur mesure, une équipe ayant besoin de ces options doit choisir entre une négociation opaque et le passage à une plateforme où la gouvernance et la flexibilité de déploiement sont intégrées d'origine.

La transition en elle-même comporte très peu de risques. Les deux gateways s'appuyant sur l'API compatible OpenAI, la modification côté client se limite généralement à l'URL de base. Dressez l'inventaire de vos configurations et de vos clés virtuelles, associez-les au RBAC, aux politiques et à l'observabilité, validez la rétention pendant une phase d'exécution en parallèle, basculez équipe par équipe, puis décommissionnez l'ancien système en renouvelant l'ensemble des secrets. En suivant cette méthode, vous consolidez gateway, gouvernance, observabilité et MCP au sein d'un plan de contrôle unique, déployé sur votre propre réseau, sans réécriture de code.

Passez de Portkey à un plan de contrôle unifié. Réservez une démo.

Try now.

One gateway for all your models, MCP servers, and agents. No credit card needed.

INSCRIVEZ-VOUS
Table des matières

Gouvernez, déployez et suivez l'IA dans votre propre infrastructure

Réservez un séjour de 30 minutes avec notre Expert en IA

Réservez une démo

Le moyen le plus rapide de créer, de gérer et de faire évoluer votre IA

Démo du livre
Summarize with
ChatGPT logo by OpenAI
Perplexity AI logo
Blurry red snowflake on white background, symmetrical frosty design with soft edges and abstract shape.

Découvrez-en plus

Aucun article n'a été trouvé.
novembre 20, 2026
|
5 min de lecture

Grok 4.3 on Amazon Bedrock: We Routed Four Frontier Models Through One Gateway and Measured the Cost

Outils LLM
comparaison
novembre 20, 2026
|
5 min de lecture

Alternatives au bifrost : les meilleurs outils que vous pouvez envisager en 2026

Aucun article n'a été trouvé.
novembre 20, 2026
|
5 min de lecture

GPT-6.1 Terra : API, benchmarks, tarification et mode d'emploi

Aucun article n'a été trouvé.
novembre 20, 2026
|
5 min de lecture

GPT-5.1 vs GPT-5 : 9 améliorations majeures à connaître

LLM et GenAI
Aucun article n'a été trouvé.
Faites un rapide tour d'horizon des produits
Commencer la visite guidée du produit
Visite guidée du produit