DeepSeek API key: come ottenerla e se è gratuita
Come ottenere un’API key DeepSeek, come funziona la ricarica, come risolvere l’errore 402 Insufficient Balance e usarla su iPhone, Android o web senza codice.
- Per ottenere un’API key DeepSeek (in italiano «chiave API»), accedi alla DeepSeek Platform, apri la pagina delle chiavi (platform.deepseek.com/api_keys), crea una chiave e copiala: secondo le guide di DeepSeek inizia con «sk-». Crearla è gratis, ma l’uso si paga a token, da un saldo che ricarichi in anticipo.
- Un’API key permette a un’app di usare i modelli di DeepSeek sul tuo account. Con un’app di chat che accetta la tua chiave, come Oriveo, la usi su iPhone, Android o web senza scrivere una riga di codice.
- Il problema più comune è l’errore 402 Insufficient Balance: il saldo è finito. Ricarica sulla DeepSeek Platform e riprova; aspettare non serve.

Che cos’è un’API key DeepSeek?
Un’API key, in italiano «chiave API», è un lungo codice segreto che ti identifica presso un servizio. API sta per application programming interface, cioè interfaccia di programmazione: il modo in cui un programma chiede qualcosa a un altro. L’app invia la tua chiave a ogni richiesta, così DeepSeek sa a quale account addebitare il costo.
Non serve saper programmare. Gli sviluppatori inseriscono la chiave nel loro codice; tu puoi semplicemente incollarla in un’app di chat, che si occupa della parte tecnica.
Tratta la chiave come una password che può spendere soldi: chiunque la abbia può consumare il tuo saldo DeepSeek.
Come ottenere un’API key DeepSeek?
Bastano pochi minuti. La chiave si crea sulla DeepSeek Platform, il sito per sviluppatori, non dentro l’app di chat di DeepSeek.
- Vai su platform.deepseek.com e accedi, oppure crea un account.
- Apri la pagina delle chiavi API: platform.deepseek.com/api_keys.
- Crea una nuova chiave API e dalle un nome facile da riconoscere, per esempio «Oriveo sul telefono».
- Copia subito la chiave e conservala in un posto sicuro, come un gestore di password. Secondo le guide di DeepSeek, le chiavi iniziano con «sk-».
- Ricarica il saldo (vedi sotto). Senza saldo, i messaggi falliscono con l’errore 402 Insufficient Balance.
L’API di DeepSeek è gratis?
Creare la chiave non costa nulla; usarla si paga. DeepSeek fa pagare a token: un token è un pezzetto di testo, più o meno una parola breve o una parte di una parola più lunga, e si contano sia il tuo messaggio sia la risposta.
La pagina dei prezzi di DeepSeek dice che i costi vengono scalati dal saldo ricaricato oppure da un «saldo concesso» (granted balance), e che il saldo concesso viene usato per primo. Al 18 novembre 2026 la pagina non dice quanto saldo concesso si riceve, chi ne ha diritto né quando scade, quindi non farci affidamento. Il saldo che vedi sulla DeepSeek Platform è quello che hai davvero.
I prezzi sono indicati per milione di token, variano da modello a modello e possono cambiare, quindi non li riportiamo qui: trovi quelli aggiornati sulla pagina ufficiale dei prezzi di DeepSeek, api-docs.deepseek.com/quick_start/pricing. Al 18 novembre 2026 quella pagina indica che fuori dalle ore di punta il prezzo è la metà di quello nelle ore di punta, che cadono nei giorni feriali (dal lunedì al venerdì) dalle 01:00 alle 04:00 e dalle 06:00 alle 10:00 UTC.
Oriveo mostra un costo stimato su ogni risposta, calcolato sui prezzi pubblicati da DeepSeek, così vedi quanto spendi man mano. L’importo definitivo è quello dei registri di utilizzo di DeepSeek.
Come ricaricare il saldo DeepSeek?
Accedi alla DeepSeek Platform e apri la pagina Top up (ricarica). È lì che ti manda anche la pagina dei codici di errore di DeepSeek quando il saldo finisce. La pagina Top up mostra gli importi e i metodi di pagamento attuali: controlla lì, invece di fidarti delle cifre riportate da altri siti.
Finché non sai quanto consumi, ricarica una piccola cifra. In Oriveo vedi il costo stimato di ogni risposta e dopo qualche giorno puoi confrontarlo con il saldo su DeepSeek.
API di DeepSeek o app DeepSeek: che differenza c’è?
L’app DeepSeek è il prodotto di chat già pronto di DeepSeek. L’API di DeepSeek è un servizio per app e sviluppatori: ottieni una chiave, ricarichi un saldo e qualsiasi app che supporti DeepSeek può inviare richieste a nome del tuo account.
Sono due cose separate. La documentazione dell’API di DeepSeek non descrive alcun legame tra l’app e l’API, quindi non dare per scontato che l’una paghi o sblocchi l’altra. Il saldo dell’API sta sulla DeepSeek Platform.
Perché usare l’API? Ti permette di usare DeepSeek dentro un’app a tua scelta, accanto ai modelli di altri fornitori, con un costo stimato su ogni risposta.
| Aspetto | App DeepSeek | API di DeepSeek con la tua chiave |
|---|---|---|
| Che cos’è | L’app di chat di DeepSeek | Accesso per app e sviluppatori, con la tua chiave |
| Dove si gestisce | Nell’app | Sulla DeepSeek Platform (platform.deepseek.com) |
| Come si paga | Vedi le pagine ufficiali di DeepSeek | A token, da un saldo che ricarichi |
| Dove si usa | Nell’app di DeepSeek | In qualsiasi app che accetti una chiave DeepSeek, come Oriveo |
Come usare l’API key DeepSeek su iPhone, Android o web?
Ti serve un’app che accetti la tua chiave DeepSeek. In Oriveo, DeepSeek è uno dei 15 fornitori integrati, quindi non c’è nessun indirizzo da digitare: scegli DeepSeek e incolli la chiave. I passaggi sono gli stessi su iPhone, Android e web.
- Apri «Fornitori»: è una scheda su iPhone e Android e una voce della barra laterale sul web.
- Tocca il pulsante + («Aggiungi fornitore»).
- In «Collega un fornitore» scegli DeepSeek. I filtri «Tutti», «Diretto», «Aggregatori» e «Personalizzato» restringono l’elenco.
- Incolla la chiave sotto «Collega DeepSeek» e tocca «Continua». Sul web la verifica parte da sola appena incolli la chiave.
- Attendi che Oriveo convalidi la connessione e sincronizzi i modelli, poi scegli un modello DeepSeek e inizia a chattare.

Che fine fanno la mia chiave e i miei messaggi?
Se DeepSeek rifiuta la chiave, Oriveo la salva comunque e mostra «Salvato, ma la chiave sembra non valida. Puoi verificarla più tardi nelle impostazioni del fornitore.» Copia di nuovo la chiave dalla DeepSeek Platform e aggiornala nelle impostazioni del fornitore in Oriveo.
Su iPhone e Android le richieste vanno direttamente dal tuo dispositivo al fornitore, e la chiave è conservata nell’archivio sicuro del telefono (Keychain su iPhone, Keystore su Android). Nell’app web le richieste passano da un inoltro in tempo reale sul server di Oriveo: la chiave viene usata solo per quella richiesta e non viene salvata come dato dell’account, e le chat BYOK non vengono conservate come registri delle conversazioni. Le chiavi non vengono caricate dalla sincronizzazione cloud. Per questo su un telefono nuovo devi incollare di nuovo la chiave, oppure creare una chiave diversa per ogni dispositivo.
Paghi DeepSeek direttamente, ai suoi prezzi di listino. Oriveo non aggiunge alcun ricarico.
Perché la mia API key DeepSeek non funziona?
La pagina dei codici di errore di DeepSeek (api-docs.deepseek.com/quick_start/error_codes) spiega ogni errore. Questi sono quelli che capitano più spesso, al 18 novembre 2026:
- In Oriveo il 402 compare come «Quota del fornitore raggiunta».
- Crea una chiave diversa per ogni app o dispositivo: così puoi eliminarne una senza bloccare le altre.
- Se una chiave è finita in una chat, in un’email o in una pagina pubblica, eliminala dalla pagina delle chiavi API e creane una nuova.
- Non dare la tua chiave DeepSeek a rivenditori o servizi intermediari di terze parti.
| Errore | Che cosa significa | Che cosa fare |
|---|---|---|
| 401 Authentication Fails | La chiave è sbagliata | Copia di nuovo la chiave senza spazi in più, oppure creane una nuova |
| 402 Insufficient Balance | Il saldo è finito | Ricarica sulla DeepSeek Platform, poi invia di nuovo |
| 429 Rate Limit Reached | Troppe richieste in poco tempo | Aspetta un attimo e invia di nuovo |
| 503 Server Overloaded | DeepSeek è molto carico | Riprova un po’ più tardi |
| 500 Server Error o 504 Gateway Timeout | Un problema dal lato di DeepSeek | Riprova più tardi; se continua, contatta DeepSeek |
Domande frequenti
L’API key di DeepSeek è gratis o a pagamento?
Dove trovo la mia API key DeepSeek?
Che cosa significa l’errore 402 Insufficient Balance di DeepSeek?
Posso usare l’API di DeepSeek sul telefono?
Quanto costa l’API di DeepSeek?
L’API di DeepSeek è la stessa cosa dell’app DeepSeek?
Mi serve un Base URL per DeepSeek?
Letture correlate
Usa la tua chiave DeepSeek sul telefono
Apri l’app web o scarica Oriveo per iPhone o Android, incolla la tua chiave DeepSeek e vedi un costo stimato su ogni risposta. Non hai ancora una chiave? Con Oriveo Free puoi iniziare anche senza.
Non hai ancora una chiave API? Con Oriveo Free puoi iniziare senza.