Migração do OpenRouter para o Phaseo

​

O que muda

1. Mantenha o formato do payload.
2. Troque a URL base e a origem da chave de API.
3. Verifique os IDs de modelo e cabeçalhos exclusivos do OpenRouter.
4. Aumente o tráfego gradualmente e compare latência, respostas e custos.

​

Antes de começar

• Acesso ao código atual da integração com OpenRouter e à configuração de deploy.
• PHASEO_API_KEY disponível em desenvolvimento, testes e produção.
• Uma lista curta de IDs de modelo em produção e prompts representativos.

​

1) Faça o inventário do uso atual do OpenRouter

• Procure endpoints openrouter.ai.
• Procure OPENROUTER_API_KEY no código, na CI e nas variáveis de ambiente da hospedagem.
• Procure cabeçalhos exclusivos, como HTTP-Referer e X-Title.
• Documente IDs de modelo ativos e a lógica de fallback.
• Identifique padrões reutilizáveis de prompts, provedores ou parâmetros que devem virar predefinições do Gateway, em vez de ficar duplicados no código.

​

2) Troque a URL base e as credenciais

// Before
import OpenAI from "openai";

const before = new OpenAI({
  apiKey: process.env.OPENROUTER_API_KEY,
  baseURL: "https://openrouter.ai/api/v1",
});

const response = await before.chat.completions.create({
  model: "openai/gpt-4.1-mini",
  messages: [{ role: "user", content: "Summarize our migration plan." }],
});

// After
import OpenAI from "openai";

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

const response = await after.chat.completions.create({
  model: "openai/gpt-4.1-mini",
  messages: [{ role: "user", content: "Summarize our migration plan." }],
});

# Before
curl -s "https://openrouter.ai/api/v1/chat/completions" \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4.1-mini",
    "messages": [{"role":"user","content":"Say hello"}]
  }'

# After
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":"Say hello"}]
  }'

​

3) Valide os IDs de modelo e mapeie comportamentos exclusivos do OpenRouter

curl -s "https://api.phaseo.app/v1/models" \
  -H "Authorization: Bearer $PHASEO_API_KEY" | jq '.data[0:10] | map(.id)'

• Mantenha o formato Authorization: Bearer.
• Mantenha HTTP-Referer e X-Title se identificarem o aplicativo que faz a chamada. O Phaseo também aceita as formas em minúsculas http-referer e x-title.
• Se os clientes dependerem de campos de resposta exclusivos do OpenRouter, adapte-os em uma única camada de compatibilidade.
• Se a configuração usar listas de provedores permitidos ou bloqueados e padrões de roteamento, mova-os para Predefinições e Roteamento e alternativas.

​

Mapeie os controles de provedores

​

4) Lista de verificação de paridade com OpenRouter

• URL base atualizada para https://api.phaseo.app/v1.
• OPENROUTER_API_KEY substituída por PHASEO_API_KEY em todos os ambientes.
• Todos os IDs de modelo de produção verificados em /v1/models.
• Uma requisição sem streaming validada por /v1/chat/completions ou /v1/responses.
• Uma requisição com streaming validada pelo mesmo caminho de integração usado em produção.
• Consultas GET /v1/generations?id=<request_id> verificadas para reproduzir falhas pelo replay_request armazenado quando replay_supported=true.
• Chamadas de ferramentas e saídas estruturadas verificadas novamente com prompts reais.
• Falhas de chave e modelo inválidos verificadas em testes.
• Cabeçalhos e campos de resposta exclusivos do OpenRouter removidos ou normalizados explicitamente.
• Padrões compartilhados de prompts/roteamento movidos para predefinições quando apropriado.

​

Lista de migração para um agente

1. Procure openrouter.ai, OPENROUTER_API_KEY, sk-or-v1, HTTP-Referer e X-Title no código e na configuração de deploy.
2. Altere a camada do cliente para https://api.phaseo.app/v1 e PHASEO_API_KEY sem salvar segredos no repositório.
3. Consulte GET /v1/models e registre cada mapeamento de modelo.
4. Adapte opções de roteamento ou campos de resposta exclusivos do OpenRouter em um único módulo de compatibilidade.
5. Execute as verificações de saúde, modelos, requisições, streaming e falhas abaixo.
6. Relate arquivos alterados, nomes de segredos, mapeamentos, evidências de teste, diferenças de paridade e a opção de rollback.

​

5) Faça o rollout com segurança

1. Comece apenas com tráfego interno.
2. Passe para 5–10% do tráfego de produção e compare qualidade, latência e custo.
3. Passe a 100% somente depois de confirmar a paridade.
4. Até a estabilização, mantenha o rollback como uma simples troca de URL e chave.

​

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

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

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

• Faça uma requisição com streaming pelo teste de integração do aplicativo.
• Faça um teste negativo com chave ou modelo inválido.
• Reproduza um pequeno conjunto de prompts de referência e compare os resultados.

​

Próximas etapas

• Obtenha ajuda gratuita para migrar sua integração com OpenRouter
• Abra o guia interativo de migração do OpenRouter
• Compare Phaseo e OpenRouter
• Início rápido
• Referência da API: modelos
• Exemplos
• Tratamento de erros