​
How Credits Work

Credits are Bluma’s usage currency. Each video generation consumes credits based on the template complexity, duration, resolution, and AI features used.

​
Pricing Tiers

Free Tier

10 videos/month
  • 100 requests/hour
  • Test mode available
  • Community support
  • Watermarked videos

Starter

100 videos/month - $29/mo
  • 1,000 requests/hour
  • Full-quality videos
  • Email support
  • No watermarks

Pro

500 videos/month - $99/mo
  • 5,000 requests/hour
  • Priority rendering
  • Priority support
  • Custom branding

Enterprise

3,000+ videos/month - Custom
  • 50,000 requests/hour
  • Dedicated support
  • Custom templates
  • SLA guarantee

​
Credit Calculation

​
Base Formula

Total Credits = Base Cost × Duration × Resolution × AI Multiplier

​
Multipliers

FactorMultiplier
Resolution
720p1.0x
1080p1.5x
4K3.0x
Duration
Per 30 seconds+1 credit
Template Complexity
Basic1.0x
Advanced1.5x
AI-Generated2.0x

​
Example Calculations

Base: 2 credits (consumerclub-discord-zoomed template)
Duration: 1 (30 seconds)
Resolution: 1.5x (1080p)
AI: 2.0x (AI personality quiz)

Total: 2 × 1 × 1.5 × 2 = 6 credits

Base: 3 credits (product-showcase template)
Duration: 2 (60 seconds)
Resolution: 3.0x (4K)
AI: 1.5x (Advanced)

Total: 3 × 2 × 3.0 × 1.5 = 27 credits

Base: 5 credits (news-anchor template)
Duration: 3 (90 seconds)
Resolution: 1.5x (1080p)
AI: 2.0x (AI avatar + voice)

Total: 5 × 3 × 1.5 × 2 = 45 credits

​
Monthly Allowance

Each tier includes a monthly credit allowance:
TierMonthly VideosEquivalent Credits*
Free10~20
Starter100~200
Pro500~1,000
Enterprise3,000+~6,000+
*Based on average usage of 2 credits per video. Actual credit consumption varies by template and settings.

​
Overage Handling

​
How Overages Work

When you exceed your monthly allowance: Starter & Pro Tiers:
  • Overage rate: $0.50 per video
  • Charged at month-end
  • No hard limits
Free Tier:
  • No overages allowed
  • Requests fail with 402 error
  • Must upgrade to continue

​
Preventing Overages

Set up credit alerts: 
curl -X POST https://api.getbluma.com/api/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://yourapp.com/webhooks/bluma",
    "events": ["credits.low", "credits.exhausted"]
  }'

​
Checking Your Balance

​
Via API

curl https://api.getbluma.com/api/v1/credits/balance \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "credits": 88,
  "tier": "starter",
  "monthly_allowance": 100,
  "overage_used": 0,
  "reset_date": "2025-12-01T00:00:00Z",
  "usage": {
    "total_spent": 12,
    "average_per_video": 2.4
  }
}

​
Via Dashboard

Monitor your usage in real-time at getbluma.com/brand/api-usage

​
Credit History

Track all credit transactions: 
curl https://api.getbluma.com/api/v1/credits/history?limit=50 \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "transactions": [
    {
      "id": "txn_abc123",
      "type": "deduction",
      "amount": -6,
      "balance_after": 94,
      "description": "Video generation: batch_xyz789",
      "metadata": {
        "template_id": "consumerclub-discord-zoomed",
        "resolution": "1080p",
        "duration": 30
      },
      "created_at": "2025-11-03T10:30:00Z"
    },
    {
      "id": "txn_abc124",
      "type": "purchase",
      "amount": +100,
      "balance_after": 100,
      "description": "Monthly renewal: Starter plan",
      "created_at": "2025-11-01T00:00:00Z"
    }
  ],
  "total": 50
}

​
Test Mode

​
Free Testing

Test API keys (bluma_test_*) provide: ✅ Free unlimited testing ✅ Same API functionality ✅ No credit consumption ⚠️ Limitations:
  • Watermarked videos (“TEST MODE” overlay)
  • Lower quality rendering
  • Slower processing

​
Switching to Production

# Create production key
curl -X POST https://api.getbluma.com/api/v1/api-keys \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production Key",
    "environment": "production"
  }'

​
Optimizing Credit Usage

Choose Appropriate Resolution

Use 720p for social media, 1080p for professional content, 4K only when necessary

Optimize Video Length

Shorter videos (30-60s) consume fewer credits and perform better on social media

Select Simple Templates

Basic templates cost less than AI-heavy templates

Batch Generation

Generate multiple videos at once to optimize API usage

​
Credit Refunds

​
Automatic Refunds

Credits are automatically refunded if:
  • Video generation fails (server error)
  • Template rendering errors
  • Invalid input data (caught before processing)

​
Manual Refund Requests

Contact support@getbluma.com for:
  • Quality issues with generated videos
  • Incorrect credit charges
  • Technical problems during generation
Refunds are not provided for:
  • User errors in prompts or inputs
  • Content that violates terms of service
  • Videos successfully generated but not meeting expectations

​
Frequently Asked Questions

No, purchased credits never expire. Monthly allowance credits reset on your billing date.
Yes! Buy credit packs at getbluma.com/billing or upgrade your tier for a higher monthly allowance.
You keep any remaining credits, but your monthly allowance will reset to the new tier’s limit on your next billing cycle.
Enterprise customers can negotiate custom pricing based on volume. Contact sales@getbluma.com for details.
Use the credit calculator or check your historical usage in the dashboard.

​
Next Steps

View Your Balance

Check your current credit balance and usage

Upgrade Plan

Increase your monthly allowance

Templates

Learn about credit costs per template

API Reference

View credits API documentation