Come pagare l'API DeepSeek: ricarica e prima chiamata

Pagare per un'API AI è più semplice di quanto sembri: ricarichi un saldo prepagato, crei una chiave e ogni richiesta attinge da quel saldo. Questa guida ti accompagna passo passo con DeepSeek-V4-Flash su CheapTokens, dalla ricarica a una richiesta funzionante.

Alla fine avrai un saldo finanziato, una chiave e una richiesta che restituisce una risposta.

Come funziona#

CheapTokens è pay as you go. Versi denaro su un saldo in USD e ogni richiesta detrae il costo dei token utilizzati. Non c'è abbonamento e un unico saldo copre tutti i modelli. I prezzi per modello sono fissi, senza tariffe di punta o legate all'orario.

Il modello di questa guida è DeepSeek-V4-Flash, release 0731 (id deepseek-ai/DeepSeek-V4-Flash-0731). Ha una finestra di contesto di 380K e può restituire fino a 32.768 token in una singola risposta.

Per un primo test, una piccola ricarica è più che sufficiente: una richiesta breve costa una frazione minima di centesimo, come mostrano i numeri qui sotto.

Passo 1. Ricarica il saldo#

1. Accedi al tuo account CheapTokens.
2. Apri la sezione di ricarica del saldo e inserisci l'importo.
3. Completa il pagamento nella pagina di checkout.
4. Attendi che il nuovo saldo compaia nel tuo account.

Se in seguito una richiesta fallisce con un errore di saldo, vedi "Not enough tokens" error: what it means and how to fix it.

Passo 2. Crea una chiave API#

Crea una chiave nel tuo account e copiala subito. Trattala come una password: conservala in una variabile d'ambiente, non nel codice o in un repository pubblico. L'articolo What is an API key and how to store it safely spiega come fare.

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

Passo 3. Invia la prima richiesta#

L'API è compatibile con OpenAI Chat Completions (e con Anthropic Messages), quindi la maggior parte dei client funziona cambiando la base URL: https://api.cheaptokens.dev/v1.

Con 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 one sentence."}],
    "max_tokens": 100
  }'

Con la libreria Python ufficiale di OpenAI:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
)

response = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4-Flash-0731",
    messages=[{"role": "user", "content": "Say hello in one sentence."}],
    max_tokens=100,
)
print(response.choices[0].message.content)

Se ottieni una risposta testuale, pagamento, chiave e connessione funzionano tutti. Per una prima chiamata più dettagliata, vedi Your first API request with CheapTokens, e per risposte lunghe e streaming, DeepSeek-V4-Flash API quickstart.

Quanto costa la richiesta#

Paghi i token di input (quello che invii) e i token di output (quello che scrive il modello). Prezzi attuali di MiniMax-M2.7 per 1M di token: input $0.05, output $0.15.

Una richiesta di test con circa 300 token di input e 200 di output costa $0.000045. Quindi anche la ricarica più piccola copre un numero molto elevato di esperimenti.

Nel complesso, contando insieme input e output, MiniMax-M2.7 su CheapTokens è più economico di OpenRouter. Per un confronto aggiornato, vedi l'articolo DeepSeek API pricing.

Quale nome DeepSeek usare#

Usa l'id deepseek-ai/DeepSeek-V4-Flash-0731 esattamente come scritto sopra. I nomi dei modelli variano tra i provider, quindi copia gli id dalla documentazione di CheapTokens anziché da un altro servizio.

Problemi comuni#

• Errore di autenticazione. Verifica che la chiave sia copiata per intero e che la variabile d'ambiente sia impostata nello stesso terminale.
• Errore di saldo. La ricarica non è ancora arrivata o il saldo è vuoto. Attendi la conferma del pagamento, poi riprova.
• Errore di connessione. Verifica che la base URL termini con /v1. Maggiori dettagli in Common connection errors and how to fix them.

Prossimi passi#

Ora hai un saldo finanziato e una chiamata funzionante. Usa la stessa chiave e la stessa base URL in qualsiasi strumento compatibile con OpenAI e mantieni un unico saldo per tutti i modelli.

Endpoint, id dei modelli e limiti di ogni modello sono nella CheapTokens docs.