Documentazione
Fatturazione
Pagamento a consumo da un wallet prepagato. Il costo di ogni chiamata è calcolato al microcentesimo e registrato in un registro immodificabile. Nessun abbonamento o impegno; il saldo non scade mai.
Ricarica tramite Stripe → il saldo viene accreditato nel wallet → il costo di ogni chiamata API viene detratto in tempo reale. Quando il saldo raggiunge zero, le chiamate restituiscono 402 insufficient_quota finché non effettui un'altra ricarica.
Il modello di tariffazione
Per ogni chiamata, Kunavo calcola il costo a carico dell'utente come il maggiore tra due valori:
- Costo di catalogo: il prezzo mostrato nella scheda del modello (per 1M token, per immagine, per secondo di video e così via) moltiplicato per le unità di utilizzo effettive.
- Costo a monte: quanto il provider a monte ha addebitato a Kunavo per la chiamata specifica, espresso in crediti, dove 1 credito = $0.005.
- Fattore di ricarico — in genere
1.5(ricarico del 50% sul costo del fornitore a monte). Per alcuni modelli di fornitori cinesi, per i quali il prezzo all'ingrosso a monte è più vicino alla tariffa ufficiale del fornitore, il fattore viene ridotto a1.2per mantenerci al di sotto della tariffa ufficiale.
La funzione max() garantisce che: (a) non paghi mai meno del prezzo di catalogo pubblicizzato e (b) non perdiamo mai denaro su una chiamata il cui costo a monte aumenti inaspettatamente.
Unità di fatturazione per modalità
| Modalità | Unità | Granularità |
|---|---|---|
| Chat | per 1M token di input + per 1M token di output | Esatto al token; i token di ragionamento vengono fatturati alla tariffa di output. |
| Immagine (t2i / modifica) | per immagine | Per immagine generata; le generazioni parziali non vengono addebitate. |
| Video | per video | Prezzo fisso per clip, determinato dalla fascia di risoluzione. |
I prompt lunghi vengono fatturati alla fascia di contesto lungo del fornitore. Con GPT-5.5, GPT-5.6 Sol e Terra e GPT-6 Astra, un prompt che supera 272K token di input comporta la fatturazione dell'intera richiesta a 2× la tariffa di input, comprese le letture e le scritture della cache, e a 1.5× la tariffa di output: la fascia pubblicata da OpenAI. Claude non applica alcun sovrapprezzo per il contesto lungo: il suo contesto da 1M viene fatturato alla tariffa standard.
Token memorizzati nella cache
I modelli di chat memorizzano nella cache i prefissi stabili dei prompt. Le letture della cache sono fatturate a una tariffa molto inferiore a quella normale di input: 0.10× sia su Claude sia su OpenAI, e 0.025× on Claude Fable 5.1, 0.05× on Claude Opus 5.5. Le scritture della cache sono fatturate a 1.25× la tariffa di input su tutti i modelli Claude, incluse le scritture con TTL di 1 ora (al di sotto del moltiplicatore 2× di Anthropic), e su GPT-5.6 Sol, Terra e Luna e GPT-6 Astra; su tutti gli altri modelli sono fatturate alla normale tariffa di input. Ogni classe applica lo sconto specifico del modello, quindi i prezzi della cache hanno lo stesso sconto rispetto al listino del fornitore dei prezzi di input e output. La soglia minima max() indicata sopra viene calcolata tenendo conto della cache, così lo sconto si applica anche a te e non viene annullato dal prezzo di catalogo.
Consulta la guida alla memorizzazione nella cache dei prompt per la tabella completa dei prezzi, le istruzioni per abilitare cache_control e informazioni su come il routing per affinità di Kunavo mantiene calda la cache.
Precisione
Tutti gli importi in Kunavo sono memorizzati in micro_cents:
1 USD = 100,000,000 micro_cents1 cent = 1,000,000 micro_cents- Addebito minimo contabilizzabile:
0.0001 cent($0.000001). Le normali chiamate di chat spesso vengono fatturate al minimo.
La dashboard arrotonda gli importi in USD a 6 decimali per i valori piccoli e a 2 decimali quando superano un centesimo. La contabilità interna è esatta.
Ricarica
Ricarica il tuo portafoglio su /app/billing tramite Stripe Checkout: carte (Visa, Mastercard, Amex, JCB, UnionPay) ovunque Stripe sia disponibile, e Apple Pay, Google Pay e Link ovunque tranne che in India. I metodi soggetti al Paese vengono mostrati per il mercato dell'acquirente: negli Stati Uniti Cash App Pay, Klarna, Afterpay, addebito bancario ACH (con accredito in 3–5 giorni lavorativi) e criptovalute (stablecoin), oltre ad Affirm per ricariche da $100 in su e Zip per ricariche da $100 a $1,500; Alipay e WeChat Pay nella Cina continentale; KakaoPay, Naver Pay, PAYCO, Samsung Pay e carte nazionali coreane in Corea del Sud; UPI in India; Pix in Brasile; iDEAL nei Paesi Bassi, Bancontact in Belgio, EPS in Austria, MB WAY in Portogallo e Satispay in Italia; BLIK in Polonia; Bacs Direct Debit nel Regno Unito; e Pay by Bank per gli acquirenti nel Regno Unito, in Irlanda e in Finlandia.
Prezzi per fasce
| Ricarica | Cosa ottieni | Bonus |
|---|---|---|
| $10 | $10.00 | — |
| $100 | $110.00 | +$10 (10%) |
| $1,000 | $1,200.00 | +$200 (20%) |
| $5,000 | $6,250.00 | +$1,250 (25%) |
/app/keys per fissare un tetto massimo a un singolo carico di lavoro: se una chiamata comportasse il superamento della cifra impostata per la spesa di quella chiave nel mese di calendario, verrebbe rifiutata con un 402 insufficient_quota e non verrebbe addebitato nulla. Le altre chiavi continuano a funzionare. Nella stessa schermata puoi impostare una lista di IP consentiti per ogni chiave: le chiamate provenienti da qualsiasi altro indirizzo ricevono un 403.Ricarica automatica
Facoltativa. Salva una carta una sola volta in /app/billing e imposta tre valori: il saldo al di sotto del quale effettuare una ricarica, l'importo da aggiungere ogni volta e un limite mensile. Da quel momento il wallet si ricarica automaticamente: entro pochi secondi da una contabilizzazione che porta il saldo sotto la soglia e, se nel frattempo una richiesta viene rifiutata per saldo insufficiente, prima che venga inviata la risposta. In questo modo un agente non supervisionato non si ferma per un 402.
| Impostazione | Intervallo | Note |
|---|---|---|
| Soglia di attivazione | $5 – $1,000 | Impostala al di sopra dell'importo della tua richiesta singola più elevata. |
| Importo per ricarica | Da $10 a $1.000, in dollari interi | $100 e $1.000 ricevono lo stesso bonus di una ricarica manuale; gli altri importi non ricevono alcun bonus. |
| Limite mensile | importo – $20,000 | Tiene conto dell'importo addebitato ogni mese di calendario, esclusi i bonus. |
KUNAVO* AUTOTOPUP.Mentre una ricarica è in corso, una richiesta rifiutata riceve un 402 con Retry-After: 3; ogni altro rifiuto indica cosa fare. Puoi disattivare la funzione o modificare i valori in qualsiasi momento dalla stessa pagina.
Tempistiche dei webhook
Dopo aver completato Stripe Checkout, il saldo viene aggiornato tramite webhook. In genere il webhook viene attivato entro 5–10 secondi dalla conferma del pagamento. Con i pagamenti tramite carta è quasi immediato; un metodo che conferma solo in modo asincrono può impiegare giorni per il regolamento. Questi ordini risultano come processing finché i fondi non arrivano; a quel punto il webhook di regolamento accredita il wallet. Non devi pagare di nuovo e nulla scade nel frattempo. Un ordine mai completato risulta pending e il nostro processo di pulizia lo riclassifica come expired dopo 24 ore: è solo un'etichetta e non annulla nulla.
Il registro dei crediti
Ogni variazione del saldo viene registrata in un registro append-only:
| Tipo | Direzione | Quando |
|---|---|---|
| topup | accredito (+) | Pagamento Stripe confermato. |
| consume | addebito (−) | Chiamata API fatturata al completamento. |
| refund | accredito (+) | Rimborso Stripe o accredito manuale dell'amministratore. |
| manual_ | accredito (+/−) | Correzione operatore (ad es. rimborso per un incidente). |
Ogni riga riporta balance_after_micro_cents, che fornisce un'istantanea per evento. Consulta la cronologia completa su /app/billing.
Registri di utilizzo
Ogni chiamata API genera una riga in usage_logs:
- Modello, stato (successo / errore), codice di stato HTTP
- Token di input / output, token memorizzati nella cache e scritti nella cache, numero di immagini, secondi, caratteri
upstream_cost_micro_cents— quanto Kunavo ha pagato al fornitore upstreamcost_micro_cents— quanto hai pagato (dopo il ricarico)- Latenza, IP della richiesta, user agent, prefisso della chiave API
Consultabili in /app/usage con filtri e pagine di dettaglio per ogni chiamata.
Chiamate non riuscite: hanno un costo?
No. Kunavo addebita un costo solo quando status = success. Se il fornitore upstream restituisce un errore 4xx / 5xx o la nostra attività va in timeout, la chiamata viene registrata, ma il costo è $0. Sosteniamo noi il costo upstream invece di addebitarlo a te.
Rimborsi
I rimborsi vengono valutati caso per caso tramite support@kunavo.com. Ecco alcuni casi comuni in cui rimborsiamo:
- Un'interruzione del servizio lato Kunavo che ti ha fatto perdere credito.
- Errori di prezzo che hanno comportato un addebito superiore ai prezzi mostrati nel catalogo.
- Ricarica accidentale duplicata tramite Stripe.
Per impostazione predefinita, i rimborsi vengono accreditati sul tuo portafoglio; su richiesta sono disponibili anche rimborsi sul conto bancario tramite Stripe.