Model Intelligence API
The public /api/mi/v1 surface — health, model index, and model envelopes with HTTP-mapped publication states.
The Model Intelligence API (/api/mi/v1, served from upcube.ai) is the public, anonymous surface over the model publication plane. No account, no API key. Responses are cacheable (public, max-age=300, s-maxage=3600).
GET /api/mi/v1/health
Plane seed status. No database reads; safe to poll.
curl -sS https://upcube.ai/api/mi/v1/healthResponse shape:
{
"ok": true,
"seeded_models": 120,
"generated_at": "2026-10-03T00:00:00.000Z",
"pointers": "static-seed",
"objects": "static-assets"
}pointers is d1 when the pointer store is bound (else static-seed); objects is r2 when the object store is bound (else static-assets).
GET /api/mi/v1/models
The public model index. Only HIT-state models are listed — removed, quarantined, and missing entries never appear here.
curl -sS https://upcube.ai/api/mi/v1/modelsResponse shape:
{
"models": [
{
"slug": "example-model",
"name": "Example Model",
"provider": "example",
"entityId": "mi_example",
"contentVersion": "2026-10-03.1"
}
],
"total": 1,
"generated_at": "2026-10-03T00:00:00.000Z"
}GET /api/mi/v1/models/:slug
One model's envelope. The five publication states map to HTTP semantics:
| State | HTTP | Meaning |
|---|---|---|
| HIT | 200 + ETag: "<contentVersion>" | The full envelope |
| REDIRECT | 301 to the canonical slug | Slug moved |
| REMOVED | 410 {"error":"removed"} | Gone, deliberately |
| QUARANTINED | 500 {"error":"quarantined","reason"} | Held for review |
| MISS | 404 {"error":"not found"} | Unknown slug |
curl -sS https://upcube.ai/api/mi/v1/models/<slug>Use a slug from the index above. Slugs are canonical keys; redirects resolve to the current canonical slug.
Errors
Errors are small JSON objects with an error string and, where useful, a reason. There is no envelope beyond that: { "error": "not found" }.