deepseek4api.comGuida
Guida alla documentazione API DeepSeek e alternativa pronta all'uso
La maggior parte delle persone che aprono la documentazione API DeepSeek vuole le stesse cinque risposte: la base URL, come autenticarsi, quale nome di modello usare, quali parametri funzionano e come appare una chiamata funzionante. Questa pagina copre questi punti, poi mostra le stesse chiamate contro un endpoint alternativo compatibile con OpenAI che puoi sostituire.


Punti chiave
- DeepSeek documenta un'API in stile OpenAI, quindi l'SDK OpenAI funziona cambiando base URL, chiave e nome del modello.
- Questo sito non è l'API ufficiale di DeepSeek; serve un unico modello a pesi aperti indipendente con ID uncensored.
- Lo stesso codice funziona su entrambi: cambiano solo tre valori.
- Il contesto qui è di 100.000 token, con supporto per streaming, strumenti e modalità JSON.
Le cinque cose a cui risponde la documentazione API DeepSeek
Quando gli sviluppatori cercano la documentazione API di DeepSeek, di solito vogliono completare una prima richiesta. Lo schema è lo stesso per qualsiasi servizio in stile OpenAI, motivo per cui una tabella facilita il confronto.
| Domanda | Documentazione API DeepSeek | Questa API |
|---|---|---|
| URL di base | Documentato nella loro guida rapida (api.deepseek.com) | https://api.deepseek4api.com/v1 |
| Autenticazione | Token Bearer nell'intestazione Authorization | Token Bearer nell'intestazione Authorization |
| Nome del modello | Elencato nella loro documentazione sui modelli; controlla i nomi attuali | uncensored |
| Endpoint principale | Completamenti conversazionali | Completamenti chat, Risposte, elenco modelli |
| Prezzi | Controlla le tariffe attuali | $0,15 / 1M token input, $0,50 / 1M token output |
Leggi le pagine ufficiali di DeepSeek per qualsiasi informazione sui loro modelli, prezzi e limiti; cambiano e questo articolo non cerca di ripeterli. Il punto è che la forma della richiesta è condivisa, quindi passare tra i due è una modifica di configurazione.
Una cosa da chiarire: questo sito non è l'API ufficiale di DeepSeek e non è un router per DeepSeek. È un endpoint ospitato, compatibile con OpenAI, che serve un unico modello a pesi aperti gestito da un provider indipendente e ottimizzato per rispondere senza filtri sui contenuti per un uso adulto legale.
Passaggio 1: autenticazione e base URL
Crea un account (Google, o email e password) e apri la pagina chiave API. Copia la chiave. I nuovi utenti possono anche richiedere $0,50 di credito di prova con un clic, valido per 7 giorni e senza bisogno di carta.
Ogni richiesta trasporta l'intestazione Authorization: Bearer YOUR_KEY. Con curl:
curl https://api.deepseek4api.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
Questo elenca il modello disponibile, uncensored. Se copi un esempio DeepSeek, sostituisci tre cose: la base URL, la chiave e il nome del modello. Nient'altro deve cambiare.
Passaggio 2: completamento chat in Python
L'SDK OpenAI è ciò che usano i documenti di DeepSeek nei loro esempi, e funziona invariato qui:
from openai import OpenAI
client = OpenAI(
base_url="https://api.deepseek4api.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise technical assistant."},
{"role": "user", "content": "Explain idempotency in two sentences."},
],
temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)
I parametri di campionamento supportati, inclusi temperature, top_p, stop, seed e le penalità di presenza e frequenza, vengono passati. max_tokens è opzionale perché il completamento può usare tutto ciò che rimane della finestra di 100.000 token.
Fase 3: streaming, modalità JSON e strumenti
Streaming
Imposta stream: true per ricevere eventi inviati dal server. L'utilizzo viene segnalato alla fine dello stream.
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.deepseek4api.com/v1",
apiKey: process.env.API_KEY,
});
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a haiku about caching." }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}
Modalità JSON
Passa response_format: {"type": "json_object"} e menziona JSON nel tuo prompt. L'output è un oggetto JSON che puoi analizzare direttamente.
Chiamata di funzioni
I parametri tools e tool_choice funzionano nel formato OpenAI, le chiamate agli strumenti vengono trasmesse in delta e restituisci i risultati come messaggi con role: "tool". Se il tuo codice fa già function calling contro DeepSeek, dovrebbe essere portabile con il cambiamento di tre valori sopra, ma testa i tuoi schemi.
Dove le due soluzioni differiscono
Lo stesso protocollo non significa lo stesso servizio. Cose da controllare quando sposti un carico di lavoro:
- Comportamento del modello. Un modello diverso fornisce risposte diverse, stili di ragionamento e comportamenti di rifiuto diversi. Riesegui il tuo set di prompt prima di modificare qualsiasi cosa in produzione.
- Campi specifici per il ragionamento. Se dipendi da campi di risposta specifici del fornitore da un particolare modello DeepSeek, non assumere che esistano qui. I campi standard di completamento chat sì.
- Funzionalità non offerte. Questa API è solo testo: nessuna immagine, audio, video, embedding o fine-tuning.
- Limiti. Una chiave completa permette 8 richieste concorrenti e 300 al minuto; una chiave di prova permette 2 e 60. Superato un limite ottieni HTTP 429 con
rate_limitedoconcurrency. - Saldo. Controlla il credito con
GET /v1/balance, il percorso di concessione credito in stile OpenAI, o l'intestazioneX-Balance-USDsu ogni risposta.
Per un'idea di come un utente focalizzato su DeepSeek pensa al costo, vedi le note sui prezzi DeepSeek; per le configurazioni editor, la guida VS Code.
Quanto costa una chiamata qui
La fatturazione è prepagata e per token: $0,15 per 1M token input e $0,50 per 1M token output. Una richiesta con 1.500 token input e 600 token output costa 1.500 x $0,15 / 1M = $0,000225 per input più 600 x $0,50 / 1M = $0,0003 per output, per un totale di $0,000525. Un ricarico di $20 copre circa 38.000 tali chiamate.
I ricarichi accettano qualsiasi importo intero da $20 a $500, con +5% da $50, +10% da $100 e +15% da $200. Puoi pagare con cripto (USDT su TRC20, USDC su Base). Il credito non scade mai, e le richieste fallite o rifiutate non vengono addebitate. Dettagli nella pagina prezzi.
Una checklist di migrazione
Se stai portando un'app che già parla con DeepSeek, procedi in ordine. Ogni passaggio richiede minuti.
- Inserisci i tre valori in config. Base URL, chiave e nome del modello dovrebbero provenire da variabili di ambiente, non costanti sparse nel codice.
- Esegui un test di fumo. Un completamento chat, un completamento in streaming, una chiamata in modalità JSON e una chiamata tool. I quattro snippet sopra li coprono.
- Rigioca prompt reali. Prendi 30 prompt dai tuoi log e confronta le risposte fianco a fianco. Giudicale secondo i tuoi criteri piuttosto che un punteggio generico.
- Gestisci 429. Aggiungi retry con backoff e onora
Retry-After. Una richiesta in streaming mantiene il suo slot di concorrenza fino alla fine dello stream, quindi chiudi gli stream abbandonati. - Monitora il costo. Registra
usageda ogni risposta e confrontalo con l'intestazioneX-Balance-USDnel corso di una giornata di traffico. - Lancia gradualmente. Invia prima il 5-10% del traffico al nuovo endpoint, poi aumentalo.
Confronta il costo per attività, non il prezzo per token, perché modelli diversi utilizzano numeri diversi di token per lo stesso lavoro. Per un controllo aperto su come si comportano i modelli di scrittura permissivi, la descrizione del roleplay è un valido supporto.
Scegliere tra le due opzioni
Usa l'API ufficiale di DeepSeek quando hai specificamente bisogno di un modello DeepSeek, delle sue funzionalità vendor o del suo supporto ufficiale. Usa questo endpoint quando vuoi un modello ospitato compatibile con OpenAI che risponde senza rifiuti di contenuto per uso adulto legale, con fatturazione prepagata semplice e prompt non usati per l'addestramento. Molti team vorranno entrambi dietro un interruttore di configurazione, che il protocollo condiviso rende facile. Il materiale di riferimento per questa API vive nella documentazione.
Altre guide
Domande e risposte
È l'API ufficiale di DeepSeek?
No. È un endpoint indipendente compatibile con OpenAI che serve un unico modello a pesi aperti con ID uncensored. Non è il servizio di DeepSeek e non reindirizza a esso.
Posso riutilizzare il mio codice DeepSeek?
Se utilizza l'SDK OpenAI o il formato chat completions, di solito sì. Modifica il base URL, la chiave e il nome del modello, poi testa i tuoi prompt.
Dove trovo il nome del modello?
Chiama GET /v1/models. Questa API serve un unico modello con ID uncensored.
Quanto è grande la finestra di contesto?
100.000 token per prompt più completamento.
Token Bearer nell'intestazione Authorization
Crea un account, copia la chiave, modifica l'URL di base. È tutta la configurazione.