import { Callout, Cards } from "@/docs/components";

Billing & Credits

elizaOS Cloud bills usage in USD-backed credits for flexible, pay-as-you-go pricing.

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

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.

API

curl -X GET "https://elizacloud.ai/api/v1/credits/summary" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "balance": 4523.5,
  "pending": 0,
  "usage": {
    "today": 45.2,
    "thisMonth": 1250.0
  }
}

Top Up Credits

Stripe Checkout

curl -X POST "https://elizacloud.ai/api/stripe/create-checkout-session" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "packId": "growth"
  }'

x402 Crypto Payment

Pay with USDC via x402 protocol:

curl -X POST "https://elizacloud.ai/api/v1/credits/topup" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-PAYMENT: <x402-payment-header>"

<Callout type="info">See crypto payment documentation for details.</Callout>

Auto Top-Up

Configure automatic credit refills:

curl -X POST "https://elizacloud.ai/api/auto-top-up/settings" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "threshold": 100,
    "amount": 1000
  }'

Usage Analytics

Track your spending via the credits summary endpoint:

curl -X GET "https://elizacloud.ai/api/v1/credits/summary" \
  -H "Authorization: Bearer YOUR_API_KEY"

See the Credits API for the complete response format including usage breakdown by agents and apps.

Invoices

List Invoices

curl -X GET "https://elizacloud.ai/api/invoices/list" \
  -H "Authorization: Bearer YOUR_API_KEY"

Download Invoice

curl -X GET "https://elizacloud.ai/api/invoices/{id}" \
  -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.

Cost Alerts

Cost alerts can be configured in your 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

<Callout type="info">Free credits expire after 30 days of inactivity.</Callout>

Enterprise

For high-volume usage:

• Custom pricing
• Volume discounts
• Dedicated support
• SLA guarantees
• Custom invoicing

Contact [email protected] for enterprise plans.

Next Steps