Settings, Tokens & Billing

AdHelix utilizes a transparent, usage-based AI Compute Token Economy. Every creative analysis is settled dynamically based on asset duration and complexity.

1. Itemized Credit Consumption Rates

Analysis credits represent granular GPU compute resources allocated to run Demucs audio track separation, Whisper speech transcription, OpenCV frame object detection, and 8-pillar taxonomy extraction:

2. The 5,000 Free Signup Credits Trial

• Immediate Grant: Every newly registered Organization automatically receives 5,000 Free Signup Credits loaded into their wallet.
• Verification Gate: The trial credits unlock for analysis jobs as soon as your Meta Business Account is connected.
• 30-Day Validity: Free trial credits are valid for 30 calendar days from registration, giving media buyers ample bandwidth to analyze 10 to 100 creatives without any credit card required.

3. Two-Phase Token Reservation State Machine

To prevent unexpected billing overages and protect users from failed executions, AdHelix operates a Two-Phase Reservation System:

stateDiagram-v2
  [*] --> Enqueued: User Clicks Analyze
  Enqueued --> Reserved: Credits Held in Wallet
  Reserved --> Processing: GPU Pipeline Active
  Processing --> Settled: Success (Credits Finalized)
  Processing --> Refunded: Pipeline Error (100% Refund)
  Enqueued --> Cancelled: User Cancels in Queue (100% Refund)
  Refunded --> [*]
  Cancelled --> [*]
  Settled --> [*]

1. Phase 1 (Reservation): When a creative is added to the analysis queue, the exact credit amount is held in temporary reservation.
2. Phase 2 (Settlement / Refund):
   • On Success: The credits are finalized and permanently deducted.
   • On Failure / Error: The full credit amount is instantly 100% refunded to your balance with an automated notification.
   • On Cancellation: If you cancel a pending job in the queue before processing starts, credits are immediately released.

4. Per-Brand Room Credit Budgets & Hard-Caps

Under Settings → Billing (/settings/billing), Organization Admins can allocate specific monthly credit limits to individual Brand Rooms:

• Safety Guardrail: Prevents one brand from consuming the organization's entire monthly credit pool.
• Automated Hard-Cap (BRAND_BUDGET_EXCEEDED): When a Brand Room hits 100% of its allocated monthly budget, further queueing is automatically paused until an admin reallocates credits or updates the monthly cap.

5. Monthly Subscriptions & 5-Day Rollover

For growing brands and scaling agencies, AdHelix offers monthly credit packages with a 5-Day Rollover Policy:

The 5-Day Rollover Window

Unused credits at the end of a billing cycle do not expire immediately. You have a 5-day grace rollover window to utilize remaining credits after your monthly renewal.

6. Team Roles & Permission Shields