Credits, karma, and payments
Deva Agent Key uses a credit-based billing system. You pay per API request, with no idle costs. This article explains how credits work, the subscription tiers, and how to manage your billing.
Written By Deva
Last updated About 2 months ago
How Credits Work
Every API call your agent makes costs a small number of credits (also called karma). The cost varies by API:
Simple lookups (weather, basic search): ~$0.001–$0.005 per call
Social media queries (Twitter, Reddit): ~$0.005–$0.01 per call
AI model calls (OpenAI chat, embeddings): ~$0.01–$0.04 per call
Exact pricing per API is shown in the Catalog.
Credit Sources
Your credits come from two buckets:
Subscription credits — Monthly allocation from your plan (refreshes each billing cycle)
Top-up credits — One-time purchases via Stripe
Spending order: Subscription credits are consumed first. Once depleted, top-up credits kick in.
Subscription Plans
What's a Rollover Cap?
Unused subscription credits carry over to the next month, up to the rollover cap. For example, on the Plus plan:
You get 22,000 credits/month
If you only use 15,000, the remaining 7,000 roll over
Maximum rollover balance: 10,000 credits
Choosing a Plan
Free — Good for testing. Limited credits, no commitment.
Plus — Light usage. A few hundred API calls per month.
Super — Moderate usage. Active agent workflows.
Ultra — Heavy usage. Production agents making thousands of calls.
Purchasing Top-Up Credits
Need more credits beyond your subscription allocation?
Go to Billing.
Click Purchase Credits.
Select an amount (minimum $50).
Complete checkout via Stripe.
Credits appear in your balance immediately.
Top-up credits don't expire — they persist until used.
Checking Your Balance
Header Pill
Your current spendable balance is always visible in the header at the top of the dashboard. Click it for a breakdown.
Billing Page
Go to Billing for the full picture:
Current balance (subscription + top-up)
Monthly credit allocation
Rollover amount
Transaction history
Transaction History
Every debit and credit is logged:
Debits (spending):
API resource name (e.g., "google_search")
Number of requests
Cost per request
Total deducted
Timestamp
Credits (earnings):
Subscription allocation
Top-up purchases
Signup bonus ($1 free credit)
Any promotional bonuses
View your full transaction history at Billing.
Managing Your Subscription
Upgrade or Downgrade
Change plans anytime from the Billing page. Changes take effect at the next billing cycle (or immediately for upgrades, depending on proration).
Cancel
Cancel your subscription from the Stripe Billing Portal (linked from the Billing page). You keep access to remaining credits until the end of the current billing period.
Stripe Billing Portal
Click Manage Billing on the Billing page to access the Stripe portal where you can:
Update your payment method (card)
View and download invoices
Cancel or modify your subscription
What Happens When Credits Run Out?
Your agent receives a 402 (Insufficient Credits) error on API calls.
The dashboard shows a warning banner.
Options:
Purchase top-up credits for immediate access
Upgrade your subscription plan
Wait for your next billing cycle to refresh subscription credits
Your API keys remain active — they're not revoked. Calls just fail with 402 until you add credits.
Free Signup Credit
Every new account gets a $1 free credit upon registration. This is enough for dozens of API calls to test the platform before choosing a plan.
Tips
Monitor your balance — check the header pill regularly. Running out mid-workflow is frustrating.
Super plan is the sweet spot — best credits-per-dollar ratio for active usage.
Top-ups for bursts — if you have a one-time heavy workload, buy top-up credits instead of upgrading your plan.
Check per-API pricing in the Catalog before using expensive APIs. A Google search is much cheaper than an OpenAI chat completion.