Avvio rapido: Integrazione API DeepSeek Coder
Questa guida rapida ti aiuta a integrare la nostra API DeepSeek Coder uncensored con il tuo codebase esistente utilizzando endpoint compatibili con OpenAI standard. Imparerai come autenticarti, inviare richieste e gestire le risposte in streaming con un controllo preciso sui parametri del modello.
URL Base e Autenticazione
La tua chiave API autentica ogni richiesta al nostro endpoint ospitato. Usa l'URL base https://api.coderdeepseek.cc/v1 con qualsiasi SDK OpenAI o client HTTP. L'identificatore del modello è rigorosamente uncensored. Questo servizio gira sui nostri server e non è una rivendita del modello di un altro fornitore. Ricevi una chiave API immediata al momento della registrazione tramite Google o email. Conserva questa chiave in modo sicuro poiché controlla il tuo credito prepagato.
L'autenticazione si basa sul Authorization header. Passa la tua chiave come token Bearer. Ogni richiesta deve includere questo header per evitare un 401 errore. Non utilizziamo parametri di query per l'autenticazione. Questo garantisce header puliti e compatibilità con middleware standard.
Invio di richieste: Chat Completions
L'endpoint di completamento chat elabora i tuoi prompt e restituisce output testuali. Invia una richiesta POST a /v1/chat/completions. Includi il nome del modello, l'array messages e i parametri desiderati. Il sistema elabora il testo in input e restituisce testo in output. Puoi controllare il formato della risposta e i criteri di arresto. Questo funziona sia per query semplici che per attività di codifica complesse.
Usa il seguente comando curl per testare la tua connessione. Sostituisci YOUR_API_KEY con la tua chiave effettiva. La richiesta utilizza il uncensored modello identificatore. Questo conferma che la tua autenticazione e il saldo del credito sono attivi.
curl https://api.coderdeepseek.cc/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "what is the current version of the library"}]
}'Verifica che la risposta contenga il choices array. Ogni scelta include un messaggio con il contenuto generato. Controlla il usage oggetto per i conteggi dei token. Questo aiuta a monitorare le tue spese in modo accurato.
Integrazione SDK Python
Integra l'API nei tuoi progetti Python utilizzando il pacchetto ufficiale OpenAI. Imposta l'URL base sul nostro endpoint. Inizializza il client con la tua chiave API. Questo ti permette di utilizzare metodi familiari come chat.completions.create. L'SDK gestisce automaticamente la serializzazione JSON e le richieste HTTP.
Configura il modello su uncensored. Passa i tuoi messaggi nel formato standard. L'SDK supporta tutte le nostre funzionalità tra cui il function calling e la modalità JSON. Puoi impostare parametri come temperatura e top_p direttamente. Questo rende la migrazione da altri provider semplice.
from openai import OpenAI
client = OpenAI(base_url="https://api.coderdeepseek.cc/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)Gestisci le eccezioni per errori di rete o richieste non valide. Controlla il codice di stato se analizzi la risposta grezza. Questo garantisce una gestione robusta degli errori nella tua applicazione. L'SDK astrae la maggior parte della complessità.
Integrazione SDK Node
Utilizza l'SDK OpenAI Node.js per integrarti nei tuoi progetti JavaScript o TypeScript. Installa il pacchetto e configura l'URL di base. Questo mantiene la compatibilità con la tua struttura di codice esistente. Puoi utilizzare gli stessi metodi di Python. L'SDK supporta sia CommonJS che moduli ES.
Imposta il modello su uncensored. Passa i tuoi messaggi e parametri. L'SDK gestisce le richieste in streaming e non in streaming. Puoi catturare gli errori e registrarli in modo appropriato. Questo garantisce che la tua applicazione rimanga stabile sotto carico.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.coderdeepseek.cc/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);Testa la tua integrazione con un prompt semplice. Verifica che la risposta corrisponda alle tue aspettative. Controlla l'utilizzo dei token nell'oggetto di risposta. Questo ti aiuta a monitorare i costi e le prestazioni. L'SDK rende facile iterare rapidamente.
Risposte in streaming e utilizzo dei token
Abilita lo streaming impostando stream: true nella tua richiesta. L'API restituisce uno stream di Server-Sent Events (SSE). Ricevi chunk di testo man mano che vengono generati. Questo riduce la latenza percepita per le risposte lunghe. L'ultimo chunk contiene l'utilizzo totale dei token.
Analizza gli eventi SSE per estrarre il contenuto. Concatena gli chunk per formare la risposta completa. Monitora il usage oggetto nell'ultimo chunk. Questo fornisce conteggi dei token accurati per la fatturazione. Lo streaming è ideale per le applicazioni in tempo reale.
stream = 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)Gestisci le interruzioni di rete in modo elegante. Riconnetti se lo stream si interrompe. L'API non reinvia i chunk precedenti. Devi ricostruire il testo completo sul lato client. Questo garantisce un'esperienza utente fluida.
Limiti, Errori e Finestra di Contesto
La nostra API impone limiti rigorosi per garantire la stabilità. Puoi effettuare 300 richieste al minuto per chiave. Fino a 8 richieste possono essere eseguite simultaneamente. Il corpo della richiesta non deve superare gli 8 MB. Il superamento di questi limiti comporta un 429 errore limite di frequenza. Gestisci questi errori con backoff esponenziale.
La finestra di contesto è di 100.000 token. Include sia il prompt che il completamento. L'output massimo è di 16.000 token per richiesta. Se non imposti max_tokens, il valore predefinito è 2.048. A 401 errore significa che la tua chiave non è valida. Un 402 errore significa che non hai credito. Ricarica tramite criptovalute per continuare a utilizzare il servizio.
Domande frequenti
Qual è l'URL base per l'API DeepSeek Coder?
L'URL di base è HTTPS://api.coderdeepseek.cc/v1. Questo funziona con qualsiasi client compatibile con OpenAI. Devi impostare il modello su uncensored.
Come gestisco i limiti di frequenza?
Hai un limite di 300 richieste al minuto. Se lo superi, riceverai un errore 429. Implementa un backoff esponenziale per ritentare le richieste.
Cosa succede se rimango senza credito?
Riceverai un errore 402. La tua chiave API rimane valida. Effettua un ricarico tramite USDT o USDC per ripristinare l'accesso. Il credito non scade mai.
La tua chiave API è a solo un passo di distanza
Iscriviti, ottieni la tua chiave e aggiorna l'URL di base. È la configurazione completa.