Guida rapida per utenti DeepSeek

URL di base e autenticazione

Per utilizzare la nostra API, punta il tuo client su https://api.deepseekapi.top/v1. Non è necessario modificare i percorsi degli endpoint; il percorso standard /v1/chat/completions funziona esattamente come previsto. L'autenticazione si basa su una singola chiave API generata durante la registrazione. Trasmetti questa chiave nell'intestazione Authorization come token Bearer. Se la chiave è mancante o non valida, il server restituisce un errore 401. Assicurati che le variabili di ambiente siano impostate correttamente prima di effettuare la prima richiesta.

• URL di base: https://api.deepseekapi.top/v1
• Intestazione di autenticazione: Authorization: Bearer YOUR_API_KEY

Copiacurl https://api.deepseekapi.top/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Endpoint Chat Completions

La nostra API accetta richieste standard di completamento chat. Invia una richiesta POST a /v1/chat/completions con un ID modello di uncensored. Il modello risponde all'input di testo e genera output testuale senza applicare i filtri sui contenuti tipici di DeepSeek ufficiale o di altri provider principali. Questo lo rende ideale per la scrittura creativa, il gioco di ruolo o l'elaborazione dati senza restrizioni. Puoi controllare il comportamento utilizzando parametri come temperature e top_p. La risposta include il testo generato e le statistiche sull'utilizzo dei token.

Ricorda che il modello non è GPT, Claude o qualsiasi altro modello di un fornitore. È un modello a pesi aperti indipendente ottimizzato per un utilizzo legale senza restrizioni. Consulta la pagina dei prezzi per i costi dei token.

Copiafrom openai import OpenAI

client = OpenAI(base_url="https://api.deepseekapi.top/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)

Integrazione SDK Node.js

Per gli sviluppatori Node.js, il processo è identico alle integrazioni OpenAI standard. Inizializza il client con il tuo URL di base e chiave API specifici. Imposta il modello su uncensored nella tua configurazione. L'SDK gestisce il ciclo di vita della richiesta, inclusi i tentativi e la gestione degli errori, proprio come farebbe per qualsiasi servizio compatibile con OpenAI. Questo ti permette di riutilizzare le codebase esistenti con il minimo sforzo. Assicurati di utilizzare una versione recente del pacchetto npm openai per una piena compatibilità.

L'API supporta chiamate sia sincrone che asincrone. Puoi passare i messaggi nel formato array standard messages. La struttura della risposta corrisponde alla specifica dell'API OpenAI, rendendo la migrazione semplice.

Copiaimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.deepseekapi.top/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);

Risposte in streaming

Abilita lo streaming impostando stream: true nella tua richiesta. L'API restituisce uno stream Server-Sent Events (SSE). Ogni chunk contiene una risposta parziale, permettendoti di visualizzare il testo mentre viene generato. I dati sull'utilizzo dei token sono inclusi solo nell'ultimo chunk dello stream, non in ogni chunk. Questo design riduce le dimensioni del payload fornendo comunque metriche di fatturazione accurate. Non è necessario configurare stream_options speciali per ottenere i dati di utilizzo; vengono forniti automaticamente alla fine.

Gestisci gli eventi dello stream per aggiornare la tua UI in tempo reale. Lo stream termina quando il modello completa la sua risposta o raggiunge un limite.

Copiastream = 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)

Chiamata di funzioni e modalità JSON

L'API supporta la chiamata di funzioni tramite i parametri tools e tool_choice. Definisci le tue funzioni nella richiesta e il modello restituirà chiamate di strumenti strutturate. Puoi anche forzare un output JSON rigoroso impostando response_format su {"type": "json_object"}. Questo è utile per generare dati strutturati senza errori di parsing. Il modello è ottimizzato per seguire queste istruzioni in modo affidabile.

Combina la chiamata di funzioni con lo streaming per interazioni dinamiche. L'API mantiene il contesto attraverso più turni, permettendo flussi di lavoro complessi in più fasi. Assicurati che le definizioni delle tue funzioni siano chiare e ben strutturate per ottenere i migliori risultati.

Limiti, errori e finestra di contesto

La tua finestra di contesto è di 100.000 token, combinando prompt e completamento. L'output massimo è di 32.000 token per richiesta, o 2.048 se non imposti max_tokens. I limiti di richiesta sono di 300 richieste al minuto e 8 richieste parallele per chiave. Se li superi, ricevi un errore 429. Un errore 401 indica una chiave non valida, mentre un errore 402 significa che il tuo credito prepagato è esaurito. Gli errori e i rifiuti non consumano token. Le richieste sono limitate a un corpo di 8 MB. Iscriviti con Google o email per ottenere la tua chiave immediatamente.