Introduzione
DeepSeek V4 Pro è la metà riflessiva della coppia DeepSeek V4, disponibile qui come un endpoint compatibile con OpenAI su /v1/chat/completions. Legge fino a 1.048.576 token, ragiona su high di default e può scrivere una singola risposta fino a 384.000 token.
Il livello low serve per le bozze rapide. Il contenuto dei messaggi è solo testo, fino a 256 messaggi per richiesta; hai fino a 128 tool, output JSON tramite response_format e streaming SSE, e input, input in cache e output sono misurati separatamente.
Caratteristiche principali
high come punto di partenza
Review, migrazioni e sicurezza sono i lavori in cui il ragionamento in più rende, quindi questo endpoint parte da high e lascia low alle bozze. Il ragionamento si paga in token di output: finisce sulla stessa fattura e conta sullo stesso max_tokens che imposti, non su una tariffa a parte.
Specifica, codice e test in una richiesta
Con 1.048.576 token il documento di progetto, l'implementazione e la suite di test viaggiano insieme, e il modello li confronta invece di fidarsi del tuo riassunto. Metti i vincoli invarianti nel messaggio di sistema e il materiale sotto, dal più vecchio, così ogni divergenza è ancorata a qualcosa che il modello può citare.
Spazio per scrivere tutta la risposta
Una risposta può arrivare a 384.000 token: un piano ordinato, l'SQL di ogni passo e le query che lo verificano stanno in una sola risposta. Il default di 32.768 tronca senza errori, quindi dimensiona max_tokens sul risultato.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
messages | Sì | Al massimo 256 turni ordinati, con contenuto solo testo. Rimanda indietro |
reasoning_effort | No | none, low o high, high come predefinito. |
stop | No | Fino a 4 sequenze, come stringa o come array. La risposta si ferma appena il modello ne scrive una, e il testo corrispondente non viene restituito. almeno 1 caratteri · almeno 1 elementi · al massimo 4 elementi |
max_tokens | No | Limita la risposta a 384.000. Il valore predefinito di 32.768 tronca un piano di migrazione senza dare errore. |
tools | No | Fino a 128 definizioni di funzione per richiesta. al massimo 128 elementi |
parallel_tool_calls | No | true o false, predefinito true: il modello può chiedere più chiamate agli strumenti nello stesso turno. Predefinito: |
tool_choice | No | auto, none, required, oppure un oggetto che nomina la funzione da chiamare. |
response_format | No | Richiedi un oggetto JSON quando la risposta viene consumata dal codice. |
Prezzi
Input $1.32 / Output $3.96 per 1 milione di token
Casi d’uso
Audit tra specifica e implementazione
Manda in una richiesta il documento di progetto e il codice che dice di implementarlo, e chiedi ogni divergenza ordinata per impatto. Nessuna delle due parti va riassunta, così un invariante mancante emerge dal confronto e non dalla memoria.
Passaggi di sicurezza su high
Punta il livello high su un percorso di autenticazione o su un flusso di movimenti di denaro e chiedi sequenze sfruttabili, non note di stile. Il ragionamento in più costa token di output; lasciarsi sfuggire un'escalation di privilegi costa molto di più.
Pianificare una migrazione su tutto uno schema
Dai al modello ogni file di migrazione e le definizioni attuali delle tabelle, e chiedi un piano ordinato con il rollback di ogni passo. Piano, SQL e query di verifica possono tornare insieme in una sola risposta.
Consigli avanzati
Scrivi il test di accettazione nel messaggio di sistema
Il livello high è sprecato su una richiesta vaga. Specifica cosa deve contenere una risposta corretta – divergenze con riferimenti ai file, un elenco ordinato, un rollback per passo – prima di incollare il materiale, così il modello verifica rispetto a qualcosa.
Una chiamata con il livello che il compito merita
POST https://api.spicyapi.ai/v1/chat/completions con {"model": "deepseek/v4-pro", "messages": [{"role": "system", "content": "Compare the specification against the implementation. List every divergence with file references, then rank by blast radius."}, {"role": "user", "content": "<spec>\n\n<implementation>"}], "reasoning_effort": "high", "max_tokens": 32000}. Verifica di persona il problema in cima alla classifica prima di agire: high è più scrupoloso, non infallibile.
Forme di richiesta che falliscono
Lo schema rifiuta le parti image_url e file, quindi un corpo copiato da un modello multimodale fallisce prima di essere prezzato. Un max_tokens oltre 384.000 non è valido, e la finestra di 1.048.576 token comprende il prompt di sistema e ogni risultato dei tool precedente.
Avvio rapido dell’API
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "deepseek/v4-pro/chat",
"messages": [
{
"role": "user",
"content": "Summarise the following release notes into three bullet points."
}
],
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
