Skip to main content

​
Overview

Studley AI uses a credit-based system to manage fair usage of AI-powered features. Credits are consumed when you generate study materials like quizzes, flashcards, and study guides.

​
Starting Balance

When you create a new account:
  • 5,000 free credits automatically added to your account
  • Start generating study materials immediately
  • No credit card required to sign up
New users get 5,000 credits to explore all features and generate plenty of study materials before needing to purchase more.

​
Credit Costs

​
Generation Costs

Different tools consume different amounts of credits:
  • Quiz Generator: 20 credits per quiz
  • Flashcard Generator: 20 credits per set
  • Study Guide Generator: 20 credits per guide
  • Notes Generator: 20 credits per conversion
  • Essay Grader: 20 credits per essay
  • Writing Prompts: 20 credits per prompt

​
Free Features

Some features are completely free (0 credits):
  • AI Workspace Chat: Free unlimited messages
  • GPA Calculator: Free to use
  • Pomodoro Timer: Free focus timer
  • Citation Generator: Free citations
  • Library Management: Free storage and organization
  • Viewing Content: Free to review saved materials

​
Checking Your Balance

​
Dashboard Display

Your current credit balance is displayed:
  • Sidebar: Shows “X credits” in the bottom section
  • Workspace Header: Displays “Credits: X” in the minimal workspace
  • Account Page: Full credit history and balance

​
Real-Time Updates

Your credit balance updates immediately:
  1. After each generation completes
  2. When credits are deducted
  3. When credits are added (purchase or bonus)

​
Using Credits

​
Generation Workflow

1

Select Generator

Choose a study material generator from the dashboard.
2

Check Cost

The generator shows the credit cost (e.g., “Cost: 20 credits”) before you generate.
3

Generate Content

Click “Generate” to create your study material.
4

Credits Deducted

The system:
  • Verifies you have sufficient credits
  • Deducts the cost atomically (prevents double-charging)
  • Generates the content
  • Updates your balance
5

Content Delivered

Your study material is generated and saved to your library.

​
Insufficient Credits

If you don’t have enough credits:
  1. A modal appears showing insufficient balance
  2. Displays your current balance and required credits
  3. Prompts you to purchase more credits
  4. Generation is blocked until you have enough credits

​
Credit Transactions

​
Atomic Deduction

Credits are deducted atomically to prevent:
  • Double-charging for the same generation
  • Race conditions with concurrent requests
  • Credit balance errors

​
Transaction History

View your complete credit history:
  • All generations with timestamps
  • Credits used per item
  • Remaining balance after each transaction
  • Purchase history (when available)

​
Pricing

​
Current Model

Studley AI operates on a free-to-use model:
  • 100% free with unlimited usage
  • No premium tiers or paid plans
  • No credit card required
  • No hidden charges
The platform is currently free with the 5,000 starting credits. Future pricing models may be introduced, but early users will receive grandfathered benefits.

​
Credit Purchases (Future)

When credit purchases are enabled:
  • Pricing tiers: Multiple credit packages
  • Bulk discounts: Save more when buying larger packages
  • Auto-refill: Optional automatic credit top-ups
  • Payment methods: Credit card, PayPal, etc.

​
Credit Usage Tracking

​
Usage Statistics

Track how you use credits:
  • Total generated: Count of all study materials created
  • Credits used: Total credits consumed
  • Credits remaining: Current balance
  • Usage by type: Breakdown by quiz, flashcards, etc.

​
API Endpoint

Get Credit Balance:
  • Endpoint: GET /api/credits/balance
  • Response: { balance: number, totalUsed: number }
Get Credit History:
  • Endpoint: GET /api/credits/history
  • Response: { transactions: Transaction[] }

​
Maximizing Your Credits

​
Tips to Save Credits

  1. Combine Topics: Generate one comprehensive quiz instead of multiple small ones
  2. Edit and Reuse: Modify existing content rather than regenerating
  3. Use Free Tools: AI Workspace chat is free for Q&A
  4. Quality Over Quantity: Generate fewer, high-quality materials
  5. Organize Well: Use folders to avoid duplicate generations

​
Free Alternatives

For unlimited free usage without credits:
  • Use Public Tools without logging in (content stored locally)
  • Browse and study saved materials (no credit cost)
  • Use the GPA Calculator and Pomodoro Timer
  • Organize your existing library

​
Credit System Architecture

​
Database Schema

Credit Balance: Stored in the users table: 
users (
  id UUID PRIMARY KEY,
  email TEXT,
  credits INTEGER DEFAULT 5000,
  ...
)
Credit Transactions: Stored in the credit_usage table: 
credit_usage (
  id UUID PRIMARY KEY,
  user_id UUID REFERENCES users(id),
  amount INTEGER,
  type TEXT, -- 'generation', 'purchase', 'bonus'
  description TEXT,
  created_at TIMESTAMPTZ DEFAULT NOW()
)

​
Atomic Operations

Credits are deducted using atomic database transactions: 
// Atomic credit deduction
await prisma.user.update({
  where: { id: userId },
  data: {
    credits: { decrement: cost }
  }
})
This ensures:
  • No race conditions
  • Accurate balances
  • Transaction integrity

​
Credit Refunds

​
Refund Policy

Credits may be refunded if:
  • Generation fails due to system error
  • Content quality is significantly below standard
  • Duplicate charges occur due to bugs

​
Requesting a Refund

1

Contact Support

Email support at [email protected] with:
  • Your account email
  • Transaction timestamp
  • Reason for refund request
2

Review Process

Support reviews your request and verifies the issue.
3

Credit Restoration

If approved, credits are added back to your account with a transaction record.

​
Bonus Credits

​
Earning Bonus Credits (Future)

Planned ways to earn extra credits:
  • Referrals: Invite friends to earn credits
  • Achievements: Complete milestones for bonuses
  • Promotions: Special events and campaigns
  • Feedback: Provide valuable product feedback
  • Beta Testing: Test new features early

​
Credit Expiration

Currently, credits do not expire:
  • Use them at your own pace
  • No pressure to generate content quickly
  • Balance carries forward indefinitely
Future changes to expiration policy will be communicated well in advance, and existing credits will be grandfathered.

​
Fair Usage Policy

To ensure system availability for all users:
  • Rate limiting: Prevent rapid-fire generations
  • Quality checks: Ensure legitimate usage
  • Abuse prevention: Detect and prevent system abuse
  • Account suspension: Extreme abuse may result in account action

​
Rate Limits

  • Maximum generations per minute: 10
  • Maximum generations per hour: 100
  • Cooldown period: 1 second between requests

​
Troubleshooting

​
Credits not deducted?

  • Check your credit history
  • Verify generation completed successfully
  • Refresh the page to see updated balance

​
Charged twice for one generation?

  • Check transaction history for duplicates
  • Contact support for refund
  • Atomic operations prevent this in most cases

​
Balance shows incorrect amount?

  • Refresh the page
  • Log out and log back in
  • Check recent transactions
  • Contact support if discrepancy persists

​
Can’t generate despite having credits?

  • Verify you have enough for the specific tool (20 credits)
  • Check if you’re hitting rate limits
  • Try again in a few seconds
  • Contact support if issue continues

Build docs developers (and LLMs) love

Get started for freeTalk to us