MUNTRUME AI DOCS · OPEN SOURCE (MIT)
Referencia API REST & SSE Base URL de producción: https://ai.muntru.me (alias equivalente: https://api.muntru.me). Todas las rutas de inferencia, publicación y administración exigen cabecera Authorization: Bearer <JWT> emitida para una cuenta de miembro del equipo.
cURL JavaScript Python SSE Stream
Copiar curl -N https://ai.muntru.me/api/ai \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <TEAM_JWT_TOKEN>" \
-d '{
"model": "pro",
"skill": "engineer",
"stream": true,
"messages": [
{ "role": "user", "content": "/setup BMW M4 GT3 en Spa con 38C de pista: subviraje en Pouhon" }
]
}'const res = await fetch("https://ai.muntru.me/api/ai", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": `Bearer ${localStorage.getItem("mm_token")}`
},
body: JSON.stringify({
model: "pro",
stream: true,
messages: [{ role: "user", content: "Calcula estrategia 6h Watkins Glen GT3" }]
})
});
const reader = res.body.getReader();
const decoder = new TextDecoder();
while (true) {
const { done, value } = await reader.read();
if (done) break;
console.log(decoder.decode(value, { stream: true }));
}import requests
r = requests.post(
"https://ai.muntru.me/api/ai",
headers={
"Authorization": "Bearer <TEAM_JWT_TOKEN>",
"Content-Type": "application/json",
},
json={
"model": "ultra",
"stream": False,
"messages": [{"role": "user", "content": "Analiza el desgaste trasero en Daytona"}],
},
timeout=60,
)
r.raise_for_status()
print(r.json()["reply"])data: {"delta":"Para corregir el subviraje en Pouhon..."}
data: {"delta":"\n1. Baja la ARB delantera 1 clic."}
data: {"done":true,"model":"pro","usage":{"tokens":284}}Parámetros de POST /api/ai y códigos HTTP El esquema formal en formato OpenAPI 3.1 está publicado en /ai-openapi.json .
Campo JSON Tipo Descripción messages REQUERIDO Array<Message>Historial de conversación con role (user | assistant) y content (texto o bloques multimodales con imagen base64). model"lite" | "pro" | "ultra"Perfil de motor Muntrume 1.0. Por defecto pro. skillstringSkill opcional (engineer, strategy, artifacts, telemetry, code, press). streambooleanSi es true (recomendado), responde en text/event-stream token a token.
Códigos de respuesta HTTP Estado Significado Acción recomendada 200 OK Inferencia completada o stream SSE abierto. Procesar chunks data: {...} hasta done: true. 400 Bad Request Payload JSON inválido o lista messages vacía. Validar estructura del cuerpo enviado. 401 Unauthorized Token ausente, expirado o cuenta no autorizada. Iniciar sesión en /login/ o mediante Passkey. 429 Too Many Requests Límite de ráfaga superado para el piloto actual. Esperar unos segundos y reintentar con backoff. 502 / 503 Todos los proveedores de la cascada temporalmente saturados. Cambiar temporalmente a perfil lite o reintentar.
Endpoints de Artifacts Studio Método y Ruta Auth Función POST /api/ai/artifactsEquipo (JWT) Publica un artefacto (html, svg, mermaid, slides, csv, doc, code) en D1 y devuelve su slug y URL pública. GET /a/:slugPúblico Renderiza la página pública del artefacto con marco editorial y Open Graph. GET /a/:slug/rawPúblico Devuelve el contenido crudo del artefacto con su tipo MIME nativo. GET /u/:handlePúblico Muestra el catálogo público de artefactos publicados por un autor. DELETE /api/ai/artifacts/:slugAutor / Admin Elimina permanentemente el artefacto de D1.
Endpoints de Passkeys WebAuthn y MFA Método y Ruta Función POST /api/auth/passkey/register/optionsGenera reto WebAuthn para registrar una nueva Passkey en la cuenta autenticada. POST /api/auth/passkey/register/verifyVerifica la atestación y almacena la clave pública COSE en D1. POST /api/auth/passkey/login/optionsInicia sesión sin contraseña generando reto para credenciales registradas. POST /api/auth/passkey/login/verifyVerifica firma ECDSA P-256 y devuelve JWT de equipo. POST /api/auth/mfa/totp/setup & /verifyGenera secreto Base32 + URI otpauth:// y activa TOTP RFC 6238 + 8 códigos de recuperación. POST /api/auth/mfa/otp/send & /verifyEnvía y valida códigos OTP de un solo uso por ntfy.sh, Discord DM, Android SMS Gateway o WhatsApp Evolution/WAHA.
Garage Vault y Race Control Season Método y Ruta Auth Función GET /api/download?file=...Equipo (JWT) Descarga autenticada de setups .sto desde el Vault hacia el navegador o MMT Sync. POST /api/admin/season/generateAdmin Importa calendario provisional/oficial de iRacing en Race Control y genera la estructura de setups de la nueva temporada para Garage y MMT Sync.