https://api.phaseo.app, passe sua chave do Phaseo como authToken e dê a cada modelo o ID dele no Phaseo.
Troque o cliente
Crie uma chave em Chaves de API e disponibilize-a para o app comoPHASEO_API_KEY.
- Use o host raiz.
baseURL: "https://api.phaseo.app/v1"gera/v1/v1/messages. Clientes compatíveis com OpenAI no mesmo repositório continuam usando/v1. - Envie a chave como bearer token. O gateway lê apenas
Authorization: Bearer; um cabeçalhox-api-keyrecebe401missing_or_invalid_authorization_header.authTokenenvia Bearer em todas as versões do SDK.apiKeysó faz isso a partir do@anthropic-ai/sdk1.0 e doanthropic2.0. - Remova
ANTHROPIC_API_KEYdos ambientes que agora chamam o Phaseo.apiKey: nullimpede que SDKs TypeScript mais antigos a leiam, e SDKs Python anteriores à 0.98 a leem mesmo quandoauth_tokenestá definido.
ANTHROPIC_BASE_URL=https://api.phaseo.app, ANTHROPIC_AUTH_TOKEN definido com a chave do Phaseo e ANTHROPIC_API_KEY vazio.
Mapeie os IDs de modelo
Confira cada modelo de produção emdata[].id de GET /v1/models?format=openai. Os IDs do Phaseo usam pontos na versão: claude-sonnet-5-5 vira anthropic/claude-sonnet-5.5. Se o modelo também estiver mudando, leia o guia de migração de modelos correspondente.
O que funciona de forma diferente
Teste e faça o rollout
Teste prompts de sistema, streaming, uso de ferramentas, thinking e saída estruturada com os IDs de modelo exatos que o app usa. Depois compare um conjunto representativo de prompts nas duas configurações quanto ao formato da saída, latência, uso de tokens, erros e custo. Antes de mover o tráfego, confirme que:- a chave do Phaseo está definida em todos os ambientes de implantação;
- cada ID de modelo de produção está em
GET /v1/models?format=openai; - os fluxos de streaming e de uso de ferramentas passam em staging;
- cada cabeçalho
anthropic-betae campo exclusivo de beta foi removido ou substituído; - o rollback ainda é só uma troca de URL base e chave.