URL Base e Autenticazione
Avvia ogni richiesta puntando il tuo client verso l'URL base corretto. Usa la chiave ricevuta durante la registrazione per passare nell' Authorization header. Questo header autentica il tuo account e traccia l'utilizzo del tuo credito prepagato.
La nostra infrastruttura è costruita per gli sviluppatori che vogliono accesso diretto senza commissioni di instradamento intermedie. Ottieni prestazioni coerenti perché gestiamo i nostri server.
Prima richiesta
Invia il tuo primo messaggio per verificare la connettività e la risposta del modello. Usa l'endpoint standard per le chat completions con il tuo prompt di sistema e la query dell'utente. Questo conferma che la tua chiave funziona e mostra la risposta JSON grezza.
- Imposta il
modelfield auncensored. - Includi un semplice messaggio utente per testare la latenza.
- Verifica il
usageoggetto per i conteggi dei token.
SDK Python
Integra rapidamente utilizzando la libreria Python ufficiale. Installa il pacchetto e inizializza il client con il tuo URL di base e la chiave. Questo approccio gestisce automaticamente la serializzazione e i tentativi.
Definisci la cronologia delle conversazioni come un elenco di dizionari. Passali direttamente all'endpoint chat. La libreria restituisce un oggetto di risposta strutturato che puoi analizzare per il testo dell'assistente.
SDK Node
Crea logica server-side con il client Node.js. Importa la libreria e configura la chiave API e l'URL di base. Questa configurazione funziona bene per i servizi backend che elaborano gli input degli utenti in modo asincrono.
Chiama il metodo completion con i tuoi messaggi. La risposta include il testo generato e le statistiche di utilizzo. Gestisci gli errori in modo elegante per evitare crash della tua applicazione durante carichi elevati.
Risposte in streaming
Ricevi i token in tempo reale per un'esperienza utente più fluida. Abilita lo streaming impostando l'apposito flag nella tua richiesta. Il server invia chunk di dati man mano che vengono generati.
Accumula questi chunk lato client per visualizzare il testo in modo progressivo. Questo riduce significativamente la latenza percepita. Monitora l'ultimo chunk per l'utilizzo totale dei token e i dati di fatturazione.
Limiti, Errori e Contesto
Rispetta i limiti di frequenza per evitare interruzioni. Hai diritto a 300 richieste al minuto e a 8 connessioni concorrenti per chiave. Se superi questo limite, riceverai un errore 429.
Un errore 401 significa che la tua chiave API non è valida. Un errore 402 indica credito prepagato insufficiente. La tua finestra di contesto è di 100.000 token in totale. Mantieni il prompt e la risposta entro questo limite per garantire prestazioni affidabili.
cURL
curl https://api.deepseekapiaccess.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Calculate the total latency for three sequential API calls."}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.deepseekapiaccess.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)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.deepseekapiaccess.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);Streaming
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)