API Access and Billing¶

Several Suppli features use AI — Suppli Ads, Suppli DM, Suppli Mail, Suppli Leads, Workflows AI steps and the assistant. They all run on your Suppli API credit first; a key of your own takes over only once that credit is gone.

Suppli API credit (the default)¶

Your $20/month subscription includes $5.00 of AI credit, $4.70 of it usable after the 6% Suppli margin. Suppli draws from that balance on your behalf across every AI provider it uses, so you never open an account with any of them.

The monthly credit resets at the start of each billing cycle and does not roll over — anything unused is discarded rather than added to the next month. Supplier API fetches on Pro are paid from this credit at measured server cost plus 6%; only they can take your balance below $0, down to −$1.00, and that comes off next month's credit. You can see the balance, what each feature has used, and how much of the month's credit is left on the API Keys & Suppli API Credit page.

Running out¶

If a month's usage goes past the included credit, you have two options:

• Top-up credit — buy more from the same settings page. Top-up credit is a separate pool that never expires, and it is used once the monthly allowance is gone.
• Your own keys — connect your own provider keys. Once your Suppli credit is gone, a feature with your key keeps working on it, and you pay your provider directly with no markup from Suppli. Keys never replace credit while credit remains.

$5.00 loaded = $4.70 of usable credit. The 6% covers infrastructure, payment processing and maintaining the pool.

Spending cap¶

You can set an optional monthly spending cap on the same settings page. Once the cap is reached, Suppli stops drawing credit for the rest of that month, so a runaway job can't quietly spend a balance.

Which one gets used¶

For each AI call, Suppli checks in this order:

1. Suppli API credit — monthly allowance first, then top-up credit. While any credit remains, every call runs on it.
2. Your own key — once credit is exhausted, the feature switches to your key for that provider, if you've connected one.
3. Blocked — no credit and no key of your own: the feature tells you so, naming which of the two to fix, instead of failing silently.

The free plan has an included allowance per feature and no own-key path; upgrading is what unlocks credit and keys.

The assistant's chats¶

The Suppli assistant counts chats, not tokens, for its included allowance: 5 chats a month on the free plan and 15 a month on Pro, on Suppli's own key, at no charge (a chat is one message you send; a blocked message never uses one). Over that, on Pro, each message follows the same order as every AI feature: Suppli credit first, charged the real token cost at the serving model's price and listed in your credit history as "assistant"; then your own key for the provider the assistant runs on (OpenAI today, so an OpenAI key; an Anthropic key alone does not count); otherwise the assistant says so and makes no call. The line under the chat input tells you where you stand ("3 of 15 included chats left this month", "Chats run on your Suppli credit now"). Included chats reset on the 1st of each month.