---
title: Billing & Credits
description: Understand elizaOS Cloud pricing, credits system, and billing management.
---
# Billing & Credits
elizaOS Cloud bills usage in USD-backed credits for flexible, pay-as-you-go pricing.
Provider pricing is refreshed from upstream catalogs and pricing pages. The
dashboard and API Explorer reflect the latest stored rates; this page gives
the billing model and current ranges, not a frozen source-of-truth table.
## Overview
- **Credits**: Universal currency for all services
- **Pay-as-you-go**: Only pay for what you use
- **Top-up**: Purchase credits as needed
- **Auto top-up**: Automatic refills (optional)
## Pricing Model
### Chat & Language Models
- Token pricing is model-specific and refreshed from provider catalogs.
- The platform applies a 20% markup to the upstream provider cost.
- Current curated chat models span roughly `$0.00024` to `$0.018` per 1K input tokens.
### Embeddings
- Embeddings are billed per token using the active provider rate plus 20%.
- `text-embedding-3-small` is currently about `$0.000024` per 1K input tokens after markup.
### Image Generation
- Image generation is billed per output image.
- Current supported models span roughly `$0.0468` to `$0.0960` per generated image.
### Video Generation
- Video generation is billed from the model’s actual provider economics, not a flat platform fee.
- Depending on the selected model, default request costs currently span roughly `$0.336` to `$3.840`.
- Some models bill per second, some bill per request duration, and some bill by resolution/audio combination.
### Voice
- TTS is billed per character. Current published rates are roughly `$0.060` to `$0.120` per 1K characters after markup.
- STT is billed per decoded audio duration. Current rate is about `$0.0044` per minute after markup.
- Voice cloning is billed by clone tier and should be reviewed against your ElevenLabs contract if you use account-specific pricing.
### Infrastructure
| Resource | Cost |
| ------------------------------- | ---------------------- |
| Container (per day) | 0.67 credits (~$20/mo) |
| Container deployment (one-time) | 0.50 credits |
| Knowledge storage (per GB/day) | 0.01 credits |
Containers are billed **daily**. If credits run low, you'll receive a 48-hour
warning before shutdown.
## Credit Packs
Purchase credit packs from the dashboard. The available pack sizes and promotions
can change over time, so use the billing UI or credit-pack API for the current
offerings.
## Checking Balance
### Dashboard
View your balance at [Dashboard → Billing](https://elizacloud.ai/dashboard/billing).
### API
```bash
curl -X GET "https://elizacloud.ai/api/v1/credits/summary" \
-H "Authorization: Bearer YOUR_API_KEY"
```
```json
{
"balance": 4523.5,
"pending": 0,
"usage": {
"today": 45.2,
"thisMonth": 1250.0
}
}
```
## Top Up Credits
### Stripe Checkout
```bash
curl -X POST "https://elizacloud.ai/api/v1/credits/checkout" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"credits": 50,
"success_url": "https://elizacloud.ai/dashboard/billing/success",
"cancel_url": "https://elizacloud.ai/dashboard/billing"
}'
```
The response contains `url` and `sessionId`. Redirect the user to `url`, then
verify the completed session with `GET /api/v1/credits/verify?session_id=...`.
### x402 Crypto Payment
Pay with USDC via x402 protocol:
```bash
curl -X POST "https://elizacloud.ai/api/v1/topup/10" \
-H "X-PAYMENT: "
```
Use `/api/v1/topup/10`, `/api/v1/topup/50`, or `/api/v1/topup/100`.
With wallet signature headers, credits go to the signer. Without wallet
signature headers, include `walletAddress` in the request body.
## Auto Top-Up
Configure automatic credit refills:
```bash
curl -X PUT "https://elizacloud.ai/api/v1/billing/settings" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"autoTopUp": {
"enabled": true,
"threshold": 100,
"amount": 1000
}
}'
```
| Setting | Description |
| ----------- | -------------------------------- |
| `autoTopUp.enabled` | Enable auto top-up |
| `autoTopUp.threshold` | Trigger when balance falls below |
| `autoTopUp.amount` | Credits to add |
## Usage Analytics
Track your spending via the credits summary endpoint:
```bash
curl -X GET "https://elizacloud.ai/api/v1/credits/summary" \
-H "Authorization: Bearer YOUR_API_KEY"
```
See the [Credits API](/cloud/api/credits) for the complete response format including usage breakdown by agents and apps.
## Invoices
Invoices are available in the dashboard and through the legacy invoice routes.
They are session/account scoped.
```bash
curl -X GET "https://elizacloud.ai/api/invoices/list" \
-H "Authorization: Bearer YOUR_API_KEY"
```
## Payment Methods
Payment methods are managed through the Stripe checkout flow. When you create a checkout session via `/api/v1/credits/checkout`, Stripe handles payment method collection securely.
Saved payment methods and auto top-up can be configured in your [Dashboard →
Billing](https://elizacloud.ai/dashboard/billing) settings.
## Cost Alerts
Cost alerts can be configured in your [Dashboard → Billing](https://elizacloud.ai/dashboard/billing) settings. You can set:
- **Email notifications** when balance drops below a threshold
- **Auto top-up** to automatically add credits when balance is low
## Free Tier
New accounts receive:
- A signup credit grant when enabled
- Basic access to all features
- Community support
Free credits expire after 30 days of inactivity.
## Enterprise
For high-volume usage:
- Custom pricing
- Volume discounts
- Dedicated support
- SLA guarantees
- Custom invoicing
Contact [sales@eliza.ai](mailto:sales@eliza.ai) for enterprise plans.
## Next Steps
Earn from your agents
Pay with crypto
Usage tracking APIs