Skip to content
KugelAudioDocs

Credits, top-ups and invoices

How KugelAudio credits work: the free starting credit, adding credits, automatic recharge, the monthly spend cap, invoices and VAT, and what to do when a payment fails or your credits run out.

On this page

KugelAudio bills usage from a prepaid credit balance per organization. Rates per model are on the pricing page; this page explains how the balance behaves.

Your starting credit

Every new account gets a one-time free credit, no card needed. The amount and how far it goes are in the Quick Start.

Add credits

Open the billing page of the dashboard and add credits. A top-up is between €10 and €20,000. Credits are added to the balance as soon as the payment goes through, and every top-up produces an invoice.

If you pay as a business and enter a VAT ID at checkout, the purchase is invoiced as a business purchase.

Automatic recharge

Instead of topping up by hand you can turn on automatic recharge in billing. You set the balance at which it triggers and the amount to add, and an optional monthly limit on what it may charge. It charges your saved payment method.

Monthly spend cap

Billing also has a monthly spend cap. When the month's cap is reached, requests are refused with the same 402 INSUFFICIENT_CREDITS as an empty balance, even if credits are left. The dashboard banner says which it is: "This month's spend cap is reached." Raise the cap, or wait for the next month. Adding credits does not help in this case.

Invoices and receipts

Each top-up creates an invoice with a download link (PDF) and a hosted invoice page. You find them under recent invoices on the billing page. Payment confirmations and invoices are also sent by email; you choose which emails you get under Account settings → Email notifications ("Billing and invoices").

When requests are refused with 402

402 INSUFFICIENT_CREDITS (close code 4003 on a WebSocket) means one of two things: the credit balance is used up, or the monthly spend cap is reached. The dashboard banner tells which ("Your credit balance is used up" or "This month's spend cap is reached"). For an empty balance, add credits; for the cap, raise it. Requests work again right after. Organization owners and admins get one email when the credits run out.

When a payment fails

What you seeWhat it meansWhat to do
A banner "Your last payment failed"The last charge was declined or needs your confirmation.Choose Update payment and pay again, or use another method.
A banner "Auto recharge is paused" and an emailYour saved payment method was declined, so automatic recharge stopped charging it.Choose Update card in billing. A new default method gets a fresh attempt.
The bank asks for confirmation (3-D Secure)The payment is waiting for you.Complete the confirmation, on the hosted invoice page if billing links one.

A payment that is finished on the hosted invoice page credits your balance the same way a direct payment does. If a payment went through at your bank but the balance has not changed, write to hello@kugelaudio.com with the invoice number.

Adding a payment method and one top-up of at least €10 also raises your rate limits.

Get help

Status page · hello@kugelaudio.com