Models catalog

GET /v1/models returns the catalog. It is public. No auth required. Always read it at runtime; the catalog is kept in sync and the live set is deployment-specific.

Request

curl "${PUBLIC_URL}/v1/models"

Response

Each model includes:

• id: the slug you send as model on completions.
• status: live (callable) or coming_soon (preview only).
• modality, capabilities, tier.
• Token caps and pricing (in micro-USDC per million tokens).

Only live models with published pricing are callable. Sending the id of a coming_soon model returns an error.

Popularity

GET /v1/models/stats?window=24h|7d|30d returns relative model popularity (rank and share), without raw counts.

Pricing note

Catalog pricing is shown for transparency. Your actual charge is the metered capacity burn times the winning offer's clearing price, see The 30–80¢ corridor.