Pular para o conteúdo principal
No código com AI SDK, troque @ai-sdk/gateway por @phaseo/ai-sdk-provider e envolva cada ID de modelo com phaseo(...). Em clientes compatíveis com OpenAI, troque a URL base e a chave. A lógica de geração continua a mesma.

Troque o provedor

O export padrão phaseo lê PHASEO_API_KEY uma única vez, quando o módulo é importado, e usa https://api.phaseo.app/v1. Se a variável for definida depois dos imports, como em algumas configurações serverless e de testes, toda chamada lança um erro de chave ausente; nesse caso, chame createPhaseo({ apiKey, baseURL, headers }) dentro do handler. Instale a linha do provedor que corresponde à versão principal do seu ai: @phaseo/ai-sdk-provider para o AI SDK 7, @phaseo/ai-sdk-provider@ai-sdk-v6 para o AI SDK 6 e @phaseo/ai-sdk-provider@ai-sdk-v5 para o AI SDK 5. Por padrão, o AI SDK envia modelos como string simples (model: "openai/gpt-4.1-mini") pelo gateway da Vercel, então uma string simples esquecida continua chamando esse gateway. Altere uma vez a fábrica de modelos compartilhada e depois procure model: " nas chamadas do AI SDK. Clientes do SDK da Anthropic apontados para ai-gateway.vercel.sh passam para a configuração descrita em Migração do SDK da Anthropic.

Mapeie as opções do gateway

providerOptions.phaseo é mesclado ao corpo da solicitação. Um providerOptions.gateway esquecido é ignorado sem erro.

Teste e faça o rollout

Execute o mesmo conjunto de prompts pelos dois caminhos e compare latência, formato da saída e uso de tokens. Antes de promover o tráfego, confirme que:
  • PHASEO_API_KEY está definida em todo runtime que tinha a chave do gateway, incluindo edge, servidor e implantações de preview;
  • o caminho principal de geração de texto e um teste de streaming passam sem alterações em staging;
  • chamadas de ferramentas e saídas estruturadas passam, se o app as usa;
  • o mapeamento de erros no nível da aplicação continua funcionando;
  • uma solicitação de staging com falha pode ser encontrada e, quando replay_supported é true, refeita a partir de GET /v1/generations?id=<request_id>.
Lance atrás de uma feature flag ou de um rollout por porcentagem, começando pelo tráfego interno. Acompanhe a latência, a taxa de erros e os desvios de tokens e custo, e mantenha o provedor antigo disponível por pelo menos uma release para que o rollback não exija mudança de código.
Para saber mais sobre o provedor, veja AI SDK.
Última modificação em 7 de novembro de 2026