Pular para o conteúdo principal
Troque a URL base para 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

Mantenha o payload inalterado na primeira rodada e alcance a paridade antes de otimizar. Remova 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:
A lista padrão contém apenas os modelos que você pode chamar agora; adicione 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:
Antes de mover uma parte relevante do tráfego, confirme que:
  • OPENROUTER_API_KEY foi substituída por PHASEO_API_KEY em 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/completions ou /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, quando replay_supported é true, refeita a partir de replay_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

  1. Comece pelo tráfego interno.
  2. Mova de 5% a 10% do tráfego de produção e compare qualidade, latência e custo.
  3. Passe para 100% quando a paridade estiver confirmada.
  4. 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:
  1. Procure no código de runtime e na configuração de implantação por openrouter.ai, OPENROUTER_API_KEY, sk-or-v1, HTTP-Referer e X-Title.
  2. Troque a fronteira do cliente para https://api.phaseo.app/v1 e PHASEO_API_KEY sem adicionar nenhum valor secreto ao controle de versão.
  3. Consulte GET /v1/models?format=openai e registre cada mapeamento de modelo antigo para novo.
  4. Adapte as opções de roteamento ou os campos de resposta exclusivos do OpenRouter em um único módulo de compatibilidade.
  5. Execute as verificações de saúde, sem streaming, com streaming e de caminho de falha acima.
  6. 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.
Para uma versão guiada, abra o guia interativo de migração do OpenRouter, veja como os dois se comparam ou receba ajuda gratuita na migração.
Última modificação em 5 de novembro de 2026