Aggiornato
Chiave API DeepSeek non funzionante: cause e soluzioni
Quando appare un errore di chiave API DeepSeek non funzionante, la chiave è la causa meno spesso di quanto pensi. La maggior parte dei problemi deriva da un URL di base errato, un saldo vuoto, un nome del modello sbagliato o un client che invia la chiave nel posto sbagliato.
Inizia con un test di una riga
Prima di modificare qualcosa nella tua app, rimuovi il client dalla scena. Una singola chiamata curl ti dice se la chiave, l'URL e il nome del modello funzionano insieme. Sostituisci i segnaposto con i valori dal dashboard e dalla documentazione del tuo provider.
curl -i https://YOUR-PROVIDER/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"YOUR-MODEL","messages":[{"role":"user","content":"ping"}]}'Il flag -i stampa la riga di stato e le intestazioni, e contano più del corpo. Se curl funziona e la tua app no, il problema è nelle impostazioni dell'app. Se anche curl fallisce, il problema è la chiave, l'account o l'endpoint.
Leggi prima il codice di stato
| Codice | Significato tipico | Cosa verificare |
|---|---|---|
| 401 | La chiave è stata rifiutata | Errori di copia, spazi extra, chiave revocata o eliminata, chiave di un provider diverso |
| 402 o messaggio sul saldo | Nessun credito rimasto | Saldo dell'account e pagina di fatturazione |
| 404 | Percorso o modello errato | URL di base, /v1 finale, ortografia del nome del modello |
| 429 | Troppe richieste | Richieste al minuto, richieste parallele, intestazioni di retry |
| 5xx o timeout | Lato provider o di rete | Pagina di stato del provider, riprova più tardi, instradamento regionale |
Questi sono i significati comuni tra i provider in stile OpenAI. Ogni provider documenta i suoi codici esatti, quindi controlla la loro documentazione attuale per i dettagli.
La chiave stessa
Le chiavi sono stringhe lunghe e falliscono in modi noiosi. Incolla la chiave in un editor di testo semplice e cerca uno spazio finale o un ritorno a capo, una virgoletta iniziale o un'interruzione di riga aggiunta da un'app di chat. Assicurati che l'intestazione legga Authorization: Bearer KEY con un solo spazio dopo Bearer. Se imposti la chiave in una variabile d'ambiente, stampa la sua lunghezza nella tua app (non il suo valore) per confermare che sia stata caricata.
Si verificano spesso due altri casi. Primo, hai creato una chiave, hai chiuso la pagina e hai copiato una versione mascherata. La maggior parte dei pannelli di controllo mostra una chiave una volta sola, quindi creane una nuova. Secondo, stai usando una chiave di un servizio contro l'URL di un altro servizio. Una chiave è valida solo per il provider che l'ha emessa.
Saldo, fatturazione e credito gratuito
Molte chiavi API funzionano solo mentre l'account ha credito. Un saldo vuoto può sembrare una chiave rotta. Apri la pagina di fatturazione del tuo provider e conferma di avere fondi, che la ricarica sia effettivamente stata accreditata e che il credito promozionale non sia scaduto. Le ricariche con cripto possono richiedere alcuni minuti per apparire.
Se vuoi confrontare come un altro servizio prepagato gestisce questo, il nostro modello è semplice: acquisti credito, le chiamate lo consumano a $0.15 per 1M di token di input e $0.50 per 1M di token di output, le richieste fallite o rifiutate non vengono addebitate e il credito non scade mai. Puoi leggere il saldo con GET /v1/balance o dall'intestazione X-Balance-USD su ogni risposta.
Base URL e nome del modello
La causa più frequente in strumenti come SillyTavern, Janitor AI e plugin per editor è un base URL digitato leggermente sbagliato. Errori comuni: manca /v1, un doppio /v1/v1, l'uso di http invece di https, o l'incolla del percorso completo /chat/completions in un campo che lo aggiunge già. Il campo del modello è l'altra trappola. Deve corrispondere a un ID del modello elencato dal provider. Elencalo con GET /v1/models se il provider lo supporta, o leggi la documentazione corrente.
Le guide di configurazione per strumenti specifici sono su questo sito: uso di una chiave in SillyTavern, in Janitor AI e in VS Code.
Limiti di velocità e concorrenza
Un burst di richieste parallele può innescare un 429 anche su una chiave valida. Cerca un'intestazione Retry-After e riduci la frequenza. Una ritentativa minima in Python è così:
import time
from openai import OpenAI, RateLimitError
client = OpenAI(base_url="https://api.deepseekapikey.com/v1", api_key="YOUR_KEY")
def ask(prompt):
for attempt in range(4):
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": prompt}],
)
return r.choices[0].message.content
except RateLimitError:
time.sleep(5 * (attempt + 1))
raise RuntimeError("still rate limited")Sul nostro endpoint una chiave completa permette 8 richieste concorrenti e 300 richieste al minuto. Una richiesta in streaming mantiene la sua posizione fino al termine dello streaming. Il codice di errore è rate_limited o concurrency, e un sovraccarico temporaneo restituisce 429 con Retry-After: 5.
Problemi di rete e regionali
Se curl si blocca o si resetta, il problema potrebbe essere tra te e il provider: un proxy aziendale, una VPN, DNS o un blocco regionale. Prova una rete diversa, controlla che il tuo proxy trasmetta le intestazioni Authorization e aumenta il timeout del client per le generazioni lunghe. Le risposte in streaming possono anche essere interrotte da proxy che bufferizzano; testa con stream: false per separare i due problemi.
Una checklist che puoi eseguire in cinque minuti
- Esegui il test curl e annota il codice di stato.
- Crea una chiave fresca e testala. Se la nuova chiave funziona, quella vecchia è stata copiata male o revocata.
- Controlla il saldo e qualsiasi data di scadenza sul credito.
- Confronta base URL e ID del modello con la documentazione del provider, carattere per carattere.
- Invia una sola richiesta senza streaming, senza strumenti e con un prompt breve. Aggiungi le funzionalità una alla volta.
- Controlla le chiamate parallele. Se la tua app invia diverse richieste contemporaneamente, riduci la concorrenza.
- Prova un'altra rete o disattiva la VPN.
- Guarda le intestazioni di risposta, inclusa qualsiasi ID di richiesta. Un team di supporto può trovare la tua chiamata da quell'ID.
Il quinto passo rivela un numero sorprendente di bug. Definizioni di strumenti leggermente non valide, un valore molto grande di max_tokens o un corpo oltre il limite di dimensione possono restituire errori che sembrano problemi di chiave. Sul nostro endpoint il limite del corpo è 8 MB e ogni risposta porta un'intestazione X-Request-Id che puoi citare per il supporto.
Configura un endpoint di backup
Guasti e limiti avvengono con qualsiasi provider, quindi tieni un secondo endpoint compatibile con OpenAI nella tua configurazione. Il nostro è un modello a pesi aperti ospitato ottimizzato per rispondere senza rifiuti di contenuti per l'uso adulto legale. Non è l'API ufficiale di DeepSeek e non è un router, quindi aspettati risposte e comportamenti diversi. Il passaggio richiede due impostazioni: base URL https://api.deepseekapikey.com/v1 e modello uncensored.
curl https://api.deepseekapikey.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'I nuovi utenti possono richiedere $0,50 di credito di prova con un clic sulla pagina della chiave API, valido per 7 giorni. Le ricariche vanno da $20 a $500 con cripto; vedi la pagina dei prezzi e la documentazione per i dettagli.
Altre guide
Domande e risposte
Perché la mia chiave funziona in curl ma non nella mia app?
L'app probabilmente ha una base URL sbagliato, un nome del modello sbagliato o una copia obsoleta della chiave. Confronta le sue impostazioni con la tua chiamata curl funzionante carattere per carattere.
Una chiave valida garantisce che le richieste abbiano successo?
No. Un saldo vuoto, un limite di richieste o un nome del modello sconosciuto possono fallire anche con una chiave perfettamente valida.
Posso usare lo stesso codice con un provider diverso?
Se entrambi sono compatibili con OpenAI, sì. Cambia la base URL, la chiave e l'ID del modello.
Il tuo endpoint è lo stesso modello di DeepSeek?
No. È un modello a pesi aperti gestito da un provider indipendente e non è l'API ufficiale di alcun fornitore.
La tua chiave è a un modulo di distanza
Crea un account, copia la chiave, cambia l'URL di base. È tutta la configurazione.
