How Credits Work

AICMOHQ uses a predictable, consumption-based credit system. Every research, drafting, publishing, and video generation action has a defined credit cost.

Account Balance Structure

Your total available balance consists of two distinct pools:

Total Available Credits = Monthly Subscription Allowance + One-Time Top-Up Balance

1. Monthly Subscription Credits

• Granted on your billing cycle date.
• Valid for the active monthly billing period.
• Resets to your plan quota every month (no rollover).
• Consumed first before drawing from top-up credits.

2. Top-Up Credits

• Purchased as standalone packs (Starter, Growth, Scale).
• Never expire and remain in your account across billing cycles.
• Used automatically whenever your monthly subscription credits reach zero.

Credit Deduction Order & Safety Invariant

Credit operations are managed server-side via Supabase RPC functions (deduct_credits).

1. Pre-flight Gate (requireCredits):
   • Before invoking expensive LLMs, video renderers, or external APIs, the system verifies your balance.
   • If your balance is insufficient, the request stops immediately with an insufficient_credits error (HTTP 402).
   • Your account is never driven into negative balances.
2. Idempotent Runs:
   • Deductions can be associated with a unique runId. Retrying a transient network timeout will not bill your account twice for the same run.
3. Automatic Refunds on Failure:
   • If an automated rendering or publishing job fails due to an upstream provider outage, the system invokes failJobAndRefund() to restore the debited credits back to your ledger.

Complete Credit Cost Schedule

Action Category	Action	Credit Cost	Description
Social Publishing	X / Twitter Post	5 credits	Single tweet or multi-tweet thread
	LinkedIn Post	7 credits	Profile or company page update
	Reddit Reply Draft	9 credits	Karma-safe community answer
	Hacker News Post	9 credits	Discussion starter / Show HN
Longform & Content	Blog Article	18 credits	Full markdown educational post
	Image Generation	5 credits	Standard social graphic
	Premium Image Gen	12 credits	High-resolution brand visual
Research & SEO	SEO / GEO Analysis	10 credits	Keyword & search engine positioning
	GEO Citation Scan	30 credits	Probes AI answer engines (ChatGPT, Perplexity)
	Site Intake / Refresh	10 credits	Ingests website text into brand voice guide
	Prospect Scan	5 credits	Discovers high-intent lead opportunities
	Weekly Acquisition Report	10 credits	Synthesizes GA4 attribution & conversions
Outreach	Email Outreach Send	8 credits	Per sent email
	DM Outreach (X / LinkedIn)	5 credits	Per sent direct message
Creative Video Studio	Storyboard Plan	10 credits	Multi-scene video script
	Product Screen Capture	5 credits	Per automated browser capture scene
	Video Render (per sec)	2 credits	Per rendered second of MP4 output
	Voiceover & Audio Sync	6 credits	Human-like voice synthesis + soundtrack
	Visual QA Review	3 credits	Automated frame & sync verification
	Full Product Demo	150 credits	Complete end-to-end demo video
	Feature Walkthrough	120 credits	Feature launch video
Conversational AI	Talk to AI CMO	Variable	Calculated from message token length

Purchasing Top-Ups

You can top up credits at any time from the dashboard under Settings → Billing:

• Starter Top-Up: 860 credits for $45 ($0.052 / credit)
• Growth Top-Up: 2,000 credits for $90 ($0.045 / credit)
• Scale Top-Up: 4,600 credits for $180 ($0.039 / credit)