Pular para o conteúdo principal
Encontre cada recurso que a integração com o seu gateway atual usa e faça o que a última coluna indica antes de mover o tráfego. Última revisão em 4 de novembro de 2026. Siga a migração nesta ordem. Ela revela os comportamentos que podem mudar mesmo quando as duas plataformas aceitam a mesma solicitação compatível com OpenAI.

Inventarie a fronteira da integração

Registre cada lugar em que o gateway atual aparece, para que a migração não deixe um segundo caminho de configuração escondido:
  • URLs base e variáveis de ambiente de chaves de API;
  • inicialização do SDK e cabeçalhos personalizados;
  • IDs de modelo e modelos de fallback;
  • ordem de provedores, listas de permissão e requisitos de privacidade;
  • código de streaming, chamada de ferramentas e saída estruturada;
  • jobs em lote, arquivos, webhooks e consulta de status assíncrono;
  • atribuição de solicitações e metadados de usuário ou sessão.

Solicitações

Roteamento e políticas

Operações

Não disponível

Estes recursos não têm equivalente no Phaseo. Mantenha-os no app ou na plataforma antiga:
  • Cache de respostas. O Phaseo não armazena respostas em cache. O cache de prompts ainda reduz o custo de entrada.
  • Respostas e conversas armazenadas. Não existe GET nem DELETE /v1/responses/{id}.
  • Contagem de tokens (/v1/messages/count_tokens).
  • OpenAI Assistants, Threads, vector stores, fine-tuning e o legado /v1/completions.

Classifique cada recurso

Atribua um status a cada comportamento de produção, usando as tabelas acima e o guia da sua plataforma de origem:

Valide com o seu próprio tráfego

A compatibilidade da API não faz com que estes itens se comportem igual:
  • seleção automática de provedores e ordem de fallback;
  • afinidade do cache de prompts e preço do cache;
  • campos de solicitação específicos do provedor e metadados presentes só na resposta;
  • limites de taxa e tempo entre novas tentativas;
  • políticas de retenção, residência e treinamento de dados;
  • disponibilidade exata e preço dos modelos.
Monte um pequeno conjunto de testes a partir de padrões reais da carga de trabalho, sem copiar dados sensíveis de produção, e execute:
  1. uma solicitação normal para cada endpoint em uso;
  2. streaming pelo mesmo caminho de cliente da produção;
  3. chamadas de ferramentas e saídas estruturadas com esquemas realistas;
  4. cada restrição de provedor ou de privacidade;
  5. chaves inválidas, modelos inválidos, limites de taxa e falhas de provedor indisponível;
  6. jobs em lote ou assíncronos passando por sucesso, falha e cancelamento.
Compare a qualidade da saída, a latência, o uso de tokens, o provedor selecionado e o custo final. Registre o ID de cada solicitação para inspecioná-la nos logs de solicitações ou com GET /v1/generations?id=<request_id>.

Faça o rollout com uma chave reversível

Comece pelo tráfego de desenvolvimento e interno. Mova uma pequena parte da produção só depois que o conjunto de testes passar, e mantenha o rollback limitado à URL base e à chave até os resultados se estabilizarem. Não combine a virada com mudanças de prompt, modelo ou roteamento; faça essas mudanças depois que a fronteira do gateway estiver verificada.
Última modificação em 5 de novembro de 2026