Skip to main content

​
Overview

Mavera uses a credit-based billing system. Each API call consumes credits based on the complexity of the request and the resources used. Your subscription includes a monthly credit allocation.

​
Credit Allocation by Plan

PlanMonthly Credits
Starter500
Basic2,000
Professional5,000
EnterpriseCustom
Credits reset at the start of each billing cycle. Unused credits do not roll over.

​
Credit Costs by Endpoint

EndpointTypical CostNotes
/chat/completions1-5 creditsBased on tokens used
/mave/chat10-50 creditsIncludes research, multi-source analysis
/personas (GET)0 creditsFree to list/retrieve
/personas (POST)300 creditsCreating custom personas
/focus-groups50-200 creditsBased on sample size and questions
/video-analyses100-500 creditsBased on video length
/news/stories/{id}/analyze5-20 creditsBased on analysis depth
/generations10-30 creditsBased on content length
/brand-voices (POST)50 creditsCreating brand voice profiles

​
Tracking Usage

​
In API Responses

Every API response includes credit usage in the usage object: 
{
  "id": "chatcmpl_abc123",
  "object": "chat.completion",
  "choices": [...],
  "usage": {
    "credits_used": 3,
    "prompt_tokens": 150,
    "completion_tokens": 200,
    "total_tokens": 350
  }
}

​
Via Dashboard

Monitor your usage at app.mavera.io/settings/usage:
  • Current period usage
  • Usage by endpoint
  • Daily breakdown
  • Historical trends

​
Handling Insufficient Credits

When you run out of credits, API calls return a 402 error: 
{
  "error": {
    "message": "Insufficient credits. Please upgrade your subscription or wait for your next billing cycle.",
    "type": "insufficient_credits",
    "code": "credits_exhausted",
    "param": null
  }
}

​
Auto-Recharge

Enable auto-recharge to automatically purchase additional credits when you run low:
1

Go to Billing Settings

Navigate to app.mavera.io/settings/billing
2

Enable Auto-Recharge

Toggle on “Auto-recharge credits”
3

Set Threshold

Choose when to trigger a recharge (e.g., when credits fall below 100)
4

Set Recharge Amount

Choose how many credits to purchase (e.g., 500 credits)

​
Best Practices

​
Monitor Usage Proactively

Track credits in your application: 
def make_api_call_with_tracking(client, messages, persona_id):
    response = client.chat.completions.create(
        model="mavera-1",
        messages=messages,
        extra_body={"persona_id": persona_id},
    )

    credits_used = response.usage.credits_used
    log_credit_usage(credits_used)

    # Alert if usage is high
    if credits_used > 10:
        alert_high_usage(credits_used)

    return response

​
Set Budget Alerts

Configure alerts in the dashboard to notify you when:
  • You’ve used 50%, 75%, 90% of monthly credits
  • A single request exceeds a threshold
  • Daily usage exceeds normal patterns

​
Optimize Credit Usage

  • Use /chat/completions for simple questions (1-5 credits)
  • Reserve /mave/chat for complex research (10-50 credits)
Store frequently-requested data to avoid redundant API calls
Combine multiple questions into single conversations rather than separate requests
Streaming doesn’t cost extra, but allows you to cancel early if needed

​
Workspace & Project Budgets

For team accounts, you can set budgets at workspace and project levels:
SettingDescription
Budget AlertNotification when spending reaches threshold
Usage LimitHard cap that blocks requests when reached
Billing EmailSeparate email for budget notifications
Configure these at:

​
Credit Purchase

Need more credits mid-cycle?
  1. Upgrade plan - Move to a higher tier for more monthly credits
  2. Purchase credits - Buy additional credits à la carte
  3. Enable auto-recharge - Automatically purchase when low

View Pricing

See current pricing for credit packages and subscriptions