Token IA (opzionale)

Grant mensili, pack one-time e consumo sugli endpoint /ai.

Come funzionano i token

Fonte	Comportamento
Grant mensile del piano	Incluso per piano (vedi Piani). Reset a ogni ciclo dopo `invoice.paid` Stripe. Use it or lose it — non si accumulano.
Token pack (one-time)	Acquisti aggiuntivi. Non scadono e si sommano al saldo mensile.
Consumo	Ogni chiamata IA addebita `AiTokenLedger` in base all'uso del modello.

Token pack

Pack	Token	Prezzo
Starter	10,000	€5
Growth	50,000	€20
Scale	200,000	€70

L'acquisto passa da Stripe Checkout (stessa infrastruttura dell'upgrade piano). Il payload esatto può variare per deploy — usa la sezione Billing della dashboard quando disponibile.

Endpoint che consumano token

POST /ai/generate
POST /ai/improve
Authorization: Bearer <jwt o api key>
X-Tenant-Id: clxxxxxxxx

Se il saldo del tenant è insufficiente, l'API restituisce errore prima di eseguire il modello. Monitora l'uso insieme alla quota email in GET /billing/subscription e widget dashboard.

Mensile vs pack

Inizio ciclo      →  invoice.paid  →  grant plan.tokensIncludedMonth
Uso editor IA     →  debit ledger
Acquisto pack     →  credit ledger (persistente)