Guida all'Integrazione: chiave API deepseek coder

URL Base e Autenticazione

La tua chiave API autentica ogni richiesta. Imposta l'URL base su https://api.deepseekcoderapikey.com/v1 nella configurazione del tuo client. Questo URL gestisce sia gli endpoint chat completions che models senza richiedere segmenti di percorso aggiuntivi. Ricevi una singola chiave per account e la generazione di una nuova chiave sostituisce immediatamente quella precedente.

Memorizza la chiave in una variabile di ambiente denominata DEEPSEEK_API_KEY o passalo direttamente al tuo client SDK. L'endpoint accetta intestazioni standard, quindi puoi cambiare provider modificando solo l'URL di base e il valore della chiave. Questo approccio funziona con Cursor, estensioni VS Code e strumenti di sviluppo locali che si aspettano un'interfaccia compatibile con OpenAI.

L'autenticazione fallisce con un codice di stato 401 se la chiave è mancante o non valida. Utilizza il

Copycurl https://api.deepseekcoderapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Convert this SQL query to python pandas syntax"}]
  }'

esempio per verificare la connettività prima di integrare nella logica della tua applicazione.

Endpoint Chat Completions (POST)

Invia messaggi al POST /v1/chat/completions endpoint utilizzando l'ID del modello uncensored. Questo endpoint elabora input testuale e restituisce output testuale, supportando risposte sia sincrone che in streaming. Puoi configurare il comportamento del modello utilizzando parametri come temperatura, top_p e sequenze di stop.

La finestra di contesto consente fino a 100.000 token per il prompt e il completamento combinati. Se non specifichi un limite max_tokens, il modello utilizza un valore predefinito di 2.048 token per richiesta. Usa il

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.deepseekcoderapikey.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

snippet per vedere come strutturare una richiesta di chat standard con l'official OpenAI Python SDK.

Errori come credito insufficiente restituiscono un codice di stato 402, mentre le richieste malformed restituiscono 400. Controlla il corpo della risposta per messaggi di errore dettagliati per debuggare rapidamente la struttura del payload.

Endpoint dei modelli (GET)

Interroga i modelli disponibili inviando un GET /v1/models richiesta. Questo endpoint restituisce un elenco di oggetti modello, incluso il uncensored ID del modello. Puoi utilizzare questo endpoint per verificare che la tua chiave API sia valida e che il servizio sia online prima di effettuare richieste di utilizzo intensivo.

La risposta include metadati come l'ID del modello, il tipo di oggetto e le informazioni sulla proprietà. Usa questi dati per configurare dinamicamente la tua applicazione o per registrare i modelli disponibili per scopi di debug. L'endpoint non richiede un body, solo l'intestazione di autenticazione standard.

L'integrazione di questo controllo nella sequenza di avvio garantisce che la tua applicazione fallisca rapidamente se l'API non è raggiungibile. Aiuta inoltre a verificare che l'URL di base sia configurato correttamente prima di procedere con le effettive completazioni della chat.

Risposte in streaming (SSE)

Abilita lo streaming impostando il stream impostare il parametro su true nella tua richiesta. L'API restituisce un flusso di Server-Sent Events (SSE), consegnando i token man mano che vengono generati. Questo approccio riduce la latenza percepita per gli assistenti di coding e consente aggiornamenti dell'interfaccia utente in tempo reale nella tua applicazione.

Ogni chunk contiene contenuto parziale e l'ultimo chunk include le statistiche complete sull'utilizzo dei token. Analizza attentamente lo stream SSE per gestire le interruzioni di rete e bufferizzare i token parziali. Il

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

esempio dimostra come gestire lo stream in JavaScript.

Lo streaming è ideale per la generazione di codice a lungo termine o per spiegazioni dettagliate. Offre un'esperienza utente più fluida rispetto all'attesa dell'intera risposta. Assicurati che il tuo client gestisca correttamente l'evento di fine stream per finalizzare la risposta.

Function Calling e modalità JSON

Utilizza il function calling per consentire al modello di invocare strumenti esterni. Definisci le tue funzioni in tools parameter e specifica il tool_choice per controllare quando il modello li utilizza. L'API supporta definizioni standard degli strumenti, consentendoti di integrare i tuoi servizi backend.

Per output strutturati, abilita la modalità JSON impostando response_format a json_object. Questo forza il modello a restituire JSON valido, utile per l'analisi dei dati di configurazione o per le risposte API. Il

Copyimport OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

snippet mostra come configurare la modalità JSON in Node.js.

Combina il function calling con lo streaming per l'utilizzo interattivo degli strumenti. Il modello può invocare più strumenti in un singolo turno, consentendo flussi di lavoro multi-step complessi. Assicurati che il tuo client gestisca correttamente l'output degli strumenti per mantenere il contesto della conversazione.

Limiti di frequenza e vincoli

La tua chiave API è limitata a 300 richieste al minuto e 8 richieste concorrenti. La dimensione massima del corpo della richiesta è di 8 MB. Se superi questi limiti, l'API restituisce un errore 429 Too Many Requests. Implementa un backoff esponenziale nel tuo client per gestire i limiti di frequenza in modo elegante.

Errori come 401 indicano una chiave non valida, mentre 402 segnala credito insufficiente. I rimborsi non vengono emessi per il credito, ma le doppie addebitazioni possono essere risolte tramite la pagina Supporto. Il credito non scade mai, quindi puoi ricaricare quando è conveniente.

La finestra di contesto di 100.000 token si applica al prompt e al completamento totali. Monitora l'utilizzo dei token per restare nel budget. Usa il sistema di credito prepagato per pagare solo ciò che utilizzi, senza canoni mensili o abbonamenti.