Introduzione
DeepSeek V4 Flash è il modello a contesto lungo e alto throughput di DeepSeek, disponibile qui come un endpoint compatibile con OpenAI su /v1/chat/completions. Una richiesta accetta fino a 1.048.576 token in ingresso in al massimo 256 messaggi e ne restituisce fino a 65.536, con il livello di ragionamento su high di default.
Il contenuto dei messaggi è solo testo. Fino a 128 tool con tool_choice, output JSON tramite response_format e streaming SSE passano nella stessa chiamata, e la fatturazione separa input, input in cache e output.
Caratteristiche principali
Un passaggio economico e uno accurato nello stesso corpo
reasoning_effort è su high di default, e low è l'impostazione per i passaggi in blocco. Cambiare costa una stringa nello stesso corpo, così una prima passata su mille record e un secondo sguardo ai quaranta che non tornavano sono la stessa integrazione.
Leggere un repository, restituire un risultato
La finestra tiene 1.048.576 token mentre una risposta arriva a 65.536. Quel rapporto è la forma del lavoro: metti dentro l'intero servizio e chiedi una review, un elenco ordinato di problemi o una patch mirata, non una riscrittura di tutto ciò che hai mandato.
JSON quando lo chiedi
Imposta response_format su json_object e nomina ogni campo nel messaggio di sistema: la stessa forma torna a ogni esecuzione. La tua applicazione analizza e valida comunque ciò che riceve prima di agire.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
messages | Sì | Battute in ordine, dalla più vecchia, al massimo 256. Contenuto solo testuale; |
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 65.536. Il valore predefinito è 32.768, che tronca in silenzio una consegna lunga. |
tools | No | Fino a 128 definizioni di funzione in una richiesta. al massimo 128 elementi |
tool_choice | No | auto, none, required oppure un oggetto che nomina una singola funzione. |
response_format | No | Chiedi un oggetto JSON quando la risposta alimenta un parser e non una persona. |
Prezzi
Input $0.44 / Output $1.32 per 1 milione di token
Casi d’uso
Review di un intero repository
Manda insieme il servizio, i suoi test e la specifica pertinente, e pretendi che ogni problema indichi file, riga e comportamento coinvolto. Con tutto il codice nel contesto, un problema può puntare a un chiamante due package più in là invece di tirare a indovinare.
Pacchetti di contratti in JSON
Invia una pila di accordi con response_format su json_object e porta le clausole analizzate direttamente in una tabella. Nomina i campi nel messaggio di sistema e lascia il livello su low per il passaggio in blocco.
Bozza economica, poi ripeti i casi difficili
Fai girare tutta la coda su low, segna i record il cui output non ha superato i tuoi controlli e rimanda solo quelli su high con lo stesso array di messaggi. Tra le due risposte è cambiato solo il campo del livello.
Consigli avanzati
Una chiamata in formato OpenAI
POST https://api.spicyapi.ai/v1/chat/completions con {"model": "deepseek/v4-flash", "messages": [{"role": "system", "content": "You review Go services. Report only defects you can point to by file and line."}, {"role": "user", "content": "<the whole service>"}], "reasoning_effort": "high", "max_tokens": 8000}. Aggiungi "stream": true per leggere i token man mano che arrivano.
Dimensiona max_tokens sul risultato
Il default di 32.768 tronca un risultato lungo senza errori, e il tetto è 65.536. Anche i token di ragionamento vengono fatturati come output, quindi lascia margine sopra la risposta visibile che ti aspetti.
Cosa rifiuta lo schema
Le parti image_url e file vengono rifiutate prima che la richiesta sia prezzata, reasoning_content è accettato solo nei messaggi assistant e la finestra di 1.048.576 token conta ogni messaggio, compresi prompt di sistema e risultati dei tool precedenti. Sui cache hit questo endpoint non costa meno del prezzo di DeepSeek stessa, quindi confronta prima di puntare su un prompt lungo che rimandi di continuo.
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-flash/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.
