Credits
What spends credits in Victoria AI, how balances roll over, and how an API or MCP integration finds out that the balance has run out.
Last updated
Credits pay for the AI work Victoria AI does on your behalf. 1 credit is 1,000 tokens. Every plan includes a monthly grant, and packs of credits can be bought on top.
What spends credits
| Work | Cost |
|---|---|
| Writing a lead's AI Personalization fields | About 3 credits per lead |
| An AI Appointment Setter conversation | About 1.5 credits |
| A Lead database search | About 0.8 credits per result |
| An email found for a lead | About 3.3 credits |
The figures are averages and depend on how much the model reads and writes. A search page that comes back short is refunded to what was returned, and an email that isn't found is refunded.
No REST request spends credits at the moment you make it. Creating an AI field or turning the Appointment Setter on costs nothing until the campaign sends; the credits are spent as each lead is personalized and each reply is answered. Over MCP, find_leads and add_leads_from_search spend credits when they run, and quote the cost first.
Balances and roll-over
Purchased credits never expire. A plan's monthly grant rolls over 1 cycle: what you don't use this month is still there next month, up to 2 times the monthly amount in total.
When the balance runs out
Over MCP, a tool that would spend credits with no balance to spend answers a tool result with success: false and error: "INSUFFICIENT_TOKENS". Treat it as a stop, not a retry: the call succeeds again only after credits are added in the app.
The REST API has no error code for an empty balance, because no REST request spends credits at the time it's made. The related refusals are 403 NO_ACTIVE_SUBSCRIPTION, when the organization has no active subscription, and 403 TRIAL_LEAD_CAP_REACHED, when a trial has used its lead quota; details on the second carries the cap, used and remaining counts. Both are listed under Error codes.
Plan prices
Plan prices, included credits and pack sizes are on the marketing site's pricing page, which has a Markdown export at versionseven.ai/pricing.md. This guide doesn't repeat them.