API documentation
The Modelglass read API serves the same pricing + ontology data as the comparison site, with full pricing history and the structured feed for operators. Paid tiers require an API key.
Get an API key →Base URL
https://modelglass-api.vercel.appAuthentication
Send your API key as a Bearer token on every /v1
request. Missing key → 401; over your plan limit
→ 429. Successful responses carry
X-RateLimit-Limit/Remaining/Reset headers.
Authorization: Bearer mg_starter_devkeyEndpoints
| Method | Path | Description |
|---|---|---|
| GET | /v1/meta | Artifact version, built_at, content hash, counts |
| GET | /v1/models | All models; filter ?provider= ?unit= ?status= ?arch= |
| GET | /v1/models/:modelId | One model by model_id (e.g. bfl/flux-1-schnell) |
| GET | /v1/providers | All providers |
| GET | /v1/providers/:slug | One provider by slug |
| GET | /v1/benchmarks | All benchmark definitions |
Plans & rate limits
| Plan | Pricing history | Rate limit |
|---|---|---|
| Free | Active price only | 100 req/day |
| Starter | Full pricing history | 10,000 req/day |
| Pro | Full history + webhooks (Phase 6) | 100,000 req/day + SLA |
Free tier reads the static artifact (no key needed) · browse models →
Examples
# Metadata
curl -H "Authorization: Bearer mg_starter_devkey" \
https://modelglass-api.vercel.app/v1/meta
# All models, filtered to one provider
curl -H "Authorization: Bearer mg_starter_devkey" \
"https://modelglass-api.vercel.app/v1/models?provider=replicate"
# One model (full pricing history on Starter+)
curl -H "Authorization: Bearer mg_starter_devkey" \
https://modelglass-api.vercel.app/v1/models/bfl/flux-1-schnell