Skip to main content

​
How it works

Kyma uses a credit-based system with RPM (requests per minute) limits to prevent abuse.
  • Credits are the natural limit — when you run out, requests stop
  • RPM limits prevent burst abuse
  • No daily request caps

​
Rate limits

TierRPM (requests/min)How to unlock
Free20Signup (free $0.50 credits)
Paid200Purchase any credit package

​
Credits

Every account starts with **0.50freecredits∗∗.Mostmodelsarefree(cost0.50 free credits**. Most models are free (cost 0 per request). Premium models have a small per-request cost.
ActionCredits
Signup bonus+$0.50
Referral bonus (both sides)+$0.50
Purchase5/5 / 20 / 100/100 / 500
Check your balance and pricing: 
# Check balance
curl https://kymaapi.com/v1/credits/balance \
  -H "Authorization: Bearer kyma-your-key"

# Check model pricing
curl https://kymaapi.com/v1/credits/pricing

​
Check your limits

curl https://kymaapi.com/v1/auth/limits \
  -H "Authorization: Bearer kyma-your-key"

{
  "rpm_limit": 200,
  "rpm_used": 3,
  "rpm_remaining": 197,
  "has_credits": true,
  "used_today": 42
}

​
What happens when you hit the limit?

You’ll receive a 429 response with a short retry window: 
{
  "error": {
    "message": "Rate limit exceeded (200 requests/minute). Try again in a few seconds.",
    "type": "rate_limit"
  }
}
The Retry-After header tells you how many seconds to wait (usually 5 seconds or less).

​
Tips

  • Most models are free — they don’t consume credits
  • Use streaming — it counts as 1 request regardless of response length
  • Implement exponential backoff for production use
  • Buy credits to unlock 200 RPM (10x the free tier)