> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kymaapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tier Matrix

> Public tier matrix. Returns the full TIERS array — deposit threshold, RPM, TPM, image/video/audio concurrency caps per tier. Cached 5 min.

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).

```bash theme={null}
curl https://kymaapi.com/v1/limits/tiers
```

## Response

```json theme={null}
{
  "object": "tier.matrix",
  "tiers": [
    {
      "tier": 0,
      "name": "Tier 0",
      "min_deposit": 0,
      "rpm": 30,
      "per_model_rpm": 25,
      "tpm": 200000,
      "max_single_request": 200000,
      "image_concurrent": 2,
      "image_queue_depth_cap": 6,
      "video_concurrent": 0,
      "video_queue_depth_cap": 0,
      "audio_concurrent": 2,
      "audio_concurrent_per_capability": {
        "transcription": 1,
        "understanding": 2,
        "speech": 1
      }
    }
  ]
}
```

<ResponseField name="object" type="string">Always `"tier.matrix"`.</ResponseField>
<ResponseField name="tiers" type="array">Array of 5 tier definitions, ordered Tier 0 → Tier 4.</ResponseField>

### Tier fields

| Field                             | Type    | Meaning                                                                                                                                                                                                                                               |
| --------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `tier`                            | number  | Tier number (0–4)                                                                                                                                                                                                                                     |
| `name`                            | string  | Display name (`"Tier 0"` … `"Tier 4"`)                                                                                                                                                                                                                |
| `min_deposit`                     | number  | Minimum cumulative Stripe deposit in USD to qualify for this tier                                                                                                                                                                                     |
| `rpm`                             | number  | Requests per minute (text/code endpoints, global per-user)                                                                                                                                                                                            |
| `per_model_rpm`                   | number  | Requests per minute for any single model (text/code)                                                                                                                                                                                                  |
| `tpm`                             | number  | Tokens per minute (text/code, global per-user)                                                                                                                                                                                                        |
| `max_single_request`              | number  | Upper bound for tokens in a single request (input + estimated output)                                                                                                                                                                                 |
| `image_concurrent`                | number  | Max concurrent image generation jobs                                                                                                                                                                                                                  |
| `image_queue_depth_cap`           | number  | Max queued image jobs ahead of the concurrency gate. `0` on Tier 4 (uses combined pool)                                                                                                                                                               |
| `video_concurrent`                | number  | Max concurrent video generation jobs. `0` on Tier 0 (video blocked entirely)                                                                                                                                                                          |
| `video_queue_depth_cap`           | number  | Max queued video jobs. `0` on Tier 0 (blocked) and Tier 4 (combined pool)                                                                                                                                                                             |
| `audio_concurrent`                | number  | Aggregate cap — max concurrent audio jobs across all capabilities                                                                                                                                                                                     |
| `audio_concurrent_per_capability` | object  | Per-capability audio concurrency caps. Keys: `transcription` (speech-to-text), `understanding` (audio scene Q\&A), `speech` (text-to-speech, music, sound effects). See [Audio sub-pools](/guides/rate-limits#audio-limits-per-capability-sub-pools). |
| `combined_media_concurrent`       | number? | **Tier 4 only.** Image + video share this combined concurrent pool (38 total).                                                                                                                                                                        |
| `combined_queue_depth_cap`        | number? | **Tier 4 only.** Queue depth cap for the combined pool (114).                                                                                                                                                                                         |

## 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 is `500` on internal error.

## Related

* [`GET /v1/pricing`](/api-reference/pricing-catalog) — companion catalog of all SKU pricing
* [Rate Limits guide](/guides/rate-limits) — 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`](/api-reference/auth-limits) — your account's CURRENT tier (requires auth, returns your specific `tier_override` if set)