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

# AI credits

> How your monthly agent credit allowance works, what spends it, and how to buy refill packs that never expire.

export const StillStuck = ({topic}) => <div className="ck-callout ck-callout--note" role="note">
    <p className="ck-callout__body">
      <strong>Still stuck{topic ? ` with ${topic}` : ''}?</strong>{' '}
      Check <a href="/platform/help/troubleshooting">Troubleshooting</a> first —
      it covers the failures we see most often. If that does not resolve it,{' '}
      <a href="/platform/help/contact-support">contact support</a> and include
      your workspace name and the time the problem happened, so we can find the
      matching entry in your audit log.
    </p>
  </div>;

export const TaskHeader = ({before, time, after}) => <div className="ck-task">
    {before ? <div className="ck-task__cell">
        <div className="ck-task__title">Before you start</div>
        <p className="ck-task__body">{before}</p>
      </div> : null}

    {time ? <div className="ck-task__cell">
        <div className="ck-task__title">Takes about</div>
        <p className="ck-task__body">{time}</p>
      </div> : null}

    {after ? <div className="ck-task__cell">
        <div className="ck-task__title">When you're done</div>
        <p className="ck-task__body">{after}</p>
      </div> : null}
  </div>;

export const Path = ({steps = []}) => <span className="ck-path">
    {steps.map((s, i) => <span key={i} className="ck-path__step">
        {i > 0 ? <span className="ck-path__sep" aria-hidden="true">
            ›
          </span> : null}
        {s}
      </span>)}
  </span>;

export const Availability = ({editions = ['all'], plans, roles, note}) => {
  const list = editions.includes('all') ? ['clinic', 'pharmacy', 'lims'] : editions;
  return <div className="ck-avail" role="note" aria-label="Feature availability">
      <span className="ck-avail__label">Available in</span>

      {list.map(e => <span key={e} className={`ck-pill ck-pill--${e}`}>
          {EDITION_LABELS[e] || e}
        </span>)}

      {plans ? <span className="ck-avail__label">Plan</span> : null}
      {plans ? <span className="ck-pill ck-pill--plan">{plans}</span> : null}

      {roles ? <span className="ck-avail__label">Who</span> : null}
      {roles ? <span className="ck-pill ck-pill--role">{roles}</span> : null}

      {note ? <span className="ck-avail__note">{note}</span> : null}
    </div>;
};

<Availability editions={['all']} plans="Every plan has an allowance; the size varies" roles="Owner, Manager" />

Credits are what your AI agents run on. Your plan grants a batch every month; when those run out, agents stop until the next grant or until you top up.

<Path steps={['Sidebar', 'AI Agents', 'Agent credits']} />

<TaskHeader before="Owner or manager access, and a payment card if you are buying a refill" time="2 minutes" after="A visible credit balance, and refill credits that never expire" />

## What you get each month

Clinic & Hospital workspaces are granted:

| Plan      | Monthly credits |
| --------- | --------------- |
| Free      | 50              |
| Starter   | 1,000           |
| Essential | 2,500           |
| Team      | 5,000           |

The **Agent credits** card states the arrangement: "Granted monthly with your plan. Each agent run debits per model (Claude/GPT 3.5 · Gemini 3.0)."

## What spends them

Every step an agent takes that involves a model costs credits — the agent's own reasoning, and the classification steps a workflow runs to decide what to do next. A longer workflow with more branches costs more than a single reply, and a larger model costs more than a smaller one.

Everything else in ClinikEHR — notes, appointments, dispensing, results — costs no credits at all.

## The two rules that decide when you need to buy

1. **Your monthly plan credits are spent first.** Refill packs are only touched once the monthly grant is exhausted.
2. **Refill packs never expire.** A pack you buy today is still there in six months. There is no "use it or lose it" on a refill.

Together those mean a refill is a safety net rather than a subscription: buy one when your monthly allowance runs short, and it sits behind the allowance until it is needed.

## Top up

<Steps>
  <Step title="Open the Agent credits card">
    It sits on the **AI Agents** page and shows your balance over "credits available". The same balance is on **Dashboard** → **Subscription** as **Agent Studio Credits**.
  </Step>

  <Step title="Select Top up">
    The **Top up agent credits** dialog explains: "Refill packs never expire and are used after your monthly plan credits. You'll complete payment securely on the next screen."
  </Step>

  <Step title="Choose a pack">
    Four sizes, priced in US dollars:

    | Credits | Price |
    | ------- | ----- |
    | 1,000   | \$20  |
    | 2,500   | \$40  |
    | 5,000   | \$75  |
    | 10,000  | \$150 |
  </Step>

  <Step title="Pay">
    The tile shows **Starting…** and hands you to the payment page. On success the balance rises and a **Refill** line appears under **Recent activity**.
  </Step>
</Steps>

<Warning>
  **Buying a pack charges your card immediately.** It is a one-off purchase, not a subscription, and it is not refundable once the credits are on the balance. Check the pack size before you confirm — the tiles sit next to each other and the largest is more than seven times the smallest.
</Warning>

## Reading the ledger

**Recent activity** on the card labels every movement, so you can see where a balance went:

| Label                  | Means                                                 |
| ---------------------- | ----------------------------------------------------- |
| **Plan grant**         | Your monthly allowance arriving                       |
| **Refill**             | A pack you bought                                     |
| **Agent run**          | Credits spent by an agent                             |
| **Hold** / **Release** | Credits reserved while a run is in flight, then freed |
| **Refund**             | Credits returned after a failed run                   |
| **Expired**            | A grant that has been superseded                      |
| **Adjustment**         | A correction made by support                          |

## These are not your clinical credits

<Info>
  Two separate balances exist and they are not interchangeable. **Agent Studio Credits** pay for AI agent runs — this page. **Clinical Credits**, on the same **Subscription** screen, pay for per-use clinical services such as eLabs, insurance claims, eligibility checks and attachments. Topping up one does not help the other, and a claim that says it needs credits means the clinical balance.
</Info>

## Check it worked

* The **Agent credits** card shows the new, higher balance.
* **Recent activity** has a **Refill** line for the pack you bought.
* The charge appears under **Billing** → **Payment History**, typed **Top-Up**. See [Your subscription invoices and receipts](/platform/plans/invoices-and-receipts).
* An agent that had stopped now runs.

## If something goes wrong

<AccordionGroup>
  <Accordion title="Could not start checkout">
    The payment page did not open. Try again, and if it still fails check whether your subscription is **Past Due** — a lapsed subscription blocks the purchase. See [Change your plan](/platform/plans/change-plan).
  </Accordion>

  <Accordion title="I paid but the balance has not moved">
    Reload the page. Confirmation from the payment provider can take a minute. If the charge shows under **Payment History** but the balance has not risen after five, [contact support](/platform/help/contact-support) with the time of the payment.
  </Accordion>

  <Accordion title="My balance dropped faster than I expected">
    Check **Recent activity**. A workflow that classifies then acts spends on both steps, and a bigger model costs more per run. Reducing the number of steps, or choosing a smaller model for the routine ones, is the lever.
  </Accordion>

  <Accordion title="An agent stopped mid-conversation">
    You ran out. The monthly grant returns on your renewal date; a refill pack is available immediately. Published agents stop serving the public when the balance is empty, so top up before you publish something customer-facing.
  </Accordion>

  <Accordion title="The Top up button is not there">
    Only owners and managers can buy credits. Ask one of them.
  </Accordion>
</AccordionGroup>

## Related

<Columns cols={2}>
  <Card title="AI agents" icon="https://mintcdn.com/clinikehr/nLyvBRumcl1Yk8z3/images/icons/robot.svg?fit=max&auto=format&n=nLyvBRumcl1Yk8z3&q=85&s=4d019f2f70988b5ec97273b307339235" href="/platform/ai/agents" width="24" height="24" data-path="images/icons/robot.svg">
    Build an agent, choose its model, and see what each run costs you.
  </Card>

  <Card title="Publishing an agent" icon="https://mintcdn.com/clinikehr/gjlpJWWKqjyYNRzM/images/icons/globe.svg?fit=max&auto=format&n=gjlpJWWKqjyYNRzM&q=85&s=80fb437fa57114503e6e15ce57caea44" href="/platform/ai/publishing-agents" width="24" height="24" data-path="images/icons/globe.svg">
    Putting an agent in front of the public — and why the balance matters more then.
  </Card>
</Columns>

<StillStuck topic="a credit balance that does not look right" />