Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.molin.ai/llms.txt

Use this file to discover all available pages before exploring further.

Every task you run on Ninja costs credits. This page explains where credits come from, the order in which they are spent, and how the total you see in your dashboard is calculated.

Types of credits

You can hold up to four different types of credits at the same time. Each one has its own rules about when it refills and whether unused credits roll over.
TypeRefills whenRolls over?Where it comes from
Purchased creditsNever automaticallyYes, kept until usedYour signup bonus, paid top-ups, referral rewards
Free daily creditsEvery day at 00:00 UTCNo, unused credits are lostEvery account, including paid plans, gets 100 free credits per day
Plan monthly creditsWhen a new billing cycle startsNo, reset at the cycle startYour paid plan’s monthly allowance (Plus = 2,000/month, Pro = 15,000/month, and so on)
Promo creditsDefined per promoNo, expire at promo endTime-limited promotions (e.g. a launch event that grants every shop extra credits)
The most important distinction is between purchased credits (which accumulate over time) and free daily / plan monthly / promo credits (which are usage caps that reset and do not carry over).

Free daily credits do not stack

Free daily credits are a budget that refills, not a deposit. If you don’t use Ninja today, you still start tomorrow with 100, not 200. Unused credits are lost at midnight UTC. Plan monthly and promo credits work the same way. Only purchased credits roll over indefinitely.

In what order are credits spent?

When you run a task, Ninja drains your credit buckets in this exact order:
  1. Promo credits first
  2. Free daily credits next
  3. Plan monthly credits next (if you are on a paid plan, oldest active billing cycle first)
  4. Purchased credits last
The system moves to the next bucket only when the current one is empty. A single task can be paid for from multiple buckets at once. For example, a 50-credit task could be covered by 30 promo credits + 20 free daily credits. This order is designed to drain the credits that expire soonest before touching the ones you have paid for.

How your “credits remaining” total is calculated

The single number you see in your dashboard is the sum of all four buckets:
Credits remaining = Purchased + Promo remaining + Free daily remaining + Plan monthly remaining
So a Free-plan user with no purchased credits and a full daily bucket will see 100. A Plus user at the start of their billing cycle with 500 purchased credits and a full daily bucket will see 500 + 100 + 2,000 = 2,600.

Worked example 1: a Free-plan user, two tasks in one day

Anna signs up and receives a 500-credit signup bonus.
DayWhat she doesBuckets after
0Signs upPurchased: 500, Free daily: 100/100 → total 600
1Runs a task that costs 30Free daily covers all 30. Free daily: 70/100 → total 570
1Runs another task that costs 80Free daily covers the first 70, the last 10 come from purchased. Purchased: 490, Free daily: 0/100 → total 490
2 (00:00 UTC)Free daily resetsPurchased: 490, Free daily: 100/100 → total 590
2No usageSame → total 590
3No usageSame → total 590
Notice that the total stays at 590 from day 2 onwards. The 100 free daily credits refill her bucket, they do not add to her purchased balance.

Worked example 2: a paid-plan user

Bela is on the Plus plan. He gets 2,000 monthly credits + 100 free credits per day, and he also has 500 purchased credits from a previous top-up. His billing cycle just renewed. He runs a single task that costs 250 credits.
BucketBeforeSpent on this taskAfter
Promo000
Free daily1001000
Plan monthly (current cycle)2,0001501,850
Purchased5000500
The task drained all 100 of today’s free credits and 150 from his monthly allowance. His purchased credits were not touched — they are kept for when his monthly allowance runs out later in the cycle.

Worked example 3: a promo period

The “Nano Banana Launch” promo grants every shop on Shopify, UNAS, Shoprenter, Shoper, and Scraper feeds an extra 10,000 credits for 5 days. Csilla starts the promo with 200 purchased credits and a fresh 100 daily bucket. She runs a single task that costs 3,000 credits.
BucketBeforeSpentAfter
Promo10,0003,0007,000
Free daily1000100
Purchased2000200
The promo bucket is drained first because it is the highest priority, so her purchased and free daily credits are untouched. The remaining 7,000 promo credits stay available until the promo ends, after which any unused promo credits disappear.

Frequently asked questions

The Free plan gives you 100 credits of usage per day, not 100 credits added to your balance each day. Unused free credits do not carry over. If you do not use Ninja today, tomorrow you will still start with 100, not 200.
The Free plan does not grow your balance over time. It gives you a 100-credit daily usage budget that resets every day at 00:00 UTC. To accumulate credits, you need to buy a top-up, earn referral rewards, or subscribe to a paid plan.
No, we never bill you money for credit overruns. A negative number means a past task cost more than the credits available in your daily, monthly, and promo buckets, so the difference was taken from your purchased balance and pushed it below zero. You will not be able to run new tasks until your balance returns to zero or positive, which happens when you upgrade to a paid plan, buy a top-up, or a promo period covers your usage. If you think your balance is wrong, contact support.
Promo credits live in a separate bucket from your purchased balance. They are spent first (before your free daily, monthly, or purchased credits) and they expire when the promo ends. Any unused promo credits at the end of the promo period are forfeited.
No. Your monthly plan allowance resets at the start of each billing cycle, so unused credits from the previous month are lost. If you regularly have a lot of credits left over, consider downgrading to a smaller plan and topping up purchased credits as needed.