getdeepseekapi.comGuida
URL API DeepSeek e Base URL: come cambiare
L'URL dell'API DeepSeek che copi dalla documentazione ufficiale di DeepSeek è un URL base e funziona solo con la chiave di DeepSeek e i modelli di DeepSeek. Se vuoi un endpoint diverso in stile OpenAI, modifichi quell'URL, la chiave e l'ID del modello.
Aggiornato
Punti chiave
- Un URL base è il prefisso; l'SDK aggiunge /chat/completions ad esso.
- Questo servizio utilizza https://api.getdeepseekapi.com/v1 con ID modello uncensored.
- Non è l'API di DeepSeek, quindi una chiave DeepSeek non funzionerà qui e viceversa.
- La maggior parte dei client accetta anche l'URL e la chiave tramite OPENAI_BASE_URL e OPENAI_API_KEY.

Base URL, endpoint e percorso: le tre parti
Le persone spesso incollano un indirizzo completo in un campo che si aspetta un prefisso, ottenendo poi un 404. Tre termini mantengono le idee chiare.
- Base URL: il prefisso condiviso di ogni chiamata, ad esempio
https://api.getdeepseekapi.com/v1. Questo è ciò che inserisci nelle impostazioni "API base" o "Base URL" di un client. - Percorso endpoint: la parte aggiunta dall'SDK, come
/chat/completions,/responseso/models. - URL completo: base più percorso, come
https://api.getdeepseekapi.com/v1/chat/completions. I client HTTP grezzi come curl ne hanno bisogno.
La regola che riguarda la maggior parte degli utenti: gli SDK e le app richiedono l'URL base, curl e i nodi HTTP richiedono l'URL completo. Se uno strumento restituisce un 404, controlla prima se hai inserito un URL completo dove ci si aspettava un URL base, o viceversa. Un percorso duplicato come /v1/chat/completions/chat/completions nell'errore è la spia.
Qual è l'URL base di DeepSeek e cosa non lo è
DeepSeek pubblica il suo indirizzo API nella documentazione, insieme ai nomi dei modelli che la chiave può utilizzare. Cerca lì il valore corrente invece di fidarti di un post sul blog, incluso questo. Una chiave DeepSeek funziona contro l'endpoint di DeepSeek e nessun altro.
Il servizio su questo sito è un prodotto separato. Non è l'API ufficiale DeepSeek, non reindirizza a DeepSeek e non serve modelli DeepSeek. È un'API ospitata compatibile con OpenAI per un modello a pesi aperti, gestita da un provider indipendente e ottimizzata per rispondere senza filtri sui contenuti per uso adulto legale. Il suo indirizzo è:
https://api.getdeepseekapi.com/v1 # model: uncensored
L'ID del modello è uncensored, e l'autenticazione è Authorization: Bearer <key>. Le chiavi vengono emesse nella pagina delle chiavi API. Se stai confrontando cosa significa una chiave per ogni servizio, la pagina sulla chiave API DeepSeek ha maggiori dettagli.
Cambio degli endpoint negli SDK OpenAI
Qualsiasi SDK OpenAI funziona dopo aver modificato l'URL base e la chiave. In Python:
from openai import OpenAI
client = OpenAI(
base_url="https://api.getdeepseekapi.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Name three uses for a base URL."}],
)
print(resp.choices[0].message.content)
In Node.js il campo si scrive baseURL:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.getdeepseekapi.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Name three uses for a base URL." }],
});
console.log(resp.choices[0].message.content);
Nota la differenza: Python usa base_url, Node usa baseURL. Scambiarli silenziosamente riporta all'indirizzo OpenAI predefinito, che quindi rifiuterà la tua chiave.
Cambio senza toccare il codice
Gli SDK ufficiali OpenAI leggono due variabili d'ambiente, quindi un'app esistente può essere reindirizzata senza modifiche al codice:
export OPENAI_BASE_URL="https://api.getdeepseekapi.com/v1"
export OPENAI_API_KEY="YOUR_KEY"
python app.py # the app still has to request model "uncensored"
Il nome del modello è la parte che non puoi saltare. Se l'app codifica in hardcode un altro ID modello, richiederà quello e fallirà, quindi modificalo in uncensored nelle impostazioni o nella configurazione dell'app. Molti strumenti espongono tutti e tre i valori in un'unica schermata delle impostazioni, solitamente etichettata come API base, chiave API e modello.
Lo stesso scambio dei tre valori funziona nei framework. Con LangChain in Python, ad esempio, ChatOpenAI(base_url="https://api.getdeepseekapi.com/v1", api_key="YOUR_KEY", model="uncensored") è sufficiente. Gli strumenti di sviluppo che accettano un endpoint compatibile con OpenAI funzionano allo stesso modo; consulta la guida su l'utilizzo di un'API per la programmazione.
HTTP grezzo: i percorsi esatti
Per curl, script e nodi HTTP che costruisci tu stesso, crei l'URL completo. Questi sono i percorsi su questo servizio:
| Scopo | Metodo e URL |
|---|---|
| Chat | POST https://api.getdeepseekapi.com/v1/chat/completions |
| API Responses | POST https://api.getdeepseekapi.com/v1/responses |
| Elenco modelli | GET https://api.getdeepseekapi.com/v1/models |
| Saldo | GET https://api.getdeepseekapi.com/v1/balance |
| Saldo, stile OpenAI | GET https://api.getdeepseekapi.com/v1/dashboard/billing/credit_grants |
curl https://api.getdeepseekapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'
Usa solo HTTPS. Lo streaming funziona con "stream": true tramite eventi inviati dal server, e lo stesso URL serve entrambe le modalità.
Inserimento dell'URL nelle app con schermata di impostazioni
Molti front-end chat, editor e strumenti di automazione hanno un'opzione "endpoint compatibile con OpenAI personalizzato". Le etichette variano, ma i campi mappano uno a uno:
| Campo nell'app | Valore |
|---|---|
| API base, Base URL, Endpoint, URL del server | https://api.getdeepseekapi.com/v1 |
| Chiave API, Token, Secret | La tua chiave API da questo servizio |
| Modello, Nome del modello, ID del modello | uncensored |
Alcune app vogliono un URL di chat completo invece di una base. In quel caso usa https://api.getdeepseekapi.com/v1/chat/completions. Se l'app ha un pulsante "test connessione", di solito chiama l'elenco dei modelli, che è GET /v1/models. Se il pulsante fallisce ma una chat manuale funziona, il controllo dell'app è più rigoroso dell'API e puoi ignorarlo.
Un rapido test di integrità del solo URL
Prima di risolvere i bug di un'app, verifica l'URL con l'elenco dei modelli. Non richiede un body e non costa nulla:
curl -s https://api.getdeepseekapi.com/v1/models -H "Authorization: Bearer $API_KEY" # the chat model ID is uncensored
Dovresti ricevere un JSON con un array data. Una pagina di errore HTML indica un host o un percorso errati, ad esempio un sottodominio mancante: l'host inizia con api., non www..
Correzione degli errori più comuni
- 404 Non trovato. Manca
/v1dall'URL di base, è presente due volte o include il percorso dell'endpoint. - 401 o un errore di autenticazione. Hai usato una chiave di un altro servizio, o l'header manca di
Bearer. Le chiavi non sono intercambiabili tra provider diversi. - Modello non trovato. La richiesta indica ancora un modello del vecchio provider. Imposta
uncensored. - L'app continua a comunicare con il vecchio servizio. Alcuni strumenti memorizzano le impostazioni nella cache o leggono una variabile diversa. Riavvia il processo e controlla la schermata delle impostazioni.
- Problema con la barra finale. La maggior parte dei client la gestisce, ma se uno non lo fa, rimuovi la barra finale dall'URL di base.
Se non sei sicuro di quale lato stia fallendo, invia il comando curl sopra. Una risposta 200 prova che l'URL, la chiave e il modello sono corretti; qualsiasi altra cosa che si rompe è nell'app. La documentazione elenca i limiti e gli header come X-Request-Id, che aiuta quando contatti il supporto.
Cosa rimane invariato dopo il passaggio
Le forme di richiesta e risposta seguono il formato OpenAI, quindi gli array di messaggi, temperature, top_p, stop, seed, le penalità, la chiamata di funzioni e la modalità JSON funzionano come al solito. La finestra di contesto è di 100.000 token per prompt più completamento, e il corpo della richiesta massimo è di 8 MB. Il servizio è solo testo: nessuna immagine, audio, embedding o fine-tuning, quindi le funzionalità basate su questi richiedono un provider diverso.
La fatturazione è separata anche dal vecchio provider: $0,15 per 1M di token di input e $0,50 per 1M di token di output dal credito prepagato, come mostrato nella pagina dei prezzi. I nuovi utenti possono richiedere $0,50 di credito di prova per verificare che il passaggio funzioni prima di pagare qualsiasi cosa.
Altre guide
Domande e risposte
Qual è l'URL di base dell'API DeepSeek?
DeepSeek lo pubblica nella sua documentazione, quindi controllalo lì per il valore corrente. L'endpoint su questo sito è un servizio diverso su https://api.getdeepseekapi.com/v1.
Posso usare una chiave DeepSeek su questo endpoint?
No. Le chiavi vengono emesse per servizio. Ottieni una chiave per questa API nella pagina delle chiavi e imposta il modello su uncensored.
L'URL di base deve terminare con /v1?
Sì per questo servizio: https://api.getdeepseekapi.com/v1. Gli SDK aggiungono il percorso dell'endpoint dopo di esso, quindi non aggiungere /chat/completions manualmente.
Perché ricevo un 404 dopo aver cambiato l'URL?
Di solito il percorso è duplicato o manca /v1. Confronta il tuo URL di base con il valore esatto sopra.
La tua chiave è a un modulo di distanza
Crea un account, copia la chiave, modifica l'URL di base. È tutta la configurazione.