Skip to main content
GET
Pricing Catalog
Public, no authentication required. Returns every active Kyma SKU split into two arrays:
  • text — every SKU billed per token: chat, embeddings, reranking and decisions. Includes input_per_1m, output_per_1m, and cached_input_per_1m for prompt-caching pricing.
  • media — image, video and audio SKUs (everything not billed per token). Each row has modality, pricing_mode, usd_per_call, and a detail object describing the pricing shape (per-image, per-megapixel, per-quality, per-second, per-minute, per-1k-chars).
Both arrays are sorted by id for stable diffs across calls. The response is Cache-Control: public, max-age=60. If you’re building a comparison page or integration tooling, prefer this over scraping the docs. For a billing audit, note one thing the rows do not carry: sonar and sonar-pro also charge a flat fee per request (see Pricing), which usage.cost on each response already includes.

Response

string
Always "pricing.catalog".
number
Number of per-token SKUs in the text array.
number
Number of SKUs in the media array.
array
Per-token SKUs. Sorted alphabetically by id.
array
Per-unit 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 usage.cost on each response, or the cost of each request on the dashboard’s Logs page, against this catalog. Add the per-request fee for sonar and sonar-pro.
  • 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, so clients may cache it for a minute. Every request is answered fresh by the API; a pricing change shows on the next request after it is deployed.

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, generated from the same pricing source
  • GET /v1/credits/pricing — legacy per-token view of every listed model. Its rows for image and audio models carry placeholder token rates, not their prices. Kept for backward compatibility; use this catalog instead