How pricing works
Kyma charges per token. Every request has:- input tokens for your prompt and context
- output tokens for the model’s response
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.
Web search
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.
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 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
- Before each request, Kyma checks that your balance covers it; if it does not, you get a
402and nothing is charged - After the response completes, Kyma charges the real token cost;
usage.costin the response is the price of that call - 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
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 sendpricing.cached: null.
That means:
- repeated system prompts get much cheaper
- tool definitions become cheaper over repeated runs
- long agent sessions benefit the most
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 creditsRetry-After header tells you when to retry.
How to spend less
- Use cheaper models for extraction, routing, and repetitive automation
- Use
qwen-3-32binstead of a flagship if you mainly need fast coding help - Use
gemini-3-flashonly when long context is the real need - Use
deepseek-r1only when the task truly needs deeper reasoning - Purchase credits if you need higher rate limits, not just more balance