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.
Antes de empezar
Tu despliegue debe ofrecer:- una URL base HTTPS pública;
- un endpoint
/chat/completionscompatible con OpenAI; - autenticación con token Bearer; y
- un ID de modelo o de despliegue upstream que ese endpoint acepte.
/responses es opcional. Déjala desactivada salvo que el despliegue implemente ese endpoint de forma explícita.
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 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.
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: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:La clave de API que hace la llamada debe pertenecer al mismo espacio de trabajo que el modelo privado.
cURL
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 tengaprivate_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
/responsesde 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.