feat: scope model params by API surface

[guillaumegay13]

What this changes

• Adds a required apiSurface to every catalog entry and migrates all 382 model records.
• Groups the homepage into one row per provider/model, with surface and access variants inside the row.
• Adds API-surface filtering and shows the matching parameter set and representative SDK method.
• Exposes the surface through the JSON API, validation endpoint, npm and Python packages, MCP tools, and WebMCP.

Type of change

• Add a model (new YAML file under models/)
• Add a provider (new folder under models/, plus a logo)
• Add or update parameters on an existing model
• Fix incorrect data (default, range, values, applicability)
• Site or tooling (code under src/, docs, CI)

Source

Existing catalog request paths and the repository's documented API-surface contract.

Before opening

• npm run validate and npm test pass locally
• Filenames follow the existing API-key and subscription conventions
• No existing parameter was removed

Also verified lint, typecheck, production build, workspace tests, Python lint/type/tests, generated output, the parameter-removal guard, and desktop/mobile browser interactions.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
modelparams.dev	Ready	Preview	Aug 23, 2026 10:18pm