Lição 1 de 4 · 6 minutos

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:

  1. O Phaseo mantém só os provedores que as configurações do seu espaço de trabalho e a solicitação permitem.
  2. Ele os classifica. O modo padrão, balanced, pondera preço, velocidade e confiabilidade.
  3. Ele chama o primeiro provedor. Se esse provedor falhar, tenta o próximo.
  4. 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 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

Você escolhe o modelo; o Phaseo escolhe um provedor que o hospeda e recorre a outro quando um falha.

Links relacionados

O progresso fica salvo neste navegador.

Verificado em 17 de novembro de 2026