Come possiamo aiutarti?
Cerca risposte, guide di configurazione e documentazione — oppure scrivici.
Usa le frecce su e giù per scorrere i risultati e Invio per aprirne uno.
Stato del servizio Verifica dello stato dei modelli… Modelli e stato
Per iniziare
Dalla registrazione alla prima richiesta.
Come ottengo una chiave API?
Registrati — i nuovi account ricevono 1.3M+ token gratuiti. La tua chiave API appare nella dashboard non appena il tuo account ha un saldo. Copiala subito: viene mostrata una sola volta.
Quale URL di base devo usare?
Gli SDK e gli strumenti compatibili con OpenAI usano https://api.cheaptokens.dev/v1. I client compatibili con Anthropic, incluso Claude Code, usano l'indirizzo radice https://api.cheaptokens.dev e aggiungono il percorso da soli. Se il tuo client aggiunge /v1 autonomamente, dagli comunque l'indirizzo radice.
Come faccio la mia prima richiesta?
Inserisci la tua chiave nella variabile d'ambiente CHEAPTOKENS_API_KEY ed esegui la richiesta qui sotto. La guida rapida genera lo stesso snippet per Python, Node e l'SDK Anthropic, con il modello che preferisci.
curl https://api.cheaptokens.dev/v1/chat/completions \
-H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "zai-org/GLM-5.3-Flash",
"messages": [{"role": "user", "content": "Hello"}]
}' Come collego Cursor, Cline, Claude Code o un altro strumento?
Funziona qualsiasi strumento compatibile con l'API OpenAI o Anthropic: imposta l'URL di base, incolla la tua chiave e aggiungi l'ID del modello. Ogni guida mostra dove si trovano queste impostazioni nello strumento.
Quale modello dovrei scegliere?
Tutti i modelli funzionano con la stessa chiave e lo stesso indirizzo — per cambiare, modifica l'ID del modello. Ogni scheda nella pagina dei modelli indica la finestra di contesto, l'output massimo e il prezzo.
- GLM-5.3-Flash Per codice complesso e ragionamento
- DeepSeek-V4-Flash Per attività quotidiane a basso costo
- MiniMax-M2.7 Per agenti e automazione dei workflow
Hai ancora una domanda? Chiedici
Connetti uno strumento
Scegli il tuo strumento o SDK per vedere solo le impostazioni necessarie. La chiave negli esempi è un segnaposto — incolla la tua chiave nello strumento.
Cursor Compatibile con OpenAI
Cursor — in Cursor Settings → Models, incolla la tua chiave in OpenAI API Key, attiva Override OpenAI Base URL e aggiungi l'ID del modello come modello personalizzato. Secondo la documentazione di Cursor, le chiavi proprie funzionano solo con i modelli di chat; il completamento Tab continua a utilizzare i modelli di Cursor.
- URL di base
-
https://api.cheaptokens.dev/v1 - Chiave API
-
YOUR_CHEAPTOKENS_KEYInviata comeAuthorization: Bearer <key>. - ID modello
-
zai-org/GLM-5.3-Flash
Usa l'indirizzo con /v1: l'SDK o lo strumento aggiunge /chat/completions da solo.
# Cursor Settings → Models → API Keys
OpenAI API Key: YOUR_CHEAPTOKENS_KEY
Override OpenAI Base URL: https://api.cheaptokens.dev/v1
# Models list → add this ID as a custom model:
Model: zai-org/GLM-5.3-Flash Cline Compatibile con OpenAI
Cline — scegli un provider compatibile con OpenAI, imposta l'URL di base e la chiave.
- URL di base
-
https://api.cheaptokens.dev/v1 - Chiave API
-
YOUR_CHEAPTOKENS_KEYInviata comeAuthorization: Bearer <key>. - ID modello
-
zai-org/GLM-5.3-Flash
Usa l'indirizzo con /v1: l'SDK o lo strumento aggiunge /chat/completions da solo.
# Cline → Settings → API Provider: OpenAI Compatible
Base URL: https://api.cheaptokens.dev/v1
API Key: YOUR_CHEAPTOKENS_KEY
Model ID: zai-org/GLM-5.3-Flash Dove trovare queste impostazioni
Claude Code Compatibile con Anthropic
Claude Code — esporta le variabili seguenti (l'indirizzo non ha /v1) ed esegui claude.
- URL di base
-
https://api.cheaptokens.dev - Chiave API
-
YOUR_CHEAPTOKENS_KEYInviata comex-api-key: <key>; funziona ancheAuthorization: Bearer <key>. - ID modello
-
zai-org/GLM-5.3-Flash
Usa l'indirizzo radice senza /v1: il client aggiunge /v1/messages da solo.
# Claude Code → cheaptokens (Anthropic-compatible)
export ANTHROPIC_BASE_URL="https://api.cheaptokens.dev"
export ANTHROPIC_API_KEY="YOUR_CHEAPTOKENS_KEY"
export ANTHROPIC_MODEL="zai-org/GLM-5.3-Flash"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="zai-org/GLM-5.3-Flash" OpenClaw Compatibile con OpenAI o Anthropic
OpenClaw — aggiungi la voce del provider qui sotto a ~/.openclaw/openclaw.json. Su un'installazione pulita, openclaw onboard con l'opzione Custom provider scrive la stessa voce.
- URL di base · Compatibile con OpenAI
-
https://api.cheaptokens.dev/v1 - URL di base · Compatibile con Anthropic
-
https://api.cheaptokens.dev - Chiave API
-
YOUR_CHEAPTOKENS_KEYInviata comeAuthorization: Bearer <key>.Inviata comex-api-key: <key>; funziona ancheAuthorization: Bearer <key>. - ID modello
-
zai-org/GLM-5.3-Flash
Per le richieste in stile OpenAI usa l'indirizzo con /v1; per quelle in stile Anthropic — l'indirizzo radice.
// ~/.openclaw/openclaw.json — add cheaptokens as a provider
{
models: {
providers: {
cheaptokens: {
baseUrl: "https://api.cheaptokens.dev/v1",
apiKey: "YOUR_CHEAPTOKENS_KEY",
api: "openai-completions",
models: [{ id: "zai-org/GLM-5.3-Flash", name: "GLM-5.3-Flash" }],
},
},
},
agents: {
defaults: { model: { primary: "cheaptokens/zai-org/GLM-5.3-Flash" } },
},
}
// Anthropic-style requests instead? In the provider entry use:
// api: "anthropic-messages", baseUrl: "https://api.cheaptokens.dev" Aider Compatibile con OpenAI
Aider — passa --openai-api-base e --openai-api-key (o variabili d'ambiente).
- URL di base
-
https://api.cheaptokens.dev/v1 - Chiave API
-
YOUR_CHEAPTOKENS_KEYInviata comeAuthorization: Bearer <key>. - ID modello
-
zai-org/GLM-5.3-Flash
Usa l'indirizzo con /v1: l'SDK o lo strumento aggiunge /chat/completions da solo.
export OPENAI_API_BASE="https://api.cheaptokens.dev/v1"
export OPENAI_API_KEY="YOUR_CHEAPTOKENS_KEY"
aider --model openai/zai-org/GLM-5.3-Flash Kilo Code Compatibile con OpenAI
Kilo Code — scegli il provider compatibile con OpenAI, imposta l'URL di base, la chiave e l'ID del modello.
- URL di base
-
https://api.cheaptokens.dev/v1 - Chiave API
-
YOUR_CHEAPTOKENS_KEYInviata comeAuthorization: Bearer <key>. - ID modello
-
zai-org/GLM-5.3-Flash
Usa l'indirizzo con /v1: l'SDK o lo strumento aggiunge /chat/completions da solo.
# Kilo Code → Settings → API Provider: OpenAI Compatible
Base URL: https://api.cheaptokens.dev/v1
API Key: YOUR_CHEAPTOKENS_KEY
Model ID: zai-org/GLM-5.3-Flash Python · OpenAI Compatibile con OpenAI
- URL di base
-
https://api.cheaptokens.dev/v1 - Chiave API
-
YOUR_CHEAPTOKENS_KEYInviata comeAuthorization: Bearer <key>. - ID modello
-
zai-org/GLM-5.3-Flash
Usa l'indirizzo con /v1: l'SDK o lo strumento aggiunge /chat/completions da solo.
from openai import OpenAI
client = OpenAI(
base_url="https://api.cheaptokens.dev/v1",
api_key="YOUR_CHEAPTOKENS_KEY",
)
resp = client.chat.completions.create(
model="zai-org/GLM-5.3-Flash",
messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content) Node · OpenAI Compatibile con OpenAI
- URL di base
-
https://api.cheaptokens.dev/v1 - Chiave API
-
YOUR_CHEAPTOKENS_KEYInviata comeAuthorization: Bearer <key>. - ID modello
-
zai-org/GLM-5.3-Flash
Usa l'indirizzo con /v1: l'SDK o lo strumento aggiunge /chat/completions da solo.
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.cheaptokens.dev/v1",
apiKey: process.env.CHEAPTOKENS_API_KEY,
});
const resp = await client.chat.completions.create({
model: "zai-org/GLM-5.3-Flash",
messages: [{ role: "user", content: "Hello" }],
});
console.log(resp.choices[0].message.content); Python · Anthropic Compatibile con Anthropic
- URL di base
-
https://api.cheaptokens.dev - Chiave API
-
YOUR_CHEAPTOKENS_KEYInviata comex-api-key: <key>; funziona ancheAuthorization: Bearer <key>. - ID modello
-
zai-org/GLM-5.3-Flash
Usa l'indirizzo radice senza /v1: il client aggiunge /v1/messages da solo.
from anthropic import Anthropic
client = Anthropic(
base_url="https://api.cheaptokens.dev",
api_key="YOUR_CHEAPTOKENS_KEY",
)
msg = client.messages.create(
model="zai-org/GLM-5.3-Flash",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello"}],
)
print(msg.content[0].text) curl Compatibile con OpenAI
- URL di base
-
https://api.cheaptokens.dev/v1 - Chiave API
-
YOUR_CHEAPTOKENS_KEYInviata comeAuthorization: Bearer <key>. - ID modello
-
zai-org/GLM-5.3-Flash
Usa l'indirizzo con /v1: l'SDK o lo strumento aggiunge /chat/completions da solo.
curl https://api.cheaptokens.dev/v1/chat/completions \
-H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "zai-org/GLM-5.3-Flash",
"messages": [{"role": "user", "content": "Hello"}]
}' Riferimento rapido: indirizzi, header della chiave, ID dei modelli, limite
- URL di base compatibile con OpenAI
https://api.cheaptokens.dev/v1- URL di base compatibile con Anthropic
https://api.cheaptokens.dev- Header della chiave API
Authorization: Bearer <key>Client Anthropic: x-api-key- ID dei modelli
zai-org/GLM-5.3-Flashdeepseek-ai/DeepSeek-V4-Flash-0731MiniMaxAI/MiniMax-M2.7
- Limite di richieste
- 120 richieste al minuto per chiave
Saldo e pagamenti
Pagamento a consumo da un unico saldo in USD.
Come funziona il pagamento?
Non c'è alcun abbonamento. Ricarichi un saldo in USD e ogni richiesta viene addebitata alla tariffa fissa del modello per milione di token di input e output. Un unico saldo copre tutti i modelli.
Come faccio a ricaricare?
Nella dashboard, premi Ricarica e scegli l'importo in USD. Paga con criptovaluta (senza KYC) o con carta tramite un partner — i fondi vengono accreditati automaticamente sul tuo saldo.
Il mio pagamento è ancora in elaborazione
Una ricarica in criptovaluta viene accreditata automaticamente quando la rete conferma la transazione — quanto tempo richieda dipende dalla moneta. Se paghi con carta tramite un partner, il saldo viene ricaricato 5–30 minuti dopo il pagamento.
- Controlla
- Lo stato nella pagina di pagamento: l'importo completo è pagato, nella moneta e nella rete mostrate dalla pagina.
- Correggi
- Attendi — non c'è nulla da reinviare. Puoi chiudere la pagina di pagamento: la ricarica viene accreditata anche senza.
- Verifica che funzioni
- Il saldo nella dashboard aumenta della ricarica; dopo la tua prima ricarica compare lì anche la chiave API.
- Ancora non funziona? Inviaci
- Se la pagina di pagamento mostra il pagamento come completato ma il saldo non è cambiato entro 30 minuti — vedi la risposta successiva.
Ho pagato, ma il mio saldo non è cambiato
I pagamenti vengono abbinati automaticamente al tuo account. Se la notifica di un pagamento in criptovaluta è andata persa, un controllo periodico recupera il pagamento entro pochi minuti.
- Controlla
- La pagina di pagamento o il tuo wallet: il pagamento è completato. Una fattura in criptovaluta deve ricevere l'importo completo — un pagamento arrivato in difetto viene verificato manualmente. Se paghi con carta tramite un partner, il partner deve inviare USDT sulla rete TRC20 (Tron) al tuo indirizzo di destinazione: altre monete e reti non vengono accreditate.
- Correggi
- Concedi 30 minuti dopo il completamento del pagamento. Se il saldo non è ancora cambiato, scrivici — non pagare di nuovo.
- Verifica che funzioni
- La dashboard mostra la ricarica nel tuo saldo.
- Ancora non funziona? Inviaci
- Il metodo di pagamento, l'importo, quando hai pagato e l'ID del pagamento o l'hash della transazione dalla pagina di pagamento o dal tuo wallet.
La ricarica non è riuscita a causa di un errore
Il più delle volte l'importo è inferiore al minimo — $5 con criptovaluta, $10 con carta tramite un partner — oppure il servizio di pagamento non ha risposto per un momento.
- Controlla
- L'importo e il testo esatto dell'errore nella finestra di ricarica.
- Correggi
- Ricarica la dashboard e riprova tra qualche minuto. Se il pagamento con carta tramite un partner non va a buon fine, la finestra di ricarica offre un secondo partner.
- Verifica che funzioni
- La pagina di pagamento si apre con il tuo importo; dopo il pagamento il saldo aumenta.
- Ancora non funziona? Inviaci
- Il metodo di pagamento, l'importo, l'orario e il testo esatto dell'errore — uno screenshot aiuta.
Il mio saldo scade?
No. Il saldo non utilizzato non scade, quindi puoi ricaricare una volta e spenderlo con i tuoi tempi.
Cosa succede quando il saldo si esaurisce?
Le richieste restituiscono 402 e la tua chiave viene sospesa. Ricarica e la stessa chiave funziona di nuovo — non ne serve una nuova.
Dove posso vedere le mie spese?
Nella dashboard: il tuo saldo, quanto hai speso e l'utilizzo per modello e per giorno.
Perché i prezzi sono più bassi?
Eseguiamo modelli open-weight su infrastrutture efficienti in termini di costi e pubblichiamo tariffe fisse in USD per milione di token di input e output per ogni modello — senza abbonamenti o piani.
Hai ancora una domanda? Chiedici
API ed errori
Cosa significa un codice di stato e come risolverlo.
401 Chiave API non valida
L'API non riconosce la chiave: è digitata male, appartiene a un altro servizio o è stata sostituita — dopo Ruota la vecchia chiave smette di funzionare.
- Controlla
- La chiave nel tuo strumento è quella attuale, senza spazi, virgolette o interruzioni di riga, e l'header è esattamente
Authorization: Bearer <key>(client Anthropic:x-api-key). - Correggi
- Incolla di nuovo la chiave attuale. L'hai persa? Premi Ruota nella dashboard e aggiorna la chiave ovunque la usi.
- Verifica che funzioni
- Invia una richiesta breve: una risposta invece di 401 significa che la chiave funziona.
- Ancora non funziona? Inviaci
- L'ora della richiesta, lo strumento o SDK e il testo dell'errore — mai la chiave stessa.
402 Richiesta rifiutata: saldo assente o chiave assente
La richiesta è stata rifiutata prima di raggiungere il modello, per uno di due motivi. Il testo dell'errore li distingue: Total limit exceeded — il saldo è esaurito o troppo basso per questa richiesta; no active billing account — la richiesta non contiene alcuna chiave API.
- Controlla
- Il tuo saldo nella dashboard e che la richiesta invii la chiave come
Authorization: Bearer <key>— “Bearer” con la B maiuscola e uno spazio prima della chiave — oppure comex-api-key. Unbearerminuscolo o una chiave senza “Bearer” valgono come nessuna chiave. - Correggi
- Saldo esaurito: premi Ricarica nella dashboard — la stessa chiave funziona di nuovo una volta accreditata la ricarica. Nessuna chiave: aggiungila al tuo strumento o alla variabile d'ambiente, poi riavvia lo strumento o il terminale.
- Verifica che funzioni
- Nella dashboard la chiave mostra Attiva e una richiesta breve restituisce una risposta.
- Ancora non funziona? Inviaci
- Se il saldo è positivo e la chiave viene inviata ma il 402 persiste: l'ora della richiesta, il modello e il testo completo dell'errore.
429 Troppe richieste
Le richieste arrivano più velocemente di quanto consentito. Il limite è 120 richieste al minuto per chiave API, conteggiate in finestre di un minuto. Un 429 può anche indicare che il servizio o un modello è temporaneamente occupato.
- Controlla
- Il testo dell'errore:
Rate limit exceeded— la tua chiave ha raggiunto il limite al minuto;at capacity,waiting for an available upstream slotooverloaded— il servizio o il modello è occupato. - Correggi
- Attendi il numero di secondi indicato nell'header
Retry-Aftere ripeti — gli SDK ufficiali OpenAI e Anthropic ritentano un 429 da soli, due volte per impostazione predefinita. Per gli agenti, limita quante richieste vengono eseguite in parallelo; se un modello resta occupato, cambia il campomodel. - Verifica che funzioni
- Le richieste tornano a restituire risposte e, a un ritmo costante sotto il limite, i 429 cessano.
- Ancora non funziona? Inviaci
- Se il 429 arriva a una frequenza di richieste bassa: l'ora, il modello, quante richieste invii al minuto e il testo dell'errore.
404 · 400 Indirizzo errato o modello non trovato
Un 404 significa che l'indirizzo è errato. Un 400 con “not found” significa che l'API non conosce l'ID del modello.
- Controlla
- I client in stile OpenAI hanno bisogno dell'indirizzo con
/v1: assicurati che non manchi, né sia duplicato perché il client aggiunge/v1da solo. L'ID del modello deve essere completo, con il prefisso prima della barra, ad esempiozai-org/GLM-5.3-Flash. - Correggi
- Copia l'indirizzo e l'ID del modello dalle impostazioni per il tuo strumento in questa pagina, oppure prendi l'ID da
GET /v1/models. - Verifica che funzioni
- Una richiesta breve restituisce una risposta e
GET /v1/modelselenca lo stesso ID. - Ancora non funziona? Inviaci
- L'indirizzo completo che chiami, l'ID del modello e il testo dell'errore.
503 Modello temporaneamente non disponibile
Il modello non può accettare richieste in questo momento. Lo stato del servizio in cima a questa pagina e le schede dei modelli mostrano lo stesso stato.
- Controlla
- Lo stato del servizio qui sopra: questo modello è contrassegnato come temporaneamente non disponibile?
- Correggi
- Ripeti la richiesta tra un minuto, con pause crescenti — un 503 non ha l'header
Retry-After; gli SDK ufficiali la ritentano due volte da soli. Oppure cambia il campomodelcon un altro modello — la chiave e l'indirizzo restano gli stessi. - Verifica che funzioni
- Il modello risulta di nuovo disponibile e una richiesta breve restituisce una risposta.
- Ancora non funziona? Inviaci
- Se lo stato mostra il modello come disponibile ma il 503 continua: l'ora, il modello e il testo dell'errore.
length La risposta si interrompe a metà frase
La risposta ha raggiunto un limite di lunghezza: finish_reason è length. Senza max_tokens, una risposta non in streaming si ferma alla lunghezza predefinita del modello.
- Controlla
- Il campo
finish_reasone ilmax_tokensche invii — la documentazione elenca il valore predefinito e l'output massimo per ogni modello. - Correggi
- Imposta
max_tokensper risposte più lunghe, fino al massimo del modello, oppure trasmetti la risposta in streaming: senzamax_tokens, una risposta in streaming può arrivare fino al massimo. - Verifica che funzioni
- La risposta termina con
finish_reasonstop. - Ancora non funziona? Inviaci
- Se una risposta termina con
lengthben al di sotto del tuomax_tokens, lo stream è stato interrotto — ripeti la richiesta e, se continua a succedere, inviaci l'ora, il modello e il tuomax_tokens.
timeout La risposta richiede molto tempo o va in timeout
I modelli di ragionamento pensano prima di rispondere, quindi il primo token può richiedere tempo e le risposte lunghe richiedono minuti. L'API attende fino a 150 secondi che un modello inizi a rispondere.
- Controlla
- Se trasmetti la risposta in streaming e il timeout del tuo client: dovrebbe essere superiore a 150 secondi.
- Correggi
- Trasmetti la risposta in streaming (
stream: true): i token arrivano man mano che vengono generati e i messaggi keep-alive mantengono aperta la connessione. Senza streaming, mantieni il timeout del client sopra 150 secondi — gli SDK ufficiali OpenAI e Anthropic attendono 10 minuti per impostazione predefinita; in Claude Code èAPI_TIMEOUT_MS, in Aider--timeout, in OpenClawtimeoutSecondsdel provider. Se una risposta in streaming si interrompe, ripeti la richiesta: l'output di una risposta interrotta non viene addebitato. - Verifica che funzioni
- I primi token compaiono nello stream, oppure la risposta completa arriva entro il timeout.
- Ancora non funziona? Inviaci
- L'ora, il modello, se usi lo streaming, il timeout del tuo client e il punto in cui la risposta si è fermata; l'header di risposta
x-request-id, se il tuo strumento lo mostra.
Hai ancora una domanda? Chiedici
Account e accesso
Accedi e mantieni la tua chiave al sicuro.
Come faccio ad accedere?
Inserisci la tua email e ti invieremo un link magico — nessuna password necessaria. Puoi anche continuare con Google, MetaMask o GitHub.
L'email di accesso non è arrivata
Ogni link di accesso funziona una sola volta e per un tempo limitato, e solo il più recente si apre.
- Controlla
- Le cartelle spam e promozioni, e l'ortografia dell'indirizzo nella pagina di accesso.
- Correggi
- Richiedi un nuovo link nella pagina di accesso e apri l'email più recente.
- Verifica che funzioni
- Il link apre la dashboard con il tuo account.
- Ancora non funziona? Inviaci
- L'indirizzo con cui accedi e quando hai richiesto il link — il modulo in questa pagina funziona senza effettuare l'accesso.
Ho perso la mia chiave API
La dashboard mostra la chiave una sola volta. Premi Ruota per ottenerne una nuova — la vecchia chiave smette di funzionare, quindi aggiornala ovunque la usi.
Hai ancora una domanda? Chiedici
Programma inviti
Guadagna dalle ricariche delle persone che inviti.
Come funziona il Programma inviti?
Condividi il tuo link inviti. Ricevi il 10% di ogni ricarica del saldo effettuata da chi si registra tramite quel link — per tutto il tempo in cui usa CheapTokens.
Dove trovo il mio link inviti?
Nella dashboard, nella scheda Programma inviti: registrati o accedi e copialo lì.
Cosa ricevono le persone che invito?
1.3M+ token gratuiti alla registrazione e altri 52M+ dopo la loro prima ricarica di 5 USD o più.
Come uso i miei premi?
Ogni ricompensa resta in sospeso per 7 giorni dopo la ricarica, poi diventa disponibile sul tuo saldo inviti. Trasferiscila sul tuo saldo API oppure preleva USDT da 20 USD.
Hai ancora una domanda? Chiedici
Non hai trovato la risposta?
Inviaci un messaggio — arriva direttamente al team e ti risponderemo via email.
Non inviare mai la tua chiave API — non ci serve per aiutarti.
Preferisci l'email? Scrivi a support@cheaptokens.dev.