Tier Matrix
Endpoints
Tier Matrix
Public tier matrix. Returns the full TIERS array — deposit threshold, RPM, TPM, image/video/audio concurrency caps per tier. Cached 5 min.
GET
Tier Matrix
Public, no authentication required. Returns Kyma’s complete rate-limit tier ladder so docs, dashboard signup flows, and external tools can show “what you unlock at each spend threshold” without hardcoding the matrix in two places.
The response is
Cache-Control: public, max-age=300 (5 minutes).
Response
Always
"tier.matrix".Array of 5 tier definitions, ordered Tier 0 → Tier 4.
Tier fields
Use cases
- Dashboard signup flow: show “deposit $5 to unlock 60 RPM + 10 concurrent image” inline.
- Pricing page: render tier comparison table without hardcoding numbers.
- External capacity planner: developers building products on Kyma can fetch tier caps and budget concurrency client-side.
- CI test fixture: lock test expectations against the live matrix.
Caching
Cache-Control: public, max-age=300 (5 minutes). Tier matrix changes infrequently (typically only when Kyma raises caps, e.g. after upstream key rotation or quota upgrades).
Errors
Public read-only — no auth errors. Only failure mode is500 on internal error.
Related
GET /v1/pricing— companion catalog of all SKU pricing- Rate Limits guide — full human-readable explanation with audio sub-pool reasoning, queue + backpressure semantics, 429 response shape, and the “Need higher limits?” CTA
GET /v1/auth/limits— your account’s CURRENT tier (requires auth, returns your specifictier_overrideif set)