Made for Agent
Idioma: Español

Endpoints

4.1 Tabla de endpoints

Un servicio conforme DEBE implementar todos los endpoints marcados como obligatorios. PUEDE implementar los opcionales, y los señala mediante los indicadores de capacidad de su descripción del servicio.

Método Ruta Exigencia Finalidad
GET /.well-known/lmsp.json Obligatorio Descubrimiento del servicio y de sus capacidades
GET /lmsp/v1/openapi.json Obligatorio Especificación de la interfaz legible por máquina
GET /lmsp/v1/health Obligatorio Comprobación de actividad y de preparación
POST /lmsp/v1/pair Obligatorio Canjear un código de emparejamiento por un token de portador
GET /lmsp/v1/models Obligatorio Listar los modelos locales
GET /lmsp/v1/models/{model_id} Obligatorio Obtener un modelo
POST /lmsp/v1/responses Obligatorio Generación síncrona o en streaming
GET /lmsp/v1/responses/{response_id} Opcional Recuperar una respuesta almacenada
POST /lmsp/v1/tasks Obligatorio Crear una tarea de generación asíncrona
GET /lmsp/v1/tasks/{task_id} Obligatorio Obtener una tarea asíncrona
POST /lmsp/v1/tasks/{task_id}/cancel Obligatorio Cancelar una tarea asíncrona
GET /lmsp/v1/tasks/{task_id}/events Opcional Suscribirse al flujo de eventos o reanudarlo
POST /lmsp/v1/models/{model_id}/load Opcional Precargar un modelo
POST /lmsp/v1/models/{model_id}/unload Opcional Liberar un modelo de la memoria

Los endpoints compatibles con OpenAI bajo /v1 y los endpoints opcionales compatibles con Ollama se enumeran en la página 8.

4.2 Convenciones

  • Cuerpos. Los cuerpos de las solicitudes y de las respuestas son JSON (application/json), salvo los flujos de eventos (text/event-stream) y los errores (application/problem+json).
  • Parámetros de ruta. Un nombre entre llaves, como {model_id}, es un marcador de posición. Los valores DEBEN codificarse con porcentaje. Un id de modelo como qwen3:14b-q4_k_m se envía como qwen3%3A14b-q4_k_m.
  • Autenticación. Todos los endpoints exigen Authorization: Bearer <token>, salvo /.well-known/lmsp.json, /lmsp/v1/openapi.json, /lmsp/v1/health y /lmsp/v1/pair.
  • Endpoints opcionales. Un endpoint opcional que el servicio no implementa DEBE responder 501 Not Implemented con el código de error unsupported_capability.
  • Versiones y errores. Las solicitudes pueden llevar cabeceras de versión, y todos los errores usan un mismo formato. Ambos se definen en la página 9.
  • Contrato. El documento OpenAPI publicado en /lmsp/1.0/openapi.json es la forma legible por máquina de esta página. El texto es normativo donde ambos difieran.