Migração do Vercel AI Gateway

​

O que muda

​

Antes de começar

• URL base e configuração atual da chave do Vercel AI Gateway.
• PHASEO_API_KEY disponível nos ambientes local, de teste e de produção.
• Um conjunto pequeno de prompts ou testes que cubra requisições sem e com streaming e os caminhos de chamada de ferramentas usados.

​

1) Documente o ponto de integração atual com o gateway

• Localize a fábrica de provedores ou clientes.
• Liste os IDs de modelo usados em produção.
• Registre os padrões de novas tentativas, tempos limite e alternativas.
• Anote se os ambientes edge e de servidor precisam da mesma alteração.
• Identifique padrões compartilhados de prompts ou parâmetros que deveriam virar predefinições do Gateway, em vez de ficarem embutidos em chamadas do AI SDK.

​

2) Troque o endpoint e a chave

// OpenAI-compatible client before
import OpenAI from "openai";

const before = new OpenAI({
  apiKey: process.env.VERCEL_AI_GATEWAY_API_KEY,
  baseURL: "https://ai-gateway.vercel.sh/v1",
});

// OpenAI-compatible client after
import OpenAI from "openai";

const after = new OpenAI({
  apiKey: process.env.PHASEO_API_KEY,
  baseURL: "https://api.phaseo.app/v1",
});

// Official Phaseo provider for the Vercel AI SDK
import { generateText } from "ai";
import { createPhaseo } from "@phaseo/ai-sdk-provider";

const phaseo = createPhaseo({
  apiKey: process.env.PHASEO_API_KEY,
  baseURL: "https://api.phaseo.app/v1",
});

const { text } = await generateText({
  model: phaseo("openai/gpt-4.1-mini"),
  prompt: "Generate a migration checklist.",
});

curl -s "https://api.phaseo.app/v1/chat/completions" \
  -H "Authorization: Bearer $PHASEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4.1-mini",
    "messages": [{"role":"user","content":"Hello"}]
  }'

​

3) Confirme a paridade de comportamento

• Verifique a geração de texto sem streaming.
• Verifique os fragmentos de streaming pelo mesmo caminho de código usado em produção.
• Verifique chamadas de ferramentas se o aplicativo depender delas.
• Confirme que o mapeamento de erros no aplicativo não mudou.
• Mova padrões duradouros de roteamento e restrições de provedores para Predefinições ou Roteamento e alternativas, em vez de recriá-los em cada fábrica de modelos.

​

4) Lista de verificação do Vercel AI SDK e do Gateway

• URL base atualizada para https://api.phaseo.app/v1.
• PHASEO_API_KEY configurada em todos os ambientes que usavam a chave do gateway da Vercel.
• Provedor oficial @phaseo/ai-sdk-provider integrado se o aplicativo usa Vercel AI SDK diretamente.
• O principal caminho de geração de texto do AI SDK funciona no ambiente de teste.
• Um teste de streaming no aplicativo passa sem alterações.
• Chamadas de ferramentas e saídas estruturadas verificadas novamente, se usadas.
• Saídas antiga e nova comparadas com um pequeno conjunto de prompts.
• Rollback possível somente por alteração de configuração ou feature flag.
• Padrões compartilhados de prompts e roteamento movidos para predefinições quando apropriado.
• Consultas verificadas com GET /v1/generations?id=<request_id> para reproduzir falhas pelo payload replay_request armazenado quando replay_supported=true.

​

5) Plano de lançamento de baixo risco

1. Publique atrás de uma feature flag ou faça uma liberação gradual.
2. Comece com tráfego interno ou uma parcela pequena do tráfego de produção.
3. Monitore latência, taxa de erros e variações de tokens e custos.
4. Mantenha as duas configurações disponíveis por pelo menos um ciclo de lançamento.

​

Comandos de validação

curl -s "https://api.phaseo.app/v1/health"
curl -s "https://api.phaseo.app/v1/models" -H "Authorization: Bearer $PHASEO_API_KEY"

• Execute o principal teste de integração de geração de texto do aplicativo.
• Execute um teste de streaming no ambiente de teste.
• Compare as saídas dos principais prompts antes da migração completa.

​

Próximas etapas

• Migração do OpenRouter
• Início rápido
• Exemplos