Every control in RodGrid that spends AI credits carries its price: Explain · 8 credits in the Explain panel, Generate Architecture Analysis - 25 credits in the Analysis panel, Submit ranked (8 cr) at the end of a Challenge. Here is where those credits come from, why the numbers differ, and what happens when a run would cost more than the button said.
A balance, not a tier
Architecture Analysis, Explain, the PRD, the pattern review, the diagram generators and a Challenge's AI steps all ask one question before they run: does your balance cover this? Only Architecture intake also asks about your plan: it needs Pro or above to start, and its runs still spend credits. That is why a Free account can run the rest at all, and why a credit pack works whatever plan you are on. It also means credits buy runs, not access: no pack opens a feature your plan does not include, such as Architecture intake on Free.
Where credits come from
- A one-time welcome grant of 10 credits when the account is created. It expires 90 days after signup, and it exists to be spent on the feature you are unsure about, not saved.
- A monthly allowance on the Pro plan and above: 25 credits a month on Pro, 50 on Premium. It refreshes at the start of each calendar month (UTC), and anything unused is gone, not banked.
- Credit packs you buy, which last a year from purchase whatever plan you are on. They come in sizes from 100 credits for $10 to 500 for $40, in the AI credits section of the pricing page; Add credits in the usage panel on your dashboard takes you there; on Free it shows only while you still hold credits. Unused pack credits are forfeited if you close the account.
On Pro and above there is one more source, kept apart from the rest: challenge credits, 40 a month that reset with the allowance and do not carry over, used only by a Challenge's AI steps (grading, hints, step checks and defense follow-ups). The Challenges page shows what is left, as in "32 / 40 challenge credits". Practising draws on them first, so until they run out it does not eat the allowance you were saving for an Architecture Analysis. On Free, those steps come out of the same balance as everything else.
What a run costs
Each feature has a set price, and a very large Grid (over about 200 KB of diagram data) adds a flat 5-credit surcharge; a Challenge's AI steps never take it. A Hint in a Challenge costs 2, Explain and a ranked Challenge submission 8 each, a PRD 15 and an Architecture Analysis 25; every other price is on its button.
So the welcome grant pays for one Explain on a Grid under that size, or one ranked submission, or a hint and then a ranked submission. It does not cover an Architecture Analysis or a PRD; on Free, those take a pack.
Which credits go first
- Challenge credits, when the run is a Challenge step and you are on Pro or above.
- The monthly allowance.
- The welcome grant and your packs, the batch that expires soonest first.
So the 90-day grant is spent before a pack bought after it, and a pack only pays for what the month's allowance cannot cover. In your usage panel the grant and the packs share one line, Purchased AI credits, even though nobody paid for the grant. Under it is the nearest expiry date, and when only part of the balance goes on that date, how many credits go with it.
When the price moves after you clicked
Most controls already include the surcharge in the price they show, and say why underneath: "This diagram is large (240 KB), which adds 5 credits." If the server still works out a higher cost than the one you were shown, because of the surcharge or because the price changed while your tab was open, the run is refused rather than charged. A dialog titled This action now costs more gives the new figure ("This action costs 30 AI credits, not 25. Nothing has been charged.") and offers Continue for 30 credits or Cancel. Cancel records nothing, and the next attempt asks again.
At zero, and when a run fails
When your balance cannot cover a run, the control is disabled and says why, and a run refused for balance reserves nothing. A pack, or on Pro and above the next month's allowance, gets you running again.
A run that fails is not automatically free. An Architecture Analysis that delivers nothing returns its credits in full. For the other features, credits come back when the failure was on the AI service's side: it could not be reached, returned an error, or did not answer within the time limit. Once the model has answered, the run is paid for, whether or not you liked the answer, and a Challenge attempt whose review could not be used is charged too. Closing the tab is not a failure: the work runs on the server, finishes without you, and the result is waiting when you reopen the Grid.
What a run gives you is in that feature's own guide, from AI Architecture Analysis: a review of your diagram to After you submit: the score, the defense and the reference.
Spend ten credits on purpose
Open the URL Shortener Challenge with Start classic. Place the first components, press Hint (2 cr) where you are unsure what comes next, then finish and press Submit ranked (8 cr). On a new Free account that is the whole welcome grant, and the Purchased AI credits line in your usage panel is gone. On Pro, with at least 10 challenge credits left, the counter on the Challenges page drops by 10 while your monthly allowance stays put. Afterwards, on a Diagram Grid under 200 KB, set the price on Explain against the one on Generate Architecture Analysis: the first fits a fresh welcome grant, the second needs more than it holds.