Endpoints
| URL | Qué devuelve |
|---|---|
/api/catalog.json | Catálogo publicado completo (releases, precios, benchmarks, requisitos locales, fuentes) con bloque _meta. |
/api/models.json | Índice ligero por modelo: id, nombre, categoría, modalidades, contexto, licencia, despliegue, grado y URL. |
/api/models/<id>.json | Ficha completa de un registro: release + precios + benchmarks + requisitos locales + fuentes. |
/api/ids.json | Lista de ids publicados. |
POST /api/advise | Idoneidad de un modelo para un caso de uso: elegibles, excluidos y hasta 3 recomendaciones. GET se autodocumenta. |
/llms.txt | Este resumen en texto plano para agentes. |
CORS abierto (*) en /api/advise: es información pública. Sin datos
personales, sin claves, sin escritura.
Asesor de idoneidad
POST /api/advise ejecuta el mismo algoritmo que el
asesor de la web: filtros duros por exclusión, ejes que
no puntúan sin datos y tres recomendaciones con evidencias e incertidumbres.
curl -s -X POST https://atlas.iacedemy.com/api/advise \
-H 'content-type: application/json' \
-d '{"criteria":{"sensitivity":"local","hardware":"mid","level":"mid"}}' Campos de criteria:
task(opcional, string): describe la tarea; no puntúa, viaja para trazabilidad.modality(opcional): modalidad imprescindible, p. ej."text".sensitivity(obligatorio):local,euoany.budgetPerUnit(opcional): techo de coste por unidad facturable.hardware(obligatorio):none,midoworkstation.level(obligatorio):low,midohigh.
Los weights son opcionales (calidad, coste,
latencia, operacion, riesgo; 0–100). Respuesta
abreviada:
{
"criteria": { "sensitivity": "local", "hardware": "mid", "level": "mid" },
"eligible_count": 12,
"excluded": [ { "release_id": "…", "canonical_name": "…", "reason": "…" } ],
"recommendations": [
{
"release_id": "…", "canonical_name": "…", "score": 41.5,
"kind": "Mejor ajuste", "reason": "…",
"evidence": [ "…" ], "uncertainties": [ "…" ]
}
],
"notes": [ "…" ]
}
Un cuerpo mal formado responde 400 con el campo exacto que falla.
Cómo interpretar el grado A–D
- A — fuente primaria del creador y prueba o documento técnico. Capacidad confirmada.
- B — fuente primaria sin validación independiente. Capacidad confirmada.
- C — fuente secundaria fiable: úsala como indicio, no como hecho; el origen se indica en la ficha.
- D — rumor o sin verificar. No se publica ni se indexa: aparece como «pendiente de verificación».
El grado mide la fuente, no la calidad del modelo. La frescura es otro eje distinto: cada campo caduca a su ritmo (precios 30 días, licencias al cambiar el artefacto, ficha general 90 días) y la ficha lo avisa cuando ha caducado. Detalle en la metodología.
Cómo citar
Fuente + fecha + grado de confianza. Ejemplo: «Precio de entrada 10 USD / 1M tokens
(IAcademy AI Model Atlas, verificado 2026-10-11, grado B)». Los precios caducan a los 30
días: comprueba _meta.generated_at antes de decidir y no caches más de 24 h.