Come contiamo i token

Come vengono conteggiati e fatturati i token di input e output, come funziona lo sconto sui prompt in cache e come stimare il costo di una richiesta.

I token sono l'unità con cui Claude (e ogni altro LLM) misura il lavoro. Circa 4 caratteri di testo inglese, e più o meno ciò che paghi.

Tutti i modelli, le funzionalità e i prezzi Indice della documentazione per agenti AI: https://oneprovider.dev/docs/llms.txt

Regola pratica

1 token ≈ 4 caratteri inglesi ≈ 0,75 parole.
Una pagina di prosa (~500 parole) è circa 670 token.
Il codice sorgente, le scritture non latine e le emoji si tokenizzano in modo più denso: aspettati da 1,2 a 2 volte la tariffa dell'inglese.
Una finestra di contesto da 200k token equivale a circa 150k parole inglesi, cioè intorno a 300 pagine.

Quattro tipi di token nel tuo conto

Dati di riferimento

Tipo	Cos'è	Come viene addebitato
Input	Ogni token che il modello legge: prompt di sistema, turni precedenti, messaggio corrente dell'utente, schema degli strumenti, immagini.	Tariffa di input piena.
Output	Ogni token che il modello scrive: testo della risposta, chiamate a strumenti, ragionamento (se attivato).	Tariffa di output piena (di solito 5 volte l'input).
Cache read	Token di input letti dalla cache creata a un punto di cache di una richiesta precedente.	10% della tariffa di input per la maggior parte dei modelli; le tariffe esatte per modello sono nella tabella dei modelli .
Cache write	La prima richiesta a un punto di cache: crea la cache per le letture successive.	125% della tariffa di input per la maggior parte dei modelli; le tariffe esatte per modello sono nella tabella dei modelli .

Ogni risposta riporta questi conteggi nel campo usage: vedi Consumo e fatturazione .

Stimare prima di inviare

Gli SDK Anthropic offrono un helper per contare i token che puoi eseguire in locale:

python

from anthropic import Anthropic
client = Anthropic(base_url="https://api.oneprovider.dev")
count = client.messages.count_tokens(
model="claude-sonnet-5-5",
messages=[{"role": "user", "content": "Your long prompt here"}],
)
print(count.input_tokens)

Il conteggio è un limite inferiore: non include l'output che il modello sta per scrivere. Per il budget, aggiungi un tetto max_tokens e considera il caso peggiore.

Come stimare il risparmio con la cache

Non esiste un moltiplicatore universale per tutti i modelli. Per l'attuale modello bilanciato claude-sonnet-5-5 o per qualsiasi altro modello, usa i suoi valori separati di Lettura cache e Scrittura cache dalla tabella delle tariffe generata. Confrontali con la tariffa di input del modello scelto e con il numero previsto di letture ripetute.

Una richiesta, con il suo prezzo In cima a /pricing viene calcolata una richiesta di esempio riga per riga: input, lettura cache e output alla tariffa di ciascun modello, con gli stessi numeri della tabella Tariffe .

Risposte rapide

Quale base URL devo usare?

Claude Code e gli SDK Anthropic usano https://api.oneprovider.dev. Gli SDK OpenAI e i client compatibili con OpenAI usano https://api.oneprovider.dev/v1. Con una sola chiave funzionano entrambi; l'elenco dei modelli è nella pagina dei modelli , le tariffe nella pagina dei prezzi .

Come mi autentico?

Invia la chiave sk-… così com'è in x-api-key oppure in Authorization: Bearer: uno dei due, mai entrambi. Tieni la chiave in una variabile d'ambiente, non in un file che finisce nel commit. Altro sull'autenticazione .

Dove ottengo una chiave?

Apri la tua area personale nel bot Telegram @oneprovider_robot oppure su app.oneprovider.dev, ricarica il saldo e premi «Emetti una chiave». Ogni chiave può avere un proprio limite di spesa. Area personale e chiavi API .

Cosa significano 401, 404 e 429?

401: la chiave manca, è scritta male o è inviata nell'header sbagliato; incolla la chiave intera, senza virgolette né spazi. 404: di solito la base URL è sbagliata, per esempio manca /v1 o è doppio. 429 con “Insufficient balance”: il saldo dell'area personale o il limite di spesa della chiave è esaurito, quindi ricarica invece di riprovare; qualsiasi altro 429 è un limite di frequenza, quindi attendi il tempo indicato in Retry-After. Dettagli: codici di errore e risoluzione dei problemi .

Perché gli stream si interrompono o si resettano?

VPN e proxy VLESS spesso mettono in buffer gli SSE o rompono la negoziazione HTTP/2. OneProvider non ha restrizioni regionali e non mette in buffer gli stream: disattiva il proxy e riprova.

Dove chiedo se non basta?

Scrivi a @Oneproviderhelpbot su Telegram oppure apri «Assistenza» nell'area personale sul sito, indicando il codice di stato HTTP e il testo esatto dell'errore. Come funziona l'assistenza .

Ultimo aggiornamento: 2026-11-08 Hai trovato un errore? @Oneproviderhelpbot