Blank white background with no objects or features visible.

Olá, EMEA! A TrueFoundry está expandindo sua presença pela Europa, Oriente Médio e África. Leia mais. →

Como Migrar do Portkey para o TrueFoundry

Published: novembro 20, 2026

TL;DR
  • A capacidade do Portkey é dividida em níveis (tiers), e essa divisão é o gatilho da migração. O seu núcleo open-source faz apenas roteamento, fallback e balanceamento de carga. Observabilidade, chaves virtuais, caching e gerenciamento de prompts estão no produto hospedado. SSO, conformidade, VPC e anonimização de PII são exclusivos do plano Enterprise.
  • O plano Pro limita você rapidamente: $49/mês cobre cerca de 100 mil requisições com retenção de logs por 30 dias e sem SSO. Equipes que precisam de SSO, maior retenção ou VPC precisam saltar para o preço personalizado do plano Enterprise.
  • As equipes mudam para consolidar. Elas buscam SSO, conformidade e VPC sem um salto opaco para o Enterprise, governança de custos mais profunda ou um único plano de controle abrangendo gateway + governança + observabilidade + MCP com implantação on-premise ou air-gapped.
  • A migração é de baixo risco porque ambos usam a API compatível com a OpenAI. A principal alteração no cliente é a base URL; você executa ambos em paralelo e faz a transição equipe por equipe.
  • Mapeie conceitos, não reconstrua do zero: As chaves virtuais do Portkey tornam-se RBAC mais orçamentos, as configurações tornam-se políticas, os guardrails são mapeados diretamente e os logs hospedados tornam-se observabilidade por requisição com a retenção que você controla.

O Portkey é um gateway de AI capaz e, para uma equipe que se encaixa em seus níveis de preço, ele funciona bem. A dificuldade que muitas equipes enfrentam não é a capacidade em abstrato, mas onde cada capacidade se posiciona na estrutura de preços. O recurso que você precisa a seguir — SSO, uma janela de logs mais longa, uma implantação em VPC, anonimização de PII — tende a estar um nível acima de onde você está, e o nível mais alto possui preço personalizado e opaco.

Essa divisão em níveis é o que transforma uma avaliação do Portkey em uma conversa de migração. Uma equipe no plano Pro descobre que o SSO não está disponível no seu nível, que a retenção de logs de 30 dias não é suficiente para uma investigação de incidentes ou auditoria de conformidade, e que executar o data plane dentro de sua própria VPC exige o plano Enterprise. Nesse ponto, a questão passa a ser se deve negociar um contrato enterprise opaco para recursos que deveriam ser padrão, ou mudar para um gateway onde a governança e a flexibilidade de implantação não estejam bloqueadas pelo nível mais alto.

Este é um guia de migração para equipes nessa situação. Ele descreve a realidade dos níveis do Portkey de forma justa, aponta os motivos específicos pelos quais as equipes mudam e apresenta uma migração passo a passo para o TrueFoundry que é de baixo risco porque ambos os gateways usam a API compatível com a OpenAI. Na maioria dos casos, a alteração no cliente é apenas a base URL.

Quer SSO, VPC e governança profunda de custos sem barreiras de preços? Agende uma demonstração.

A realidade dos níveis do Portkey

Para planejar uma migração, você precisa de um mapa honesto do que o Portkey oferece em cada nível, pois toda a decisão gira em torno disso.

Portkey tier reality: what the OSS core, Pro, and Enterprise tiers each include, versus a single unified control plane where governance is not gated.
A realidade dos níveis do Portkey: o que o núcleo OSS, Pro e Enterprise incluem, versus um único plano de controle unificado onde a governança não é bloqueada por planos.

O núcleo open-source faz apenas roteamento. O gateway OSS do Portkey lida com roteamento, fallback e balanceamento de carga. Ele não inclui observabilidade, caching, chaves virtuais ou RBAC. Se você adotou o Portkey OSS esperando o produto completo, obteve apenas a camada de roteamento de requisições e nada mais.

O produto hospedado adiciona a camada operacional. Logs e traces, chaves virtuais, caching e gerenciamento de prompts vêm com o produto hospedado (gerenciado), não com o núcleo OSS. É aqui que a maioria das equipes realmente executa o Portkey.

O Enterprise bloqueia os recursos de governança e implantação. SSO, recursos de conformidade, VPC/tenancy privada, anonimização de PII e BAA são exclusivos do Enterprise, com preços personalizados. As capacidades mais relevantes para uma empresa regulada ficam atrás do nível sem preço público.

Os limites específicos do plano Pro. Os níveis publicados tornam o teto concreto:

Nível do PortkeyPreçoRequisiçõesRetenção de logsSSOVPC / Conformidade
DevGratuito~10K/mês3 diasNãoNão
Pro$49/mês~100K/mês30 diasNãoNão
EnterprisePersonalizadoPersonalizadoPersonalizadoSimSim (VPC, PII, BAA)

O salto do Pro para o Enterprise não é incremental. Não há um nível intermediário onde você possa comprar apenas SSO ou apenas retenção de 90 dias. No momento em que você precisa de qualquer recurso exclusivo do Enterprise, entra em uma negociação de preço personalizado, que é exatamente o atrito que leva as equipes a avaliar alternativas.

Por que as equipes migram para o TrueFoundry

Os motivos são específicos e se alinham com a divisão de níveis acima.

  • SSO, conformidade e VPC sem o salto opaco de preço. As equipes precisam de SSO integrado ao provedor de identidade, provisionamento SCIM, auditoria e a capacidade de executar o data plane em sua própria rede, sem que esses recursos essenciais de governança estejam bloqueados atrás de um contrato enterprise personalizado.
  • Governança de custos mais profunda. Além dos limites por chave, as equipes querem orçamentos e limites de taxa por usuário, equipe e modelo, com atribuição de custos real etiquetada por equipe, para que o time de FinOps possa alocar gastos com precisão em vez de ler um log agregado.
  • Consolidação em um único plano de controle. Em vez de ter um gateway em um lugar, observabilidade em outro e governança de MCP em um terceiro, as equipes querem gateway + governança + observabilidade + MCP em um único plano de controle, com implantação on-premise ou air-gapped disponível, não apenas VPC no nível mais alto.
  • Retenção sob seu controle. Uma janela fixa de logs de 30 dias é insuficiente para análise forense de incidentes e auditorias. As equipes querem definir a retenção de acordo com seus requisitos de conformidade, não de acordo com seu plano de preço.

O TrueFoundry é posicionado exatamente para isso: um gateway unificado compatível com a OpenAI com roteamento (latência, peso, prioridade), fallback com tentativas de reenvio na própria requisição (in-request retries), caching exato e semântico, orçamentos e limites de taxa por usuário/equipe/modelo, observabilidade por requisição com atribuição de custos, guardrails embutidos no fluxo, além de RBAC, SSO, SCIM e auditoria, e um gateway MCP — tudo em um plano de controle que pode ser implantado como SaaS, in-VPC, on-premise ou air-gapped, mantendo o data plane na sua rede. A governança não é um nível de preço; é o próprio produto. Para uma visão geral de seleção, veja como escolher um gateway de AI.

Veja como o TrueFoundry consolida gateway, governança e observabilidade em um único plano. Agende uma demonstração.

O caminho da migração

A migração é incremental e reversível. Você não altera tudo de uma vez e, como ambos os gateways usam a API compatível com a OpenAI, a alteração no lado do cliente é mínima.

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.
O caminho da migração: inventariar configurações e chaves virtuais, mapear conceitos, executar ambos em paralelo via alteração da base URL, migrar observabilidade e expectativas de retenção, fazer a transição por equipe e depois desativar o sistema antigo.

Passo 1: Inventário

Mapeie tudo o que o Portkey está fazendo por você:

  • Cada configuração (as definições de roteamento, fallback, caching e tentativas de reenvio).
  • Cada chave virtual e qual aplicativo ou equipe a utiliza, além de seus limites.
  • Quaisquer guardrails configurados e ativos de gerenciamento de prompts, caso utilize esse recurso.
  • Credenciais de provedores armazenadas no Portkey.
  • Sua expectativa de retenção de logs e qualquer requisito de conformidade que ela deva atender.
  • Cada chamador: os aplicativos, serviços e trabalhos (jobs) apontando para o endpoint do Portkey e as base URLs que utilizam.

Registre a expectativa de retenção e conformidade explicitamente. Um dos motivos da sua migração é provavelmente o fato de 30 dias não serem suficientes, portanto defina a meta (por exemplo, 180 ou 365 dias) agora, como um requisito da migração.

Passo 2: Mapear conceitos

Traduza os conceitos do Portkey para os seus equivalentes no TrueFoundry. As capacidades se sobrepõem, portanto trata-se de uma readequação, não de uma reconstrução do zero.

Conceito no PortkeyEquivalente no TrueFoundry
Chave virtual (chave API com escopo)Acesso vinculado à identidade via RBAC + orçamentos e limites de taxa por usuário/equipe/modelo
Configuração (roteamento/fallback/retry)Política declarativa: roteamento mais fallback com tentativas na própria requisição, sob controle de versão e auditoria
Caching (hospedado)Caching exato e semântico
Logs hospedados (30 dias no Pro)Observabilidade por requisição com retenção definida por você, etiquetada por usuário/equipe/modelo
GuardrailsInline guardrails no fluxo da requisição (PII, prompt injection, segredos)
Gerenciamento de promptsAtivos de gerenciamento de prompts
SSO/PII/VPC (exclusivos do Enterprise)RBAC, SSO, SCIM, auditoria e implantação em VPC/on-prem/air-gapped inclusos como padrão
Chaves de provedores dispersasSegredos centralizados, com escopo definido e rotação automatizada

Passo 3: Executar ambos em paralelo

É isso que torna a migração segura. Tanto o Portkey quanto o TrueFoundry expõem uma API compatível com a OpenAI, portanto a única alteração necessária no cliente é a base URL. Nenhuma alteração de SDK, nenhuma reescrita de estrutura de requisição, nenhuma alteração de parse de resposta.

Configure o TrueFoundry ao lado do Portkey. Aponte um serviço de baixo risco para a nova base URL e verifique: as respostas coincidem, a observabilidade mostra o tráfego com a atribuição correta de custos, os orçamentos e guardrails se comportam como configurados, e o caching funciona como esperado. Como ambos os endpoints estão ativos, você pode compará-los diretamente e reverter um serviço para a base URL do Portkey em segundos se algo estiver errado.

Um exemplo concreto: se o seu serviço lê o endpoint a partir de OPENAI_API_BASE, migrar esse serviço resume-se a alterar uma variável de ambiente e reiniciar a aplicação. Reverter a migração é apenas desfazer essa alteração. Esse é todo o impacto no lado do cliente quando ambos os gateways usam a mesma API.

Passo 4: Migrar observabilidade e expectativas de retenção

Este passo é específico para a migração do Portkey porque a retenção geralmente é o motivo da mudança. Antes de migrar o tráfego de produção, confirme se a observabilidade do TrueFoundry captura tudo o que os logs do Portkey capturavam — tokens por requisição, latência, modelo e custo — e se a retenção está configurada para a sua janela de destino, em vez dos 30 dias impostos pelo plano. Valide se a atribuição de custos etiqueta o tráfego por equipe conforme as necessidades de FinOps, pois mudar de logs hospedados agregados para uma observabilidade por requisição etiquetada por equipe é um dos ganhos concretos dessa migração. Nossa visão geral sobre ferramentas de observabilidade de LLM cobre o que uma boa observabilidade por requisição deve incluir.

Passo 5: Fazer a transição por equipe

Migre o tráfego em ondas, por equipe ou aplicação:

  1. Escolha uma equipe. Crie seu acesso no TrueFoundry, função RBAC, orçamentos e escopo do catálogo de modelos, espelhando os antigos limites da chave virtual do Portkey.
  2. Altere a base URL dos chamadores dessa equipe para o TrueFoundry.
  3. Acompanhe a observabilidade durante um período de teste definido: atribuição de custos, latência, taxa de erros, taxa de cache hits e comportamento dos guardrails.
  4. Migre a próxima equipe.

A transição por equipe fornece um limite seguro para reversão e permite definir orçamentos e acessos corretamente por equipe à medida que avança, em vez de portar um emaranhado de chaves virtuais compartilhadas em um único salto arriscado.

Passo 6: Desativação (Decommission)

Quando todos os chamadores estiverem apontando para o TrueFoundry e operando há tempo suficiente para garantir confiança, desative o Portkey: interrompa o roteamento para ele, remova os segredos de provedores de suas configurações e rotacione essas credenciais nos provedores para que as cópias antigas fiquem inativas. Confirme se nenhum job, notebook ou etapa de CI ainda aponta para o endpoint antigo antes de desligá-lo. A migração está concluída quando houver um único caminho governado para cada modelo e nenhuma configuração órfã no Portkey contendo chaves ativas.

Portkey vs um plano de controle unificado

A diferença estrutural — e o motivo pelo qual a migração vale a pena para as equipes certas — está em onde a governança se posiciona.

CapacidadePortkeyPlano de controle unificado (TrueFoundry)
Roteamento / fallback / balanceamento de cargaA partir do núcleo OSSPadrão
Observabilidade, chaves virtuais, caching, gestão de promptsProduto hospedadoPadrão
SSO, SCIM, auditoriaApenas no EnterprisePadrão
VPC / tenancy privadaApenas no EnterpriseVPC, on-premise ou air-gapped; data plane na sua rede
Tratamento de PII / conformidade (BAA)Apenas no EnterpriseGuardrails inline + governança padrão
Retenção de logs3 dias (Dev), 30 dias (Pro), personalizado (Ent)Definida por você
Governança de custosLimites por chaveOrçamentos + limites de taxa por usuário/equipe/modelo, atribuição de custos por equipe
Governança de MCPSolução separadaGateway MCP no mesmo plano de controle
Transparência de preços para governançaPersonalizado (Enterprise)Governança não bloqueada por planos opacos

O ponto principal não é que o Portkey carece desses recursos — o seu nível Enterprise possui muitos deles. O ponto é que, para uma equipe que precisa de SSO, VPC e retenção real de logs, esses recursos são padrão em um plano de controle unificado, em vez de serem motivos para entrar em uma negociação de preços personalizada. Para equipes que também gerenciam o acesso a ferramentas MCP, a consolidação disso no mesmo plano é abordada em governança de MCP enterprise.

Onde as equipes cometem erros

Migrar antes de definir a meta de retenção. O principal motivo pelo qual muitas equipes deixam o Portkey é o limite de 30 dias de logs, mas acabam migrando sem documentar a retenção que realmente precisam. Defina a janela desejada como um requisito explícito da migração para validá-la durante a execução em paralelo, e não após a transição final.

Portar chaves virtuais compartilhadas como estão. Implantações do Portkey costumam acumular chaves virtuais compartilhadas. Recriá-las exatamente como estão reconstrói um acesso sem governança no novo sistema. Aproveite a transição para definir o RBAC por equipe integrado ao seu provedor de identidade, que é um dos principais motivos da sua mudança.

Tratar a alteração da base URL como sendo toda a migração. A API compatível com a OpenAI torna a alteração no cliente trivial, mas o valor real está na governança: SSO, RBAC, orçamentos, auditoria e retenção sob seu controle. Alterar as URLs sem configurar a governança deixa você com um gateway diferente, mas com as mesmas lacunas.

Esquecer de rotacionar os segredos na desativação. Se você desligar o Portkey, mas deixar as chaves de provedor que ele continha sem rotação, essas credenciais continuarão ativas em um sistema desativado e não monitorado. Rotacione cada credencial mantida pelo gateway antigo como parte da desativação.

Fazer a transição no modelo "Big-Bang". Migrar toda a organização de uma só vez remove sua margem de segurança para reversão. A execução em paralelo e a transição equipe por equipe mantêm qualquer problema contido em uma única equipe e reversível com uma simples alteração de base URL.

Conclusão

Migrar do Portkey raramente é uma questão de capacidade em abstrato; trata-se de onde a capacidade se posiciona na estrutura de preços. Quando SSO, VPC, tratamento de PII e retenção real de logs vivem em um nível Enterprise com preço personalizado, a equipe que precisa desses recursos enfrenta a escolha entre uma negociação opaca e a mudança para uma plataforma onde governança e flexibilidade de implantação são padrão.

A mudança em si é de baixo risco. Ambos os gateways usam a API compatível com a OpenAI, portanto a alteração no cliente geralmente é apenas a base URL. Faça um inventário de suas configurações e chaves virtuais, mapeie-as para RBAC, políticas e observabilidade, valide a retenção durante a execução em paralelo, faça a transição equipe por equipe e desative o sistema antigo com uma rotação completa de segredos. Feito dessa forma, você consolida gateway, governança, observabilidade e MCP em um único plano de controle, implantado em sua própria rede, sem a necessidade de reescrever código.

Migre do Portkey para um plano de controle unificado. Agende uma demonstração.

Try now.

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

Start free
Table of Contents

One Gateway for Every LLM, Agent and MCP Server

Book a 30-min with our AI expert

Book a Demo

The fastest way to build, govern and scale your AI

Book Demo
Summarize with
ChatGPT logo by OpenAI
Perplexity AI logo
Blurry red snowflake on white background, symmetrical frosty design with soft edges and abstract shape.

Discover More

No items found.
novembro 20, 2026
|
5 min read

Grok 4.3 no Amazon Bedrock: Roteamos Quatro Modelos de Fronteira por um Único Gateway e Medimos o Custo

Ferramentas de LLM
comparação
novembro 20, 2026
|
5 min read

GPT-6.1 Terra: API, Benchmarks, Preço & Como Usar

No items found.
TrueFoundry AI gateway is an enterprise alternative to Bifrost and Portkey
novembro 20, 2026
|
5 min read

Bifrost vs Portkey: Precificação, Recursos de Gateway e Adequação Enterprise Comparados

No items found.
novembro 20, 2026
|
5 min read

Evolução do Machine Learning: Um Mergulho Profundo na Jornada de Savin

True ML Talks
No items found.
Take a quick product tour
Start Product Tour
Product Tour