---
title: "Credit usage"
description: "Read every credit pool and your AI budget on Subscription > Usage, follow each credit in the credit log, and see what the agent spent."
url: https://help.rankprompt.com/en/articles/66-credit-usage
collection: "Account & billing"
updated: 2026-11-19
language: en
---

# Credit usage

Read every credit pool and your AI budget on Subscription > Usage, follow each credit in the credit log, and see what the agent spent.

The **Usage** tab of **Subscription** shows how many credits you have in each pool, every credit added and spent, and what the agent spent from your AI budget. For what each action costs, see [Understanding credits](https://help.rankprompt.com/en/articles/16-understanding-credits.md).

## Opening it

Click the gear at the foot of the rail, open **Subscription** and choose the **Usage** tab. Under **Balances and history** it has three views: **Overview**, **Credit log** and **AI usage**.

On an agency's own domain (white label), only the account owner sees Subscription.

* * *

## Overview

### Credits

One card per pool. Each shows what is **Available**, how much you used and the total:

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Card</p></th><th colspan="1" rowspan="1"><p>What it holds</p></th></tr><tr><td colspan="1" rowspan="1"><p><strong>Monthly plan credits</strong></p></td><td colspan="1" rowspan="1"><p>Your plan's credits for this cycle: 150 on Starter, 500 on Pro, 1,000 on Agency, 2,000 on Agency Plus. Without a plan it reads <strong>No active plan</strong></p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>API add-on credits</strong></p></td><td colspan="1" rowspan="1"><p>The credits of your API plan (500 a month on API Starter, 2,000 on API Pro). Shown only when you have one</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Top-up credits</strong></p></td><td colspan="1" rowspan="1"><p>The packs you bought and the credits you earned (the 10 credits for confirming your email, the 50 trial credits, the survey). They never expire</p></td></tr></tbody></table>

Monthly plan credits reset each month and do not roll over. Annual plans get theirs every month too.

### AI budget

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Card</p></th><th colspan="1" rowspan="1"><p>What it holds</p></th></tr><tr><td colspan="1" rowspan="1"><p><strong>Monthly AI budget</strong></p></td><td colspan="1" rowspan="1"><p>The dollars your plan gives the agent each month: $1 on Free, $5 on Starter, $10 on Pro, $15 on Agency, $25 on Agency Plus</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Added AI budget</strong></p></td><td colspan="1" rowspan="1"><p>AI budget you bought with credits (<strong>Bought with credits · resets with your plan</strong>). Shown when you have some</p></td></tr></tbody></table>

* * *

## Which credits go first

Rank Prompt spends your monthly plan credits first, then API add-on credits, then top-up credits. Your top-ups only start to go down once the month's plan credits are used up.

* * *

## Credit log

The **Credit log** lists every credit added and spent, newest first. Filter it with **All**, **Credits**, **Debits** or **Pending**.

Each entry shows:

-   What happened: added, used, reserved or refunded, with the amount
    
-   Its status: **Completed**, **Pending** or **Canceled**
    
-   The date and time, and the pool it came from: **Monthly**, **API add-on** or **Top-up**
    
-   The brand, and the report or article it paid for
    
-   Who spent it, when a team member did
    
-   A note on the action, such as "Manual report analysis", "Scheduled report generation", "Content generation", "Brand audit" or "SEO rank check"
    

### Pending credits

Credits are reserved when you start an action, like analyzing a report, and settled once it finishes. While the work runs they show as **Pending**. If the action fails, the reservation is canceled and the credits come back. If only part of a report fails and that lowers what a prompt costs (say, 4 AI platforms asked and only 3 answered), the difference is refunded.

* * *

## AI usage

**AI usage** lists what the agent spent from your AI budget: each answer with the model, the tokens and the cost, plus the AI budget you added with credits.

Before most answers the agent searches this help center, so it explains the app as it works today. That search shows here too, as its own rows next to the answer (one per model it used, such as the embedding model), and it counts in the answer's cost. While your own OpenAI key is active, OpenAI bills your key for the answer and the search, so their rows here cost $0.

The agent needs a few cents of AI budget to start an answer: it starts one only while what is left covers a long answer. Below that, it says the budget ran out even if **Monthly AI budget** does not read exactly zero.

* * *

## AI budget

The AI budget is a separate balance, in dollars, for the agent and for AI edits of text and images in the article editor. Reports, articles, audits and outreach never touch it: they use credits.

### Adding AI budget

Open **Plans > AI budget** and click **Convert credits** on a pack:

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Credits</p></th><th colspan="1" rowspan="1"><p>AI budget</p></th></tr><tr><td colspan="1" rowspan="1"><p>20</p></td><td colspan="1" rowspan="1"><p>$5</p></td></tr><tr><td colspan="1" rowspan="1"><p>50</p></td><td colspan="1" rowspan="1"><p>$15</p></td></tr><tr><td colspan="1" rowspan="1"><p>120</p></td><td colspan="1" rowspan="1"><p>$40</p></td></tr></tbody></table>

Bigger packs give more AI budget per credit. AI budget you add this way is spent this billing cycle and resets with your plan.

When you run out mid-conversation, the app opens **Top up your AI budget** with the same packs. If you do not have enough credits for a pack, it tells you how many more you need and offers **Get credits**.

### Your own OpenAI key

On Starter and up, **Settings > Agent settings** lets you add your own OpenAI key. The agent then runs on your OpenAI account and does not spend your AI budget.

* * *

## Common costs

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Action</p></th><th colspan="1" rowspan="1"><p>Credits</p></th></tr><tr><td colspan="1" rowspan="1"><p>Ask 1 prompt on 1 to 3 picks in the AI platform list</p></td><td colspan="1" rowspan="1"><p>1</p></td></tr><tr><td colspan="1" rowspan="1"><p>Ask 1 prompt on 4 to 6 picks</p></td><td colspan="1" rowspan="1"><p>2</p></td></tr><tr><td colspan="1" rowspan="1"><p>Ask 1 prompt on 7 to 9 picks</p></td><td colspan="1" rowspan="1"><p>3</p></td></tr><tr><td colspan="1" rowspan="1"><p>Ask 1 prompt on 10 to 12 picks</p></td><td colspan="1" rowspan="1"><p>4</p></td></tr><tr><td colspan="1" rowspan="1"><p>Ask 1 prompt on every pick in the list</p></td><td colspan="1" rowspan="1"><p>5</p></td></tr><tr><td colspan="1" rowspan="1"><p>Generate an article</p></td><td colspan="1" rowspan="1"><p>10</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Show me what to fix</strong> on a report</p></td><td colspan="1" rowspan="1"><p>1 (the first per brand is free)</p></td></tr><tr><td colspan="1" rowspan="1"><p>Run a Brand Audit</p></td><td colspan="1" rowspan="1"><p>10</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Lighthouse audit</strong></p></td><td colspan="1" rowspan="1"><p>1</p></td></tr><tr><td colspan="1" rowspan="1"><p>Technical audit</p></td><td colspan="1" rowspan="1"><p>Free</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Find contacts</strong> in Outreach</p></td><td colspan="1" rowspan="1"><p>1 per 3 pages</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Find keywords like...</strong> (Google &gt; Keywords) or <strong>From a page</strong> (Add prompts)</p></td><td colspan="1" rowspan="1"><p>1; the same search or page is free for 24 hours</p></td></tr></tbody></table>

[Understanding credits](https://help.rankprompt.com/en/articles/16-understanding-credits.md) lists every other action.

* * *

## When credits run low or out

On a subscription or a trial, you get a notification in the app and by email when 25% of this period's credits are left, again at 10%, and when they run out. Turn it on or off in **Settings > Notifications** (**Low credit balance** and **Insufficient credits**).

At zero, actions that need credits stop until you add more. Your reports, articles and history stay. You can:

1.  **Top up**: buy a pack on **Plans > Top-ups** (50 credits for $18, 100 for $35, 200 for $65)
    
2.  **Upgrade**: a bigger plan adds its monthly credits right away
    
3.  **Wait**: your monthly credits come back at the start of the next cycle
    

* * *

## Frequently asked questions

### Do monthly credits roll over?

No. They reset each cycle, and unused ones are gone.

### Do top-up credits expire?

No. Top-up credits, including the ones you earned, never expire.

### Which credits are used first?

Monthly plan credits, then API add-on credits, then top-up credits.

### Can I see what used my credits?

Yes. The **Credit log** shows every charge with its date, its pool, the brand and the action.

### Why did a report use fewer credits than I expected?

Part of it may have failed. When a failure lowers what a prompt costs, the difference comes back, and the credit log shows the refund.

### Is the AI budget the same as credits?

No. Credits pay for reports, articles, audits and outreach. The AI budget pays for the agent and AI edits in the article editor. You can turn credits into AI budget, not the other way round.

### Whose AI budget does a teammate spend?

The brand owner's, the way credits work. Agent chats, AI edits and Community drafts inside a brand you were invited to spend its owner's AI budget, and the chat shows that budget. A teammate with their own OpenAI key runs the agent on that key instead. Only the owner can top the budget up.

* * *

## Next steps

-   [Understanding credits](https://help.rankprompt.com/en/articles/16-understanding-credits.md): what every action costs
    
-   [Plans and subscription](https://help.rankprompt.com/en/articles/65-plans-and-subscription.md): change your plan for more credits
    

* * *

## Questions?

Email [support@rankprompt.com](mailto:support@rankprompt.com) and I'll help.
