La tua prima richiesta API con CheapTokens

Questa guida ti porta da un nuovo account a una richiesta funzionante. Ti servono un indirizzo email, un piccolo saldo e un terminale. L'API è compatibile con OpenAI, quindi se hai già chiamato OpenAI in passato, cambiano solo due cose: l'URL di base e la chiave.

Cosa ti serve#

• Un account. La registrazione avviene via email — nessuna password, ti inviamo un link di accesso.
• Un saldo. Non c'è abbonamento: ricarichi un saldo in USD e ogni richiesta viene addebitata per token alla tariffa fissa del modello.
• Una chiave API dalla tua dashboard.

Passo 1. Crea un account e ricarica#

Apri la pagina di registrazione, inserisci la tua email e segui il link dalla lettera. Nella dashboard premi Top up e scegli come pagare:

• Crypto — da $5; si applica una commissione di deposito del 5%.
• Carta — tramite un partner, che applica una propria commissione.

Passo 2. Copia la tua chiave API#

Appena il saldo supera lo zero — dopo una ricarica o un bonus referral — la dashboard crea la tua chiave API e la mostra una sola volta. Copiala subito e tienila fuori dal tuo codice, ad esempio in una variabile d'ambiente:

export CHEAPTOKENS_API_KEY="paste-your-key-here"

Se la chiave trapela, premi Rotate: ottieni una nuova chiave e quella vecchia smette di funzionare.

Passo 3. Scegli un modello#

Le richieste richiedono l'ID completo del modello — con il prefisso prima della barra, esattamente come lo elenca l'API. Il catalogo al momento della scrittura (ottobre 2026):

Il catalogo può cambiare, quindi la fonte di verità è l'API stessa. Questa richiesta non richiede chiave:

curl https://api.cheaptokens.dev/v1/models

Passo 4. Invia la richiesta#

curl#

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [{"role": "user", "content": "Say hello in three languages"}]
  }'

Una risposta riuscita torna nel formato standard Chat Completions. Un esempio abbreviato — il tuo testo, gli ID e i numeri saranno diversi, e la risposta può contenere campi di servizio aggiuntivi:

{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Hello! Hola! Bonjour!" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 14, "completion_tokens": 9, "total_tokens": 23 }
}

• Il testo è in choices[0].message.content.
• L'utilizzo dei token è in usage: prompt_tokens — input, completion_tokens — output. Questi due numeri sono ciò per cui viene addebitata la richiesta.

Python#

Installa l'SDK ufficiale con pip install openai e puntalo al nostro URL di base:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
)
resp = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4-Flash-0731",
    messages=[{"role": "user", "content": "Say hello in three languages"}],
)
print(resp.choices[0].message.content)
print("tokens in/out:", resp.usage.prompt_tokens, resp.usage.completion_tokens)

JavaScript#

Installa l'SDK con npm install openai:

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: "deepseek-ai/DeepSeek-V4-Flash-0731",
  messages: [{ role: "user", content: "Say hello in three languages" }],
});
console.log(resp.choices[0].message.content);

Client in stile Anthropic#

I client creati per l'API Anthropic Messages usano l'indirizzo radice senza /v1 — https://api.cheaptokens.dev — e inviano la chiave nell'header x-api-key. Gli SDK Anthropic aggiungono da soli il percorso e l'header; tu imposti solo l'URL di base e la chiave.

Se qualcosa va storto#

• 401 Invalid API key — la chiave è stata digitata male o è stata ruotata. Controlla di averla incollata per intero; la dashboard mostra una chiave una sola volta, quindi se è persa, premi Rotate per ottenerne una nuova.
• 402 — il saldo è esaurito, oppure la richiesta è partita senza l'header Authorization.
• 400 Model "…" not found — usa l'ID completo del modello da /v1/models, incluso il prefisso prima della barra.
• 404 — controlla l'indirizzo: i client in stile OpenAI necessitano di /v1 alla fine dell'URL di base.

Altri casi e soluzioni: Errori di connessione comuni e come risolverli.

Quanto costa#

Ogni richiesta viene addebitata per i token di input e output separatamente, alla tariffa del modello per milione di token. Prezzi attuali — gli stessi dati della pagina dei prezzi:

Prossimo passo: collega un agente di coding, ad esempio Cline, oppure impara a stimare quanto costerà un agente AI.

Consigli CheapTokens ad altri sviluppatori? Con il programma referral ricevi una percentuale delle loro ricariche.