Saltar al contenido principal
Añade un despliegue dedicado o autoalojado a tu espacio de trabajo y tu equipo lo llamará a través de la API normal de Phaseo con un ID de modelo como acme/legal-assistant. Solo tu espacio de trabajo puede verlo o llamarlo, y funciona en cualquier lugar donde funcione un ID de modelo público.
Los modelos privados están en fase Beta. Los propietarios y administradores del espacio de trabajo los añaden y gestionan.
Los orígenes habituales son despliegues dedicados en Baseten, Modal, RunPod, Fireworks o Together, y servidores que ejecutan vLLM u otro servidor compatible con OpenAI.

Antes de empezar

Tu despliegue debe ofrecer:
  • una URL base HTTPS pública;
  • un endpoint /chat/completions compatible con OpenAI;
  • autenticación con token Bearer; y
  • un ID de modelo o de despliegue upstream que ese endpoint acepte.
La compatibilidad con /responses es opcional. Déjala desactivada salvo que el despliegue implemente ese endpoint de forma explícita.
Los modelos privados no adaptan protocolos de proveedor exclusivamente nativos ni esquemas de autenticación personalizados. Pon una capa compatible con OpenAI delante de esos despliegues o usa una integración de proveedor compatible con Phaseo.

Conecta un despliegue

1

Abre Modelos privados

Abre Panel → Ajustes → Espacio de trabajo → Modelos privados y selecciona Añadir modelo. Debes ser propietario o administrador del espacio de trabajo. Para automatizarlo, llama a POST /v1/private-models con los mismos campos y una clave de administración.
2

Ponle nombre al modelo

Elige un modelo existente del catálogo para añadir este despliegue a su lista de proveedores, o introduce un slug de modelo corto como legal-assistant. Si ningún modelo del catálogo tiene ese slug único, Phaseo lo combina con el espacio de nombres de confianza del espacio de trabajo:
No puedes elegir ni sustituir el espacio de nombres del espacio de trabajo. Los ID exactos del catálogo se vinculan a ese modelo sin cambiar su identidad pública.
3

Configura el endpoint

Introduce la URL base anterior a la ruta de inferencia. Por ejemplo, usa:
No incluyas /chat/completions ni /responses. Introduce por separado el ID exacto del modelo o del despliegue upstream; Phaseo lo sustituye al reenviar las solicitudes.
4

Guarda la credencial

Introduce la clave de API del despliegue. Phaseo cifra la credencial y nunca la devuelve después de guardarla. Puedes sustituirla más adelante desde la página de ajustes del modelo.
5

Llama al modelo

Usa el ID de modelo generado con el endpoint normal de Chat Completions:
cURL
La clave de API que hace la llamada debe pertenecer al mismo espacio de trabajo que el modelo privado.

Cómo funciona el enrutamiento

Un modelo independiente del espacio de trabajo solo se enruta a su endpoint configurado. Un endpoint vinculado a un modelo del catálogo se une a la lista de proveedores de ese modelo según su política de enrutamiento: Phaseo envía la credencial guardada como token Bearer y sustituye el ID de modelo upstream configurado. Un modelo privado nunca se convierte en una ruta de proveedor pública y no es visible para otros espacios de trabajo. Los modelos privados habilitados se incluyen en el catálogo de modelos autenticado y aparecen con el filtro Privado.
Después de añadir, cambiar o habilitar un despliegue privado, espera hasta un minuto antes de probar su enrutamiento. Hasta entonces, algunas solicitudes pueden seguir usando la configuración anterior, como los proveedores públicos del modelo. Las solicitudes que ya están en curso no se redirigen.

Ejemplos de proveedores

Los productos de los proveedores y los formatos de URL pueden cambiar. Confirma la URL base, el ID de modelo, el método de autenticación y los endpoints compatibles en la documentación de despliegue actual del proveedor.

Gestiona modelos privados con la API

La administración desde el servidor puede usar la API de modelos privados con una clave de gestión que tenga private_models:read, private_models:write o private_models:delete, según sea necesario. Las solicitudes de creación y actualización aceptan model_reference, que es un ID exacto de modelo del catálogo o un slug corto. Phaseo deriva model_id; los clientes no pueden enviarlo directamente. Usa host_provider_id para un proveedor existente de Phaseo, o custom_provider_name y, opcionalmente, custom_provider_url para otro operador.

Solución de problemas

  • 404 del proveedor: comprueba que la URL base termine antes de la ruta de inferencia.
  • Modelo desconocido: copia el ID de despliegue upstream del proveedor en ID del modelo upstream. No uses ahí el ID de modelo del espacio de trabajo de Phaseo.
  • Solicitud upstream no autorizada: sustituye la credencial guardada y confirma que el proveedor acepta autenticación Bearer.
  • Chat funciona pero Responses falla: desactiva Responses API salvo que el proveedor implemente /responses de forma nativa.
  • El modelo no aparece en el catálogo: confirma que el modelo está habilitado y que quien llama está autenticado en el mismo espacio de trabajo.
Última modificación el 16 de noviembre de 2026