Skip to main content
GET
Pricing Catalog
Public, no authentication required. Returns every active Kyma SKU split into two arrays:
  • text — models billed per-token (chat / completion family). Includes input_per_1m, output_per_1m, and cached_input_per_1m for prompt-caching pricing.
  • media — image / video / audio SKUs (everything non-token). Each row has modality, pricing_mode, usd_per_call, and a detail object describing the pricing shape (per-image, per-second, per-minute, per-quality, etc.).
Both arrays are sorted by id for stable diffs across calls. The response is Cache-Control: public, max-age=60. This is the single source of truth for marketing surfaces, dashboard pricing tables, billing audit scripts, and the pricing.mdx page in these docs. If you’re building a comparison page, integration tooling, or a programmatic billing audit, prefer this over scraping the docs.

Response

object
string
Always "pricing.catalog".
text_count
number
Number of text/chat SKUs in the text array.
media_count
number
Number of image/video/audio SKUs in the media array.
text
array
Text models. Sorted alphabetically by id.
media
array
Image/video/audio SKUs. Sorted alphabetically by id.

Text row fields

Media row fields

Pricing modes

The detail object on media rows depends on the pricing_mode:

Use cases

  • Marketing comparison pages: fetch and render a model grid showing every SKU with current pricing, no scraping required.
  • Billing audit: cross-check request_logs.cost_usd against this catalog to verify the gateway didn’t drift from documented prices.
  • Dashboard model picker: render pricing inline in the model selector without hardcoding rates client-side.
  • Programmatic SDK config: agents that auto-select models can fetch live pricing for cost-aware routing.

Caching

The endpoint sets Cache-Control: public, max-age=60. Hosted in front of Cloudflare so repeat requests within a minute hit CDN edge. Pricing changes propagate to the live response within 60 seconds of a deploy.

Errors

This endpoint is public and read-only — no auth errors. The only failure modes are:
  • GET /v1/limits/tiers — companion endpoint returning the rate-limit tier matrix
  • GET /v1/models — list models without pricing, with filtering params
  • Pricing — human-readable pricing page rendered from this same catalog
  • GET /v1/credits/pricing — legacy text-only pricing endpoint (kept for backward compat; prefer this catalog)