IT ▾
Ottieni la chiave API

deepseek4api.comGuida

AI senza censura in VS Code: Continue, Cline e Cursor

Una configurazione deepseek v4 api vscode si riduce a tre valori: un URL di base, una chiave API e un ID modello. Questa guida mostra esattamente dove incollarli in Continue, Cline e Cursor, come testare la connessione prima e cosa fare quando fallisce.

Aggiornato

Illustrazione isometrica di un pannello dell'editor di codice collegato tramite un cavo a un nodo cloud luminoso, che rappresenta un endpoint API

Punti chiave

  • Qualsiasi estensione dell'editor con un provider OpenAI compatibile funziona: usa l'URL di base https://api.deepseek4api.com/v1 e l'ID modello uncensored.
  • Fai un test con curl su GET /v1/models prima di toccare l'editor, così sai che la chiave e l'URL sono corretti.
  • L'API supporta solo i completamenti di chat, quindi usala per chat, modifiche e agent, non per l'autocompletamento inline con Tab.
  • Una tipica domanda di codice con 8.000 token di contesto costa circa $0,0017.

Cosa ti serve prima di iniziare

Gli editor che ti permettono di usare il tuo modello chiedono tutti le stesse tre cose. Ecco quali sono per questo servizio.

ImpostazioneValore
URL di basehttps://api.deepseek4api.com/v1
Chiave APILa tua chiave dalla pagina della chiave API, inviata come Authorization: Bearer
ID modellouncensored
Tipo di provider"OpenAI" o "OpenAI-compatible"

Un rapido chiarimento per evitare sorprese in seguito. Il nome di questo sito menziona DeepSeek V4, ma il modello dietro l'endpoint è un modello a pesi aperti gestito da un provider indipendente. Non è l'API ufficiale di DeepSeek. Nell'editor scegli il provider generico compatibile con OpenAI, mai uno specifico del fornitore, perché un provider specifico punta ai server di quel fornitore e ignora il tuo Base URL.

I nuovi utenti possono richiedere $0,50 di credito di prova con un clic dopo la registrazione, senza bisogno della carta, che è più che sufficiente per i test seguenti. La chiave di prova funziona con 2 richieste parallele e 60 richieste al minuto.

Testa l'endpoint da un terminale prima

Metà di tutti i problemi di configurazione degli editor è dovuta a un URL errato o a una chiave digitata male, e gli editor non sono bravi a dirti quale. Due comandi curl eliminano i dubbi. Apri il terminale all'interno di VS Code (Ctrl+` su Windows e Linux, Cmd+` su macOS) ed esegui il primo.

# expect the model id "uncensored" in the list
curl https://api.deepseek4api.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Dovresti vedere un elenco JSON che include il modello uncensored. Ora invia una vera richiesta di chat:

curl https://api.deepseek4api.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a Python function that reverses a linked list."}],
    "max_tokens": 300
  }'

Se entrambi funzionano, l'editor funzionerà con gli stessi valori. Se il primo restituisce un errore di autorizzazione, la chiave è sbagliata o contiene uno spazio di troppo. Se ottieni un 404, controlla che l'URL finisca con /v1 e non abbia percorsi aggiuntivi dopo di esso.

Continue in VS Code

Continue è un'estensione per assistente open-source per VS Code e JetBrains. Installala dalla vista Estensioni, apri il suo pannello e apri il file di configurazione dall'icona dell'ingranaggio. Nelle versioni attuali il file è config.yaml, e una voce di modello per questa API appare così:

models:
  - name: Uncensored API
    provider: openai
    model: uncensored
    apiBase: https://api.deepseek4api.com/v1
    apiKey: YOUR_API_KEY
    roles:
      - chat
      - edit
      - apply
    defaultCompletionOptions:
      contextLength: 100000
      maxTokens: 2000
      temperature: 0.4

Le versioni precedenti di Continue usano un config.json con un array models, dove gli stessi campi appaiono come "provider": "openai", "model": "uncensored" e "apiBase": "https://api.deepseek4api.com/v1". Il formato del file è cambiato tra le versioni, quindi se il tuo pannello mostra un layout diverso, segui la struttura generata da Continue e sostituisci questi tre valori.

La lunghezza del contesto di 100000 corrisponde alla finestra di contesto di questa API (prompt più completamento). Il valore inferiore maxTokens è un limite massimo per ogni risposta. Ti protegge da una risposta lunga che non ti serviva. Salva il file, seleziona il modello nel menu a discesa della chat Continue e fai una domanda sul file che hai aperto. Evidenzia il codice e usa il comando di modifica per riscrivere una selezione.

Cline

Cline è un'estensione di tipo agent che legge i file, propone modifiche ed esegue comandi con la tua approvazione. Apri le sue impostazioni, scegli il provider API denominato "OpenAI Compatible" e compila i campi:

  1. URL di base: https://api.deepseek4api.com/v1
  2. Chiave API: la tua chiave
  3. ID modello: uncensored

Gli agenti sono chiacchieroni. Un singolo compito può generare una dozzina di richieste mentre lo strumento legge i file, li modifica e verifica i risultati, e ogni richiesta reinvia la conversazione finora. È qui che i calcoli dei costi contano. Supponiamo che un passaggio di un agente contenga 40.000 token di contesto e ne generi 1.500. Questo costa 40.000 x $0,15 / 1M più 1.500 x $0,50 / 1M, ovvero $0,006 più $0,00075, per un totale di $0,00675. Venti di questi passaggi per un compito equivalgono a $0,135. Avvia nuovi compiti invece di lasciare che una conversazione cresca per ore, e la tua fattura rimarrà stabile.

L'API supporta la chiamata di funzioni (tools, tool_choice e tool_calls in streaming, con risultati restituiti come role: "tool"), su cui si basano le estensioni agent. Controlla la documentazione per la forma esatta della richiesta se crei il tuo agent.

Cursor e altri editor

Cursor è un editor separato basato sul codice di VS Code. Ha una pagina delle impostazioni del modello dove puoi inserire la tua chiave OpenAI e sovrascrivere il Base URL di OpenAI. Incolla https://api.deepseek4api.com/v1 lì, incolla la tua chiave e aggiungi un modello personalizzato chiamato uncensored. Le opzioni e le regole dei piani di Cursor cambiano di tanto in tanto, quindi controlla la sua documentazione attuale per sapere dove si trova l'override e quali funzionalità lo utilizzano. Le funzionalità che girano sui modelli propri di Cursor, come il completamento automatico a tab, non passano attraverso il tuo endpoint.

Lo stesso approccio funziona in qualsiasi strumento che offra un provider OpenAI compatibile: Zed, plugin JetBrains, plugin Neovim, assistenti terminal e i tuoi script. Se uno strumento accetta solo un elenco fisso di fornitori, cerca una variabile d'ambiente. Molti strumenti basati su OpenAI leggono OPENAI_BASE_URL e OPENAI_API_KEY, che puoi impostare nella tua shell:

# base URL https://api.deepseek4api.com/v1, model uncensored
export OPENAI_BASE_URL="https://api.deepseek4api.com/v1"
export OPENAI_API_KEY="YOUR_API_KEY"
# then select the model name "uncensored" inside the tool

Cosa funziona bene e cosa non funziona

Ecco quanto questa API si adatta ai flussi di lavoro di programmazione.

  • Funziona: chat sul tuo codice, spiegazione degli errori, scrittura di funzioni, refactoring di una selezione, generazione di test, bozza di messaggi di commit, strumenti agent che chiamano funzioni.
  • Non funziona: autocompletamento inline che dipende dagli endpoint fill-in-the-middle. L'API espone solo POST /v1/chat/completions e GET /v1/models, quindi non c'è la rotta completamenti legacy. Tieni un altro strumento per il completamento con tab se ne fai affidamento.
  • Non disponibile: embeddings, quindi le estensioni che indicizzano il tuo codice con un modello di embedding necessitano di una fonte di embedding separata. Lo stesso vale per la generazione di immagini, audio e video, e il fine-tuning.

Il modello è un modello di testo generale che non rifiuta per l'uso adulto legale. Non facciamo affermazioni sui benchmark per la programmazione, quindi giudicalo con il tuo codice. Usa una temperatura bassa per il codice, intorno a 0,2-0,4, e fornisci all'estensione un'istruzione chiara sul linguaggio e lo stile.

Per quanto riguarda il costo, una domanda di codice che invia 8.000 token di contesto del file e riceve una risposta di 1.000 token costa 8.000 x $0,15 / 1M più 1.000 x $0,50 / 1M, che è $0,0012 più $0,0005, o $0,0017. Cento di questi al giorno lavorativo per 22 giorni sono 2.200 chiamate e $3,74. Vedi la pagina dei prezzi per i livelli di ricarica.

Risoluzione degli errori comuni

SintomoCausa probabileSoluzione
Errore 401 o di autorizzazioneChiave errata, spazio extra o chiave incollata nel campo sbagliatoRicopia la chiave, poi ripeti il test curl
404 non trovatoURL di base senza /v1 o con un percorso in piùUsa esattamente https://api.deepseek4api.com/v1
Modello non trovatoNome del modello digitato in modo diversoUsa uncensored in minuscolo
429 con concurrencyPiù richieste contemporaneamente di quanto permetta la tua chiave (8 con chiave standard, 2 di prova)Riduci le richieste parallele dell'estensione, o aspetta
429 con rate_limitedPiù di 300 richieste al minuto (60 in prova)Rallenta l'agent o raggruppa i passaggi
429 con Retry-After: 5Sovraccarico temporaneoRiprova dopo cinque secondi
Richiesta troppo grandeCorpo oltre 8 MBInvia meno file o file più piccoli come contesto

Le risposte in streaming mantengono uno slot di concorrenza fino alla fine dello streaming, quindi se apri più pannelli di chat contemporaneamente con una chiave di prova, raggiungerai il limite di concorrenza prima del previsto. Controlla le intestazioni di risposta X-RateLimit-Limit-Requests e X-RateLimit-Limit-Concurrency per confermare cosa permette la tua chiave, e l'intestazione X-Balance-USD per vedere quanto credito è rimasto. Le richieste fallite non vengono addebitate, quindi i tentativi sono gratuiti.

Domande e risposte

Quale ID modello inserisco in VS Code?

Inserisci uncensored, in minuscolo, con l'URL di base https://api.deepseek4api.com/v1 e la tua chiave API. Scegli il tipo di provider compatibile con OpenAI nell'estensione.

È l'API ufficiale di DeepSeek V4?

No. È un modello a pesi aperti gestito da un provider indipendente e non è l'API ufficiale di DeepSeek o di qualsiasi altro fornitore.

Posso usarlo per il completamento inline del codice?

Non per il completamento fill-in-the-middle. L'API offre solo completamenti di chat e un elenco di modelli. Funziona per chat, modifiche e strumenti per agent.

Perché ottengo errori 429 in un'estensione agent?

Gli agent inviano molte richieste contemporaneamente. Una chiave standard permette 8 richieste concorrenti e 300 al minuto, mentre una chiave di prova ne permette 2 e 60. Riduci il parallelismo o riprova dopo il ritardo Retry-After.

La tua chiave è a un modulo di distanza

Crea un account, copia la chiave, modifica l'URL di base. È tutta la configurazione.