Skip to main content

How pricing works

Kyma charges per token. Every request has:
  • input tokens for your prompt and context
  • output tokens for the model’s response
No monthly fee, no seat fee, no contract. Prices below are per 1 million tokens. The $0.50 signup credit spends on the free tier, not on the whole catalogue. Everything else that generates media needs a top-up first. For the live canonical table, use GET /v1/models or GET /v1/credits/pricing.

Very long prompts

A few models cost more per token once a single prompt passes a threshold, because the infrastructure serving them charges more there. The rates below are the standard ones, which is what almost every request pays. The threshold is on the prompt, not the conversation, so you know which rate applies before you send. Every other model on Kyma is a single flat rate at any length, and usage.cost on the response is always the exact amount charged.

Pricing per model

Cheapest useful models

Use these for bulk automation, extraction, and simple workloads.

Balanced value

Use these when you want strong quality without flagship pricing.

Flagship / premium

Use these when quality or capability matters more than cost. Rows showing · cached print the cached input price inline (10% of normal input — applies to repeated system prompts and tool definitions on caching-enabled models; see prompt caching).

Long-context & multimodal

Use these when context length or image input is the bottleneck.

Embeddings

Embedding models turn text into vectors for retrieval. Billed on input tokens only — the response is a vector, so there is no completion side to charge for.

Reranking

Scores how well each document answers a query, so a retriever’s top 50 becomes the 5 worth sending to a model. Billed on input tokens — the query plus every document you send. For comparison, OpenAI’s text-embedding-3-small lists at $0.02 / 1M. See the embeddings API reference. Perplexity’s Sonar models run a live web search on every request and return cited answers. They bill two components on the same request: normal token pricing plus a flat web-search fee for the live search. The web-search fee is flat per request — it does not scale with tokens — so a short sonar question is dominated by the search fee, not the tokens. Every response’s usage.cost already includes it. (The GET /v1/pricing catalog lists the per-token prices above; the flat search fee is applied per request at billing time, not as a catalog field.) Standard models have no per-request fee; use Sonar only when you actually need fresh web data.

Image generation

Image models bill per image, not per token. The cost shown is exactly what you pay per image. See the Image Generation guide and the API reference. A request with n: 4 is billed as 4 images. gpt-image-2 and gpt-image-2.5-flare requests can opt into quality: low/medium/high per call; the hold books the right tier amount up front so high-quality requests reserve $0.285 (no refund-and-rebill drift). Holds refund in full if generation fails. recraft-v3, recraft-v4-vector-pro and flux-1.1-ultra are paused as of 12 September 2026. Use recraft-v4, recraft-v4-vector and flux-2-pro instead.
Use Which model should I use? to pick by task rather than by price.

What does a typical request cost?

With the $0.50 signup credit, you can make hundreds or thousands of requests depending on model choice.

Free tier

The signup credit is a free tier, not cash for the whole catalogue. Until you buy credits, it spends on text models at or under 3/Moutputand3/M output and 0.50/M input, plus media at or under $0.01 per billing unit. A billing unit is whatever that model is quoted in — a minute of transcription, 1,000 characters of speech, one image, one video, one second, one song, one call. At a cent a unit, $0.50 always buys at least 50 of them. The media models in the free tier today: gemini-3.5-transcribe, gpt-4o-mini-transcribe-2025-12-15, gpt-transcribe, minimax-image-01, whisper-v3-turbo Everything else that generates media — image, video, music, sound effects, the premium voices, and the realtime translation and live sessions — needs a top-up. Ask for one on a fresh account and you get:
message lists the free-tier media ids in full; they are trimmed here because the list moves with prices. required is 0 because no top-up makes a premium model free — any purchase unlocks the whole catalogue. When the refusal IS about an amount (code: "insufficient_credits"), required, details.required and need_usd all carry the figure you are short of. Any purchase — the $5 package included — unlocks the full catalogue permanently. The list above is computed from published prices, so it moves when a price does. Updated 2026-09-07.

How billing works

  1. Before each request, Kyma checks that your balance covers it; if it does not, you get a 402 and nothing is charged
  2. After the response completes, Kyma charges the real token cost; usage.cost in the response is the price of that call
  3. Image and video jobs hold an estimate before they run; when the job ends the real cost is charged and the rest of the hold is returned
You pay for actual usage, not an estimate.

Credits

The signup bonus spends on the free tier; purchased credits spend on anything. Credits never expire. Auto top-up is supported in the dashboard.

Video generation

Billed per second of generated footage. A failed job is refunded in full. Other video ids are paused and return 404 model_not_found. See Video Generation.

Audio

Audio splits by capability — transcription, understanding, realtime, TTS, music, voice, SFX. Speech-to-text (per minute, 1-min minimum billable) TTS (per 1k characters) Paused as of 12 September 2026: realtime translation and live sessions, music, voice clone, voice design, sound effects, and the eleven-v3 voice. No model in those groups is being served, so they have no price here; a request returns 404 model_not_found. Use eleven-multilingual-v2 in place of eleven-v3. Live source: GET /v1/pricing (audio rows).

Prompt caching

Cached input tokens are charged at that model’s own cached-input rate, published beside its input rate above. There is no catalogue-wide discount: measured across the models that publish one, the cached rate runs from a tenth of the input rate up to the input rate itself. Models with no published cached rate send pricing.cached: null. That means:
  • repeated system prompts get much cheaper
  • tool definitions become cheaper over repeated runs
  • long agent sessions benefit the most
Learn more about prompt caching →

Rate limits

Kyma uses a tier-based system similar to xAI and Anthropic-style paid access: your tier increases based on total credits purchased, not lifetime usage. RPM = requests per minute Per-model RPM = how many requests per minute a single model can take TPM = tokens per minute across your account There are no daily or monthly caps. Your balance and tier are the real limits.

What happens when you hit a limit?

Out of credits
Too many requests
The Retry-After header tells you when to retry.

How to spend less

  • Use cheaper models for extraction, routing, and repetitive automation
  • Use qwen-3-32b instead of a flagship if you mainly need fast coding help
  • Use gemini-3-flash only when long context is the real need
  • Use deepseek-r1 only when the task truly needs deeper reasoning
  • Purchase credits if you need higher rate limits, not just more balance

Next steps