Pular para o conteúdo principal
Adicione uma implantação dedicada ou auto-hospedada ao seu espaço de trabalho, e sua equipe passa a chamá-la pela API normal do Phaseo com um ID de modelo como acme/legal-assistant. Só o seu espaço de trabalho pode vê-la ou chamá-la, e ela funciona em qualquer lugar onde um ID de modelo público funciona.
Os modelos privados estão em Beta. Proprietários e administradores do espaço de trabalho os adicionam e gerenciam.
As origens mais comuns são implantações dedicadas no Baseten, Modal, RunPod, Fireworks ou Together, e servidores com vLLM ou outro servidor compatível com OpenAI.

Antes de começar

Sua implantação precisa oferecer:
  • uma URL base HTTPS pública;
  • um endpoint /chat/completions compatível com OpenAI;
  • autenticação por token Bearer; e
  • um ID de modelo ou de implantação upstream aceito por esse endpoint.
O suporte a /responses é opcional. Deixe-o desativado, a menos que a implantação implemente esse endpoint explicitamente.
Os Modelos privados não adaptam protocolos exclusivos de provedores nem esquemas de autenticação personalizados. Coloque uma camada compatível com OpenAI na frente dessas implantações ou use uma integração de provedor compatível do Phaseo.

Conectar uma implantação

1

Abra Modelos privados

Abra Painel → Configurações → Espaço de trabalho → Modelos privados e selecione Adicionar modelo. Você precisa ser proprietário ou administrador do espaço de trabalho. Para automatizar, chame POST /v1/private-models com os mesmos campos e uma chave de gerenciamento.
2

Dê um nome ao modelo

Escolha um modelo existente do catálogo para adicionar esta implantação à lista de provedores dele, ou digite um slug curto de modelo, como legal-assistant. Se nenhum modelo do catálogo tiver esse slug único, o Phaseo o combina com o namespace confiável do espaço de trabalho:
Você não pode escolher nem substituir o namespace do espaço de trabalho. IDs exatos do catálogo se vinculam a esse modelo sem alterar sua identidade pública.
3

Configure o endpoint

Digite a URL base antes do caminho de inferência. Por exemplo, use:
Não inclua /chat/completions nem /responses. Digite o ID exato do modelo ou da implantação upstream separadamente; o Phaseo o substitui ao encaminhar as solicitações.
4

Armazene a credencial

Digite a chave de API da implantação. O Phaseo criptografa a credencial e nunca a devolve depois de salva. Você pode substituí-la mais tarde na página de configurações do modelo.
5

Chame o modelo

Use o ID de modelo gerado com o endpoint normal de Chat Completions:
cURL
A chave de API que faz a chamada precisa pertencer ao mesmo espaço de trabalho do modelo privado.

Como o roteamento funciona

Um modelo autônomo do espaço de trabalho só é roteado para o endpoint configurado. Um endpoint vinculado a um modelo do catálogo entra na lista de provedores desse modelo de acordo com sua política de roteamento: O Phaseo envia a credencial armazenada como token Bearer e substitui o ID do modelo upstream configurado. Um modelo privado nunca se torna uma rota pública de provedor e não fica visível para outros espaços de trabalho. Os modelos privados habilitados entram no catálogo de modelos autenticado e aparecem no filtro Privados.
Depois de adicionar, alterar ou habilitar uma implantação privada, aguarde até um minuto antes de testar o roteamento. Até lá, algumas solicitações ainda podem usar a configuração anterior, como os provedores públicos do modelo. Solicitações já em andamento não são redirecionadas.

Exemplos de provedores

Os produtos e formatos de URL dos provedores podem mudar. Confirme a URL base, o ID do modelo, o método de autenticação e os endpoints aceitos na documentação de implantação atual do provedor.

Gerenciar modelos privados pela API

A administração no servidor pode usar a API de Modelos privados com uma chave de gerenciamento que tenha private_models:read, private_models:write ou private_models:delete, conforme necessário. As solicitações de criação e atualização aceitam model_reference, que pode ser um ID exato de modelo do catálogo ou um slug curto. O Phaseo deriva model_id; os clientes não podem enviá-lo diretamente. Use host_provider_id para um provedor existente do Phaseo, ou custom_provider_name e o opcional custom_provider_url para outro operador.

Solução de problemas

  • 404 do provedor: confira se a URL base termina antes do caminho de inferência.
  • Modelo desconhecido: copie o ID da implantação upstream do provedor em ID do modelo no provedor. Não use ali o ID de modelo do espaço de trabalho do Phaseo.
  • Solicitação upstream não autorizada: substitua a credencial armazenada e confirme que o provedor aceita autenticação Bearer.
  • Chat funciona, mas Responses falha: desative Responses API, a menos que o provedor implemente /responses nativamente.
  • Modelo ausente do catálogo: confirme que o modelo está habilitado e que quem chama está autenticado no mesmo espaço de trabalho.
Última modificação em 16 de novembro de 2026