> ## Documentation Index
> Fetch the complete documentation index at: https://docs.electronhub.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Understanding Credits

> Learn about all credit types and how they work

Credits are the currency used in Electron Hub to pay for AI model usage. This guide explains all the different types of credits and how they work.

## Types of Credits

<Accordion title="Weekly Credits" icon="repeat">
  **Weekly Credits** are credits that are automatically added to your account every **Sunday at 21:00 UTC** (9:00 PM UTC). The amount you receive depends on your subscription tier:

  | Tier       | Weekly Credits |
  | ---------- | -------------- |
  | Free       | \$0.25         |
  | Starter    | \$8            |
  | Plus       | \$15           |
  | Core       | \$30           |
  | Pro        | \$50           |
  | Business   | \$100          |
  | Enterprise | \$200          |

  <Warning>
    <strong>Important Notes:</strong>

    * Weekly credits refill every **Sunday at 21:00 UTC**
    * Unused weekly credits do <strong>not</strong> carry over to the next week
    * Your balance is automatically set to your weekly credits amount at refill time
    * Weekly credits are separate from permanent credits
  </Warning>
</Accordion>

<Accordion title="Permanent Credits" icon="wallet">
  **Permanent Credits** are credits you purchase with real money.

  <Card title="Key Features" icon="infinity" color="#10B981">
    * Never expire
    * Volume discounts available
    * Can be used alongside weekly credits
  </Card>

  See [Pay-as-You-Go](/billing/pay-as-you-go) for details.
</Accordion>

<Accordion title="Flex Credits" icon="wallet">
  **Flex Credits** (also called "Flex Wallet") are a savings feature that lets you save unused weekly credits for later use.

  <Info>
    **How it works:**

    * You can save up to **20% of your weekly credits** per week to your flex wallet
    * The total cap is **50% of your weekly credits** (e.g., if you get \$50/week, your flex wallet can hold up to \$25)
    * You can save at any time (no cooldown) — but the weekly save limit resets every Sunday at 21:00 UTC
    * Flex credits are used automatically when your regular balance runs out (if flex credits are enabled)
    * Flex balance rolls over until you use it
  </Info>

  <Card title="Example" icon="calculator" color="#F59E0B">
    * You have a Pro subscription (\$50/week)
    * Weekly save limit: \$10 (20% of \$50)
    * Maximum flex wallet: \$25 (50% of \$50)
    * If you save \$10 every week for 2.5 weeks, you'll have \$25 saved (the maximum)
  </Card>

  <Tip>
    <strong>When to use Flex Credits:</strong>

    * Enable flex credits if you want to build up a buffer for heavy usage weeks
    * Useful if you don't use all your weekly credits every week
    * Flex balance rolls over — save up over a few weeks and use it when you need extra credits
  </Tip>
</Accordion>

<Accordion title="Neutrinos" icon="zap">
  **Neutrinos** are special free usage requests for **free models** (models that end with `:free` suffix).

  <Info>
    **Key Points:**

    * All users get **10 Neutrinos per day** (resets at 21:00 UTC)
    * Neutrinos are used instead of credits for free models
    * You can earn more Neutrinos by watching ads (up to **200 daily**)
  </Info>

  <Card title="Ad Rewards (up to 3 ads per day)" icon="play" color="#F59E0B">
    * Base: **10** Neutrinos
    * 1st ad: **+30** Neutrinos (total: 40)
    * 2nd ad: **+60** Neutrinos (total: 100)
    * 3rd ad: **+100** Neutrinos (total: 200)
  </Card>

  <Warning>
    <strong>Important:</strong> Neutrinos are charged for <strong>all requests</strong> (failed, cancelled, and successful) - unlike regular credits which are only charged for successful/cancelled requests.
  </Warning>
</Accordion>

## How Credits are Deducted

<Card title="Deduction Priority" icon="list" color="#8B5CF6">
  Credits are deducted in this priority order:

  1. **Permanent credits** (if enabled and within monthly limit)
  2. **Regular balance** (weekly credits)
  3. **Flex credits** (if enabled)
</Card>

<Warning>
  **Charging Rules:**

  **Regular Credits:** Only charged for **successful** and **cancelled** requests. **Failed requests are NOT charged.**

  **Neutrinos:** Charged for **all requests** (failed, cancelled, and successful) - this is different from regular credits.
</Warning>

<Card title="Example: Successful Request" icon="check-circle" color="#10B981">
  * You have 5 permanent credits, 10 regular credits, and 3 flex credits
  * You make a request costing 15 credits
  * System uses: 5 permanent + 10 regular + 3 flex = 18 credits total (you have enough!)
</Card>

<Card title="Example: Failed Request" icon="x" color="#F59E0B">
  * You make a request that fails (e.g., model unavailable, timeout)
  * **Regular credits**: NOT charged (you keep your credits)
  * **Neutrinos**: Still charged (if using a `:free` model)
</Card>

## Credit Reset Times

<Columns cols={2}>
  <Card title="Weekly Refill" icon="repeat" color="#8B5CF6">
    * **Weekly credits**: Refill every **Sunday at 21:00 UTC**
    * **Neutrinos**: Reset every day at **21:00 UTC**
    * **Flex weekly save limit**: Resets every **Sunday at 21:00 UTC**
  </Card>

  <Card title="Never Reset" icon="infinity" color="#10B981">
    * **Permanent credits**: Never reset (they're permanent!)
    * **Flex credits balance**: Rolls over until used
  </Card>
</Columns>

<Info>
  <strong>Monthly spending limits:</strong> Reset on the 1st of each month (for permanent credits monthly limits)
</Info>

## Checking Your Balance

<Card title="Where to Check" icon="grid" color="#8B5CF6">
  You can check your balance:

  * In the [Electron Hub Dashboard](https://app.electronhub.ai)
  * Through the API by checking your user information
  * Balance includes: regular credits, flex credits (if enabled), and permanent credits (if enabled)
</Card>

## Managing Credit Settings

<Steps>
  <Step title="Access Dashboard">
    Go to the [Electron Hub Dashboard](https://app.electronhub.ai)
  </Step>

  <Step title="Navigate to Settings">
    Navigate to account settings
  </Step>

  <Step title="Configure Credits">
    * Toggle flex credits on/off
    * Toggle permanent credits on/off
    * Set permanent credits monthly limits
  </Step>
</Steps>

## Credit Transfers

<Warning>
  <strong>No transfers:</strong> Credits cannot be transferred between accounts. Each account's credits are tied to that specific account.
</Warning>
