https://api.phaseo.app/v1 e a chave para PHASEO_API_KEY. Os payloads das solicitações, o cabeçalho Authorization: Bearer, o objeto provider e o array de fallback models continuam funcionando; confira os IDs de modelo e os poucos campos da tabela abaixo.
Troque o cliente
OPENROUTER_BASE_URL e a chave antiga do código, da CI e das configurações de hospedagem. @openrouter/ai-sdk-provider vira @phaseo/ai-sdk-provider (veja Migração do Vercel AI Gateway); os SDKs próprios do OpenRouter (@openrouter/sdk, openrouter no PyPI) exigem uma troca de cliente, não apenas uma nova URL base.
Confira os IDs de modelo
A maioria dos IDs coincide, mas algumas orgs são diferentes:x-ai/ é spacex-ai/, meta-llama/ é meta/ e mistralai/ é mistral/. Liste os IDs do Phaseo e confira cada modelo de produção com eles:
availability=all para ver os inativos ou os que estão por vir. Sem format=openai, a resposta é a lista paginada models do Phaseo, que não tem array data.
Mapeie os campos da solicitação
O Phaseo também tem
provider.required_execution_region e provider.required_data_region, que não têm equivalente no OpenRouter. Veja Fixe ou ignore provedores e Roteie apenas para provedores na UE ou com ZDR para solicitações completas.
Mantenha os campos exclusivos do OpenRouter que restarem em um único adaptador, e não em cada ponto de chamada, para que o rollback continue sendo uma troca de URL base e chave.
Valide antes da virada
Execute estes comandos contra o Phaseo e depois as mesmas verificações pelo caminho de cliente do seu app:OPENROUTER_API_KEYfoi substituída porPHASEO_API_KEYem todos os ambientes;- cada ID de modelo de produção está em
GET /v1/models?format=openai; - uma solicitação sem streaming e uma com streaming passam por
/v1/chat/completionsou/v1/responses, usando o mesmo caminho de cliente da produção; - os fluxos de chamada de ferramentas e de saída estruturada passam com prompts reais;
- as falhas de chave inválida e de modelo inválido são tratadas;
- uma solicitação com falha pode ser consultada com
GET /v1/generations?id=<request_id>e, quandoreplay_supportedétrue, refeita a partir dereplay_request; - os cabeçalhos e campos de resposta exclusivos do OpenRouter foram removidos ou normalizados, e os padrões compartilhados ficam em predefinições.
Faça o rollout
- Comece pelo tráfego interno.
- Mova de 5% a 10% do tráfego de produção e compare qualidade, latência e custo.
- Passe para 100% quando a paridade estiver confirmada.
- Mantenha o rollback como uma troca de URL base e chave até a virada ficar estável.
Entregue a migração a um agente de código
Dê ao agente esta sequência delimitada, ou instale a skill de migração do OpenRouter para o Phaseo, que reúne as mesmas etapas de inventário, mapeamento, validação e rollback:- Procure no código de runtime e na configuração de implantação por
openrouter.ai,OPENROUTER_API_KEY,sk-or-v1,HTTP-ReferereX-Title. - Troque a fronteira do cliente para
https://api.phaseo.app/v1ePHASEO_API_KEYsem adicionar nenhum valor secreto ao controle de versão. - Consulte
GET /v1/models?format=openaie registre cada mapeamento de modelo antigo para novo. - Adapte as opções de roteamento ou os campos de resposta exclusivos do OpenRouter em um único módulo de compatibilidade.
- Execute as verificações de saúde, sem streaming, com streaming e de caminho de falha acima.
- Relate os arquivos alterados, as mudanças de nomes de secrets, os mapeamentos de modelos, as evidências de teste, as lacunas de paridade e a chave de rollback.