Una chiave DeepSeek perfettamente valida può comunque generare un errore di rete su Janitor AI. Il problema, spesso, è che endpoint, ID del modello e chiave API provengono da provider diversi. Per la connessione diretta, usa lo stesso account DeepSeek per tutti e tre gli elementi, inserisci l'URL completo di chat completions, aggiorna Janitor AI se necessario e prova prima con un messaggio breve, senza toccare le impostazioni di generazione.
Prima della chiave API, scegli il percorso del provider
Janitor AI è l'interfaccia di chat, mentre DeepSeek fornisce la risposta del modello tramite connessione API. In questo contesto, “proxy” indica il percorso della richiesta verso l'LLM, non un proxy IP né una VPN. La guida ai proxy di Janitor AI approfondisce la differenza e le relative implicazioni di sicurezza.
La regola fondamentale è questa: chiave API, endpoint e nome del modello devono appartenere allo stesso percorso provider. Abbinare una chiave DeepSeek a un URL OpenRouter non configura DeepSeek in modalità diretta, anche se entrambi i servizi offrono API compatibili con OpenAI.
Meglio DeepSeek diretto, AIReiter o OpenRouter?
| Percorso | Chiave da creare | Endpoint e modello | Ideale per |
|---|---|---|---|
| DeepSeek diretto | Chiave API DeepSeek | Endpoint DeepSeek + deepseek-v4-flash oppure deepseek-v4-pro | Fatturazione diretta e percorso più breve verso il provider |
| AIReiter DeepSeek V4 Flash | Chiave API AIReiter | Percorso API compatibile attuale di AIReiter + deepseek-v4-flash | Accesso AIReiter gestito e utilizzo dei modelli a consumo |
| OpenRouter | Chiave API OpenRouter | Endpoint OpenRouter + ID attuale del suo catalogo | Passare tra modelli di più provider |
Questo articolo riguarda la connessione diretta a DeepSeek, la più semplice da verificare rispetto alla documentazione API attuale di DeepSeek. AIReiter è un percorso provider distinto: una chiave AIReiter va usata esclusivamente con il suo endpoint. Per capire meglio il significato generale dei campi proxy di Janitor AI, consulta la guida alla configurazione del proxy di Janitor AI.
Una segnalazione della community mostra perché il solo messaggio d'errore non basta:
“network error” — u/dailylittlebrat, r/JanitorAI_Official
Consideralo un sintomo, non una diagnosi: lo stesso risultato può dipendere da provider non corrispondenti, ID modello obsoleto, saldo insufficiente o configurazione non applicata.
Configurazione DeepSeek diretta: i valori da inserire
Per una nuova connessione diretta, questi sono i valori di partenza. La documentazione quick-start attuale di DeepSeek indica https://api.deepseek.com come base URL compatibile con OpenAI e mostra l'endpoint completo per le richieste /chat/completions. Se Janitor AI invia la richiesta esattamente all'URL inserito, usa l'URL completo; se il connettore attuale documenta l'aggiunta automatica del percorso, segui invece il formato base URL richiesto dal connettore.
| Campo Janitor AI | Valore per DeepSeek diretto |
|---|---|
| Nome configurazione | DeepSeek Direct |
| Nome modello | deepseek-v4-flash |
| URL proxy | https://api.deepseek.com/chat/completions se il campo richiede un endpoint completo |
| Chiave API | La tua chiave da platform.deepseek.com |
Usa deepseek-v4-pro se desideri espressamente il modello di fascia superiore. Nell'attuale pagina Models & Pricing, DeepSeek indica prezzi per token inferiori per Flash rispetto a Pro, pur rendendo entrambi disponibili nella stessa famiglia API. DeepSeek include anche deepseek-v4-flash-vision-exp, ma per una chat testuale su Janitor AI è preferibile iniziare con Flash o Pro anziché con un modello vision sperimentale.
Alcuni tutorial meno recenti suggeriscono ancora deepseek-chat o deepseek-reasoner. Usa gli ID V4 presenti nella documentazione live di DeepSeek, senza dare per scontato che un alias precedente sia ancora supportato.
Cosa preparare prima di aprire Janitor AI
- Un account DeepSeek Platform su
platform.deepseek.com. - Una chiave API DeepSeek appena creata.
- Saldo disponibile sull'account. Nella documentazione degli errori DeepSeek, HTTP
402corrisponde a saldo insufficiente. - Un'impostazione del personaggio o dell'account che consenta l'uso di proxy esterni, se disponibile nella tua interfaccia Janitor AI.
- Un luogo sicuro in cui conservare la chiave durante la configurazione.
L'accesso consumer al sito di chat DeepSeek non equivale a una chiave API. Crea la chiave nella piattaforma per sviluppatori, copiala senza spazi aggiuntivi e parti con un saldo ridotto: se la chiave venisse esposta, non rischieresti una fattura elevata e inattesa.
Configurare DeepSeek su Janitor AI passo dopo passo
La procedura è lineare: crea la chiave, inserisci endpoint e modello, salva, aggiorna la pagina se serve e invia un breve messaggio di prova.
Crea e ricarica l'account API DeepSeek
- Apri DeepSeek Platform.
- Crea un account sviluppatore o accedi a quello esistente.
- Apri la sezione delle chiavi API e genera una chiave per Janitor AI.
- Copia subito la chiave e non condividerla.
- Aggiungi saldo sufficiente per un piccolo test.
DeepSeek fattura l'uso API in base ai token, non semplicemente al numero di messaggi inviati su Janitor AI. Una character card molto lunga e una cronologia di chat estesa possono trasmettere molti token di input a ogni turno. Per questo è più prudente iniziare con poco saldo, invece di presumere che “DeepSeek” significhi accesso API gratuito e illimitato.
Aggiungi la configurazione proxy
- Apri una chat con un personaggio su Janitor AI.
- Cerca API Settings o la voce equivalente disponibile nella tua versione.
- Seleziona il controllo provider disponibile, ad esempio Proxy, Custom o compatibile con OpenAI.
- Se l'interfaccia mostra Add Configuration, crea una nuova configurazione.
- Inserisci
DeepSeek Directcome nome della configurazione. - Inserisci
deepseek-v4-flashnel campo del modello. - Inserisci
https://api.deepseek.com/chat/completionsnel campo URL proxy se richiede l'endpoint completo. - Incolla la chiave API DeepSeek nel campo dedicato.
- Salva la configurazione e selezionala come percorso attivo.
Non inserire solo https://api.deepseek.com se il campo di Janitor AI richiede l'endpoint finale della richiesta. Se il connettore attuale documenta l'aggiunta di /chat/completions, usa invece il relativo formato base URL.
Salva, aggiorna e fai un test rapido
Se la nuova configurazione sembra non essere applicata, aggiorna o riapri la scheda di Janitor AI prima del test. Usa un prompt breve, per esempio: “Rispondi con una frase per confermare la connessione.”
Una risposta breve conferma autenticazione, risoluzione del modello e completamento di base; non verifica tutte le impostazioni del personaggio o del contesto.
Se il test fallisce, non modificare subito temperatura, token massimi o altri controlli di generazione. Verifica prima il percorso provider, l'endpoint, l'ID modello, la chiave, il saldo e ogni impostazione che abilita l'uso del proxy.
Risoluzione errori: individua il primo punto di blocco
Il troubleshooting è più rapido se isoli il primo sistema che ha rifiutato la richiesta. Controlla anzitutto chiave e saldo DeepSeek, poi i campi configurati in Janitor AI; solo dopo passa allo stato del browser o alla disponibilità del provider.
| Errore o sintomo | Livello più probabile | Prima azione |
|---|---|---|
401 Unauthorized | Autenticazione | Crea o copia una nuova chiave DeepSeek, elimina eventuali spazi e verifica che sia una chiave DeepSeek. |
402 o saldo insufficiente | Fatturazione account | Aggiungi saldo all'account DeepSeek associato alla chiave. |
404 o modello non trovato | Endpoint o ID modello | Confronta URL completo e nome esatto del modello con la documentazione DeepSeek aggiornata. |
429 Too Many Requests | Limite di richieste del provider | Evita tentativi rapidi ripetuti, attendi, riduci la frequenza delle richieste e controlla i limiti del provider. |
| Errore di rete o “failed to fetch” | URL, browser, autorizzazione o raggiungibilità | Ricontrolla l'endpoint HTTPS completo, aggiorna Janitor AI e verifica le eventuali impostazioni di autorizzazione del proxy. |
500 o 503 | Disponibilità lato provider | Attendi e riprova più tardi; tentativi ripetuti possono peggiorare i limiti di richiesta. |
| Risposta vuota o troncata | Gestione della generazione o del contesto | Prova una conversazione più breve e riduci il limite di output dopo aver confermato credenziali e percorso. |
Il riferimento ufficiale agli errori di DeepSeek distingue autenticazione (401), saldo (402), limitazione della frequenza (429), errore interno (500) e server occupato (503). È una differenza importante: cambiare chiave API non risolve un 429, e cambiare IP non aggiunge saldo a un account con errore 402.
Per separare un problema lato provider da un errore di configurazione in Janitor AI, prova prima gli stessi valori del provider nel client quick-start documentato da DeepSeek. Non pubblicare mai una chiave attiva.
FAQ: DeepSeek su Janitor AI
Posso usare DeepSeek su Janitor AI senza chiave API?
Non tramite il percorso API diretto. La connessione proxy personalizzata di Janitor AI richiede le credenziali del provider scelto; un account consumer per la chat DeepSeek non sostituisce una chiave API DeepSeek Platform.
DeepSeek è gratuito su Janitor AI?
L'API DeepSeek diretta va considerata come accesso API a consumo, non come chat gratuita illimitata. La pagina dei prezzi di DeepSeek riporta le tariffe per token e il riferimento agli errori include la risposta per saldo insufficiente; i percorsi gratuiti di OpenRouter seguono limiti distinti.
Una VPN o un proxy IP può risolvere un errore 429?
Di solito no. Un 429 indica un limite imposto dal provider sulla frequenza delle richieste: attendere, inviare meno richieste, cambiare percorso API o verificare i limiti dell'account è più utile che cambiare indirizzo IP.
Mantieni chiave, endpoint e ID modello all'interno dello stesso percorso provider; poi aggiorna Janitor AI e prova un messaggio breve prima di ottimizzare le impostazioni di generazione.