O que é o Phaseo
O Phaseo é um gateway: uma API e uma chave na frente de muitos modelos e dos provedores que os hospedam.
O Phaseo é um gateway de IA. Você envia todas as solicitações para uma única API, https://api.phaseo.app/v1, com uma única chave. O Phaseo repassa cada solicitação a um provedor que pode atendê-la e cobra o uso do seu espaço de trabalho. Você pode usar o formato da API Responses, Chat Completions ou Messages, o que o seu app já usar.
Modelos e provedores são coisas diferentes. Um modelo é o sistema que escreve a resposta. Um provedor hospeda o modelo e define o preço, a velocidade, a disponibilidade e os parâmetros aceitos. Um modelo pode ter vários provedores.
Um ID de modelo identifica o modelo, não o provedor. Os IDs têm o formato openai/gpt-6-astra ou anthropic/claude-sonnet-5.5: primeiro o laboratório, depois o modelo. phaseo/free escolhe um modelo gratuito disponível e funciona sem créditos. Se você precisa de um provedor específico, pode colocá-lo na frente do ID, por exemplo baseten:thinking-machines/inkling-small.
Como uma solicitação é roteada:
- O Phaseo mantém só os provedores que as configurações do seu espaço de trabalho e a solicitação permitem.
- Ele os classifica. O modo padrão,
balanced, pondera preço, velocidade e confiabilidade. - Ele chama o primeiro provedor. Se esse provedor falhar, tenta o próximo.
- Se todos os provedores falharem com um erro que pode ser repetido e você tiver listado modelos alternativos em
models, ele tenta o próximo modelo.
As alternativas não garantem sucesso, então o seu app ainda deve repetir erros 429 e 5xx com backoff. Mais um detalhe: o catálogo público lista alguns modelos que ainda não podem ser chamados. Confira se um modelo está Ativo no Gateway antes de usar o ID dele.
Confira o que você aprendeu
Você chama um modelo hospedado por três provedores, e o provedor mais bem classificado retorna um erro. O que o Phaseo faz em seguida?
Aplique
Um colega encontrou um modelo na página Modelos do Phaseo e copiou o ID dele para uma solicitação. A solicitação falha, mas a página do modelo parece normal. Qual é o motivo mais provável, e como você confere?
Mostrar a respostaOcultar a resposta
O catálogo lista mais modelos do que o Gateway consegue chamar. O modelo pode estar como Em breve ou Inativo. Na página Modelos, o filtro de status do Gateway mostra por padrão os modelos Ativos no Gateway, e GET /v1/models retorna só os modelos que você pode chamar. Escolha um modelo que esteja Ativo no Gateway.
Resumo
Links relacionados
Verificado em 17 de novembro de 2026