Chiave API DeepSeek in VS Code: configurazione con la nostra API

La versione breve

Hai chiesto come usare la chiave api deepseek in vscode, e la risposta ha due parti. Primo, VS Code stesso non accetta una chiave API per un modello linguistico; lo fa un'estensione. Secondo, la chiave di questo sito non è una chiave DeepSeek. Appartiene a un'API indipendente compatibile con OpenAI che esegue un modello open-weight, ottimizzato per rispondere senza rifiuti di contenuti per uso adulto legale, e non è l'API ufficiale di DeepSeek. Se possiedi una chiave dalla piattaforma stessa di DeepSeek, inseriscila con l'endpoint di DeepSeek.

Per questa API, ogni estensione ha bisogno degli stessi tre valori:

• Base URL: https://api.deepseekapikey.com/v1
• Chiave API: la chiave dal tuo account, inviata come token Bearer
• Modello: uncensored

Le sezioni seguenti mostrano dove inserire questi valori in Continue e nelle estensioni della famiglia Cline, poi come verificare che tutto funzioni e mantenere i costi prevedibili.

Prima di iniziare: ottieni una chiave e testala

Registrati alla pagina delle chiavi API con Google o con email e password. I nuovi utenti possono richiedere $0,50 di credito di prova con un clic, valido per 7 giorni, uno per persona, senza carta richiesta. Le ricariche a pagamento partono da $20.

Apri il terminale integrato in VS Code (Ctrl+` o Cmd+`) ed esegui una richiesta. Se questo funziona, qualsiasi errore successivo è un'impostazione dell'estensione e non un problema della chiave.

Copyexport API_KEY="paste-your-key-here"

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

Una risposta JSON con un array choices significa che la chiave, l'URL e il nome del modello sono corretti. Un 401 significa una chiave errata. Un 404 di solito significa un percorso errato. Puoi anche colpire GET /v1/models con lo stesso header come verifica economica.

Opzione 1: l'estensione Continue

Continue è un'estensione assistant open-source per VS Code che ti permette di definire i tuoi modelli. Installala dalla vista Estensioni, apri le sue impostazioni e aggiungi un modello che usa il provider OpenAI con una base API personalizzata. Continue ha cambiato il formato di configurazione nel tempo, da un file JSON a un file YAML, quindi controlla la documentazione corrente dell'estensione se il tuo file sembra diverso. I campi hanno lo stesso significato in entrambi. Nella forma JSON, una voce modello appare così:

Copy{
  "models": [
    {
      "title": "Uncensored API",
      "provider": "openai",
      "model": "uncensored",
      "apiBase": "https://api.deepseekapikey.com/v1",
      "apiKey": "YOUR_KEY"
    }
  ]
}

Nella forma YAML, la voce modello ha le stesse chiavi: un nome, provider: openai, model: uncensored, apiBase impostato sul base URL, e la chiave. Salva il file, seleziona il nuovo modello nel menu a discesa dei modelli di Continue e fai una domanda nel pannello laterale.

Nota che questa API documenta solo le chat completions. Chat, modifica e spiegazione sono l'uso naturale. L'autocompletamento tab inline di solito si basa su uno stile di richiesta diverso pensato per completare testo nel mezzo di una riga, che non è elencato tra le funzionalità di questa API, quindi non aspettarti che funzioni. Tieni un provider di autocompletamento separato per quello se ne hai bisogno.

La chiave risiede in un file, quindi tieni quel file fuori dal tuo repository. Se usi una configurazione a livello di workspace, aggiungila a .gitignore, o usa la configurazione globale nella tua directory home.

Opzione 2: Cline e estensioni agent simili

Cline, e le estensioni derivate come Roo Code, eseguono un agent che legge file, propone modifiche ed esegue comandi con la tua approvazione. Il loro pannello delle impostazioni ha un menu a discesa del provider API. Scegli la voce per un provider compatibile con OpenAI e compila il modulo:

1. Base URL: https://api.deepseekapikey.com/v1
2. Chiave API: la tua chiave
3. ID modello: uncensored

Alcune versioni chiedono una dimensione della finestra di contesto e un valore massimo di output per il modello personalizzato. Inserisci 100000 per la finestra, poiché quella è la dimensione del contesto di questa API, prompt e risposta insieme. Scegli un output massimo di qualche migliaio di token in modo che una risposta non sfugga di mano.

Gli agent usano la chiamata di funzioni o un formato di testo strutturato per agire, e l'API supporta la forma di chiamata di funzioni OpenAI (tools, tool_choice, role: "tool" risultati) insieme allo streaming. Quanto bene un modello segua le istruzioni di un agent varia, quindi inizia con compiti piccoli, come rinominare una funzione su due file, e osserva i primi passaggi prima di lasciarlo eseguire più a lungo.

Gli agent inviano anche molte richieste in sequenza. Una chiave completa permette 8 richieste parallele e 300 al minuto, una chiave di prova 2 e 60. Un singolo agent è di solito ben dentro quei numeri, ma due agent più un pannello chat su una chiave di prova possono raggiungere il limite di concorrenza e produrre errori 429.

Chiamare l'API dal tuo codice in VS Code

A volte l'obiettivo non è un'estensione ma uno script che esegui dall'editor. Qualsiasi SDK OpenAI funziona. In Node:

Copyimport OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.deepseekapikey.com/v1",
  apiKey: process.env.API_KEY,
});

const res = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Review this function for off-by-one errors." }],
});
console.log(res.choices[0].message.content);

Tieni la chiave in una variabile d'ambiente, un file .env che è git-ignored, o nel tuo archivio segreti del sistema operativo, mai in un file commitato. La versione Python della stessa chiamata usa OpenAI(base_url="https://api.deepseekapikey.com/v1", api_key=...). La quickstart ha più esempi, incluso streaming e modalità JSON.

Quanto costano le sessioni di coding

Il prezzo è $0,15 per 1M token di input e $0,50 per 1M token di output. Gli assistenti di coding inviano molto contesto, quindi l'input domina. Prendi una richiesta con 30.000 token di codice e cronologia chat e una risposta di 1.000 token:

• Input: 30.000 / 1.000.000 x $0,15 = $0,0045
• Output: 1.000 / 1.000.000 x $0,50 = $0,0005
• Totale: $0,005 per richiesta, quindi 200 richieste costano $1,00.

Un prompt completo da 100.000 token con la stessa risposta costa $0,015 + $0,0005 = $0,0155. È ancora una cifra piccola, ma i loop degli agenti lo ripetono molte volte, quindi mantieni il contesto stretto: apri i file rilevanti, non l'intero repository, e avvia una nuova chat quando il compito cambia.

Il credito è prepagato e non scade mai, e non ci sono abbonamenti. Le richieste fallite o rifiutate non vengono addebitate. Ricarica con qualsiasi importo intero da $20 a $500, con +5% da $50, +10% da $100 e +15% da $200, pagando con cripto (USDT su TRC20, USDC su Base). Una ricarica di $50 accredita $52,50. Vedi la pagina dei prezzi per i dettagli.

Lista di controllo per la risoluzione dei problemi

• 401 Non autorizzato. La chiave è errata o ha spazi bianchi finali. Ricorda che una chiave emessa dalla piattaforma stessa di DeepSeek non funzionerà qui.
• 404 Non trovato. Controlla il base URL. Alcune estensioni aggiungono /chat/completions da sole, quindi fornisci loro la base che termina con /v1. Altre vogliono il percorso completo. Segui il suggerimento nel campo.
• Modello non trovato. L'ID modello deve essere esattamente uncensored.
• 429 con codice concurrency. Troppe richieste contemporaneamente. Chiudi chat o agenti extra. Le richieste in streaming mantengono il loro slot fino al termine.
• 429 con Retry-After: 5. Sovraccarico temporaneo. Attendi cinque secondi e il retry dell'estensione di solito ha successo.
• Richiesta troppo grande. Il limite del body è 8 MB, e il limite di contesto è 100.000 token. Taglia i file allegati.

I prompt non vengono utilizzati per l'addestramento, ma la tua estensione potrebbe mantenere i propri log e la telemetria, quindi controlla le impostazioni se lavori con codice privato. Il servizio è per uso adulto legale e ha una regola rigida contro i contenuti sessuali che coinvolgono minorenni. Genera solo testo, quindi il codice va bene e le immagini no. Se vuoi conoscere le differenze tra questo servizio e quello ufficiale di DeepSeek, l'articolo su miti e realtà lo spiega.

Altre guide

• Chiave API DeepSeek su Janitor AI: Configurazione con la nostra API
• Chiave API DeepSeek in SillyTavern: connetti la nostra API
• API DeepSeek: miti vs. realtà per l'accesso senza censura