Billing — Plans and Credits¶

Gremia uses a credit-based billing system powered by Stripe. Credits are consumed when agents use AI models to process tasks.

Plans¶

Feature	Free	Pro	Enterprise
Monthly price	$0	$29/mo	Custom
Credits included	$5.00	$30.00	Custom
Model access	Fast only	Fast + Balanced	Fast + Balanced + Powerful
Manifests	3	Unlimited	Unlimited
Team members	1	10	Unlimited
Support	Community	Email	Dedicated
SLA	None	99.5%	99.9%
Audit retention	30 days	365 days	Custom (up to 10 years)

Free Plan¶

The Free plan is ideal for evaluating Gremia:

$5.00 in credits to explore the Builder and run basic tasks
Access to the Fast model tier (lowest cost per token)
Up to 3 saved manifests
No credit card required

Pro Plan¶

For individuals and small teams:

$30.00 in monthly credits (reset each billing period)
Access to Fast and Balanced model tiers
Unlimited manifests and team members (up to 10)
Email support with 24-hour response time

Enterprise Plan¶

For organizations with advanced needs:

Custom credit allocation based on usage projections
Access to all model tiers including Powerful
Dedicated support with named account manager
Custom audit retention (up to 3,650 days)
On-premise deployment options
SSO/SAML integration

Contact sales@gremia.io for pricing.

Credits¶

Credits are measured in cents. Every API call that invokes an AI model consumes credits based on the model tier and token count.

Cost per 1,000 Tokens¶

Tier	Input tokens	Output tokens	Typical model
Fast	$0.00025	$0.00125	Haiku-class
Balanced	$0.003	$0.015	Sonnet-class
Powerful	$0.015	$0.075	Opus-class

Billable Events¶

Event	Description	Credits consumed
`chat_turn`	Each message in the Builder chat	Based on tokens used
`manifest_generation`	Generating a full manifest	Balanced-tier cost
`execution_step`	Each agent step during task execution	Based on model and tokens
`rag_query`	Knowledge base query for context enrichment	Fast-tier cost

Checking Your Balance¶

Via the web dashboard:

Navigate to Settings > Billing to see:

Current plan tier
Credits remaining vs. total
Billing period start and end dates
Daily usage chart (last 30 days)

Via the API:

# Get current plan and balance
curl https://api.gremia.io/api/v1/billing/plan \
  -H "Authorization: Bearer $TOKEN"

# Get daily usage history
curl "https://api.gremia.io/api/v1/billing/usage?days=30" \
  -H "Authorization: Bearer $TOKEN"

Managing Your Subscription¶

Upgrading¶

Go to Settings > Billing > Upgrade
Select your desired plan
Complete checkout via Stripe
Credits are applied immediately

Via the API:

curl -X POST https://api.gremia.io/api/v1/billing/checkout \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "plan": "pro",
    "success_url": "https://app.gremia.io/billing/success",
    "cancel_url": "https://app.gremia.io/billing/cancel"
  }'

Managing Payment Methods¶

Access the Stripe Customer Portal to:

Update your payment method
View invoices and payment history
Cancel your subscription

curl -X POST https://api.gremia.io/api/v1/billing/portal \
  -H "Authorization: Bearer $TOKEN"

The response contains a portal_url that redirects to Stripe's hosted portal.

Downgrading¶

Downgrading takes effect at the end of your current billing period. Your credits are not refunded but remain available until the period ends.

Credit Exhaustion¶

When your credits reach zero:

Active tasks — Currently running tasks complete but no new tasks can be started
Builder — Chat continues to work but manifest generation is paused
Notification — A warning appears in the Shell and web dashboard

Credits reset automatically at the start of each billing period (Pro plan) or can be topped up by upgrading your plan.

Webhooks¶

Gremia processes Stripe webhook events to keep billing state synchronized:

checkout.session.completed — Activates the new plan
invoice.paid — Resets credits for the new period
customer.subscription.deleted — Downgrades to Free

These are handled automatically; no configuration is needed on your end.