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

# Credit System Guide

> Understanding how credits work in Junis

## Overview

Credits are the currency for AI agent usage in Junis. Every AI model interaction consumes credits based on the model's complexity and token usage.

<Info>
  **1 Credit ≈ \$1 USD** equivalent in AI model usage. Actual consumption varies by model.
</Info>

***

## How Credits Work

### Credit Consumption

When you send a message or run an agent workflow:

1. **Input Processing**: Credits are calculated based on input tokens
2. **Model Execution**: The AI model processes your request
3. **Output Generation**: Additional credits are consumed for generated content
4. **Credit Deduction**: Total usage is deducted from your balance

### Cost Factors

| Factor              | Impact                                                                             |
| ------------------- | ---------------------------------------------------------------------------------- |
| **Model Selection** | Premium models (Claude Opus, GPT-4) cost more than efficient models (Claude Haiku) |
| **Input Length**    | Longer prompts and context consume more credits                                    |
| **Output Length**   | Longer responses cost more                                                         |
| **Tool Usage**      | External tool calls may add to credit consumption                                  |

***

## Checking Your Balance

### From the Dashboard

Your current credit balance is displayed in the top navigation bar after logging in.

### From the Subscription Page

For detailed balance information:

1. Go to `/subscription`
2. View your **Credit Balance** card
3. See total credits and recent usage

### From the Usage Page

For historical usage data:

1. Go to `/usage`
2. View credit consumption over time
3. See breakdown by agent and model

***

## Credit Sources

### Subscription Credits

Monthly subscriptions include credits that refresh each billing cycle:

| Plan  | Monthly Credits |
| ----- | --------------- |
| Basic | 20 credits      |
| Pro   | 195 credits     |

<Warning>
  Subscription credits do not roll over. Unused credits expire at the end of each billing period.
</Warning>

### One-Time Purchases

Credits purchased individually:

| Package  | Credits    |
| -------- | ---------- |
| Token 30 | 30 credits |
| Token 60 | 60 credits |
| Token 95 | 95 credits |

<Check>
  One-time purchase credits **never expire**. Use them whenever you need extra capacity.
</Check>

***

## AI Model Pricing

Different AI models have different credit costs. Generally:

<CardGroup cols={3}>
  <Card title="Economy" icon="leaf">
    **Claude Haiku**

    Fast, affordable for simple tasks
  </Card>

  <Card title="Balanced" icon="scale-balanced">
    **Claude Sonnet**

    Best value for most use cases
  </Card>

  <Card title="Premium" icon="gem">
    **Claude Opus**

    Maximum capability for complex tasks
  </Card>
</CardGroup>

<Tip>
  **Pro Tip**: Use Claude Sonnet for most tasks. It offers an excellent balance of quality and cost.
</Tip>

***

## Optimizing Credit Usage

### Best Practices

<AccordionGroup>
  <Accordion title="Choose the right model" icon="microchip">
    * Use **Haiku** for simple Q\&A and classification
    * Use **Sonnet** for general tasks and content generation
    * Reserve **Opus** for complex reasoning and analysis
  </Accordion>

  <Accordion title="Write efficient prompts" icon="pencil">
    * Be clear and concise in your instructions
    * Avoid unnecessary context
    * Use system prompts to set agent behavior once
  </Accordion>

  <Accordion title="Use agent workflows wisely" icon="network-wired">
    * Design efficient Sequential/Parallel flows
    * Avoid redundant agent calls
    * Cache results when possible (via agent instructions)
  </Accordion>

  <Accordion title="Monitor usage regularly" icon="chart-line">
    * Check the Usage page weekly
    * Identify high-consumption agents
    * Adjust configurations as needed
  </Accordion>
</AccordionGroup>

***

## Low Balance Alerts

When your credit balance runs low:

1. **Warning**: Yellow indicator when below 10% of monthly allocation
2. **Critical**: Red indicator when below 5%
3. **Depleted**: Agent executions may be limited

<Tip>
  Enable email notifications in Settings to receive low balance alerts.
</Tip>

***

## Credit FAQ

<AccordionGroup>
  <Accordion title="What happens when I run out of credits?">
    Agent executions may be paused or limited. You can purchase additional credits at any time or wait for your next subscription renewal.
  </Accordion>

  <Accordion title="Can I get a refund for unused credits?">
    Subscription credits are non-refundable. One-time purchases may be eligible for refund within 7 days if unused. Contact support for assistance.
  </Accordion>

  <Accordion title="Do credits transfer between organizations?">
    No, credits are tied to the user account. However, your credits work across all organizations you belong to.
  </Accordion>

  <Accordion title="How accurate is the credit balance display?">
    Credit balance updates in real-time. There may be a brief delay (1-2 seconds) during active agent execution.
  </Accordion>
</AccordionGroup>

***

## Related Guides

<CardGroup cols={2}>
  <Card title="Subscription Guide" icon="credit-card" href="/guides/billing/subscription">
    Manage your subscription plan
  </Card>

  <Card title="Agent System" icon="robot" href="/getting-started/agent-system">
    Learn about agent types and optimization
  </Card>
</CardGroup>