Pricing Catalog
Endpoints
Pricing Catalog
Public pricing catalog. Single round-trip returns every active SKU across text, image, video, and audio with per-call cost detail. Cached 60s.
GET
Pricing Catalog
Public, no authentication required. Returns every active Kyma SKU split into two arrays:
text— models billed per-token (chat / completion family). Includesinput_per_1m,output_per_1m, andcached_input_per_1mfor prompt-caching pricing.media— image / video / audio SKUs (everything non-token). Each row hasmodality,pricing_mode,usd_per_call, and adetailobject describing the pricing shape (per-image, per-second, per-minute, per-quality, etc.).
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
Always
"pricing.catalog".Number of text/chat SKUs in the
text array.Number of image/video/audio SKUs in the
media array.Text models. Sorted alphabetically by
id.Image/video/audio SKUs. Sorted alphabetically by
id.Text row fields
Media row fields
Pricing modes
Thedetail 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_usdagainst 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 setsCache-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:Related
GET /v1/limits/tiers— companion endpoint returning the rate-limit tier matrixGET /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)