Guida all’API key di DeepSeek

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.

Aggiornato il
  • 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.
Oriveo su iPhone: la schermata dei fornitori, con i fornitori che hai collegato e la spesa del mese.

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.

API di DeepSeek o app DeepSeek: che differenza c’è?
AspettoApp DeepSeekAPI di DeepSeek con la tua chiave
Che cos’èL’app di chat di DeepSeekAccesso per app e sviluppatori, con la tua chiave
Dove si gestisceNell’appSulla DeepSeek Platform (platform.deepseek.com)
Come si pagaVedi le pagine ufficiali di DeepSeekA token, da un saldo che ricarichi
Dove si usaNell’app di DeepSeekIn 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.
Schermata «Fornitori» di Oriveo su iPhone, con il pulsante + in alto a destra e l’elenco dei fornitori collegati con la relativa spesa
Tocca + nella schermata «Fornitori» per aggiungere DeepSeek. Nell’elenco, ogni fornitore collegato mostra la sua spesa stimata.

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.
Perché la mia API key DeepSeek non funziona?
ErroreChe cosa significaChe cosa fare
401 Authentication FailsLa chiave è sbagliataCopia di nuovo la chiave senza spazi in più, oppure creane una nuova
402 Insufficient BalanceIl saldo è finitoRicarica sulla DeepSeek Platform, poi invia di nuovo
429 Rate Limit ReachedTroppe richieste in poco tempoAspetta un attimo e invia di nuovo
503 Server OverloadedDeepSeek è molto caricoRiprova un po’ più tardi
500 Server Error o 504 Gateway TimeoutUn problema dal lato di DeepSeekRiprova più tardi; se continua, contatta DeepSeek

Domande frequenti

L’API key di DeepSeek è gratis o a pagamento?
Creare la chiave è gratis; l’uso dell’API si paga a token dal tuo saldo DeepSeek. La pagina dei prezzi di DeepSeek cita un saldo concesso che viene usato per primo, ma al 18 novembre 2026 non dice a quanto ammonta né chi lo riceve.
Dove trovo la mia API key DeepSeek?
Sulla DeepSeek Platform, alla pagina platform.deepseek.com/api_keys. Se quando l’hai creata non hai salvato la chiave completa, creane una nuova lì ed elimina quella vecchia.
Che cosa significa l’errore 402 Insufficient Balance di DeepSeek?
Il saldo DeepSeek è finito. Ricarica sulla DeepSeek Platform, poi invia di nuovo il messaggio. Aspettare non risolve, e nemmeno una chiave nuova.
Posso usare l’API di DeepSeek sul telefono?
Sì, con un’app che accetti la tua chiave. In Oriveo per iPhone o Android apri «Fornitori», tocca +, scegli DeepSeek, incolla la chiave e tocca «Continua». Le richieste vanno dal telefono direttamente a DeepSeek.
Quanto costa l’API di DeepSeek?
Il prezzo è per milione di token e dipende dal modello e dall’orario. I prezzi aggiornati sono sulla pagina ufficiale dei prezzi di DeepSeek. Oriveo mostra un costo stimato su ogni risposta; l’importo definitivo è quello dei registri di DeepSeek.
L’API di DeepSeek è la stessa cosa dell’app DeepSeek?
No. L’app è il prodotto di chat di DeepSeek; l’API è un servizio a pagamento per le app, addebitato su un saldo sulla DeepSeek Platform. La documentazione dell’API di DeepSeek non dice che l’una includa l’altra.
Mi serve un Base URL per DeepSeek?
In Oriveo no. DeepSeek è un fornitore integrato, quindi il suo indirizzo è già impostato. Il Base URL (indirizzo base) è l’indirizzo web a cui un’app invia le richieste: serve quando colleghi un servizio personalizzato.

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.