# API DeepSeek v4 Riferimento API completo per i modelli LLM DeepSeek v4 basati su DeepSeek. ## Aggiornamenti del modello ### DeepSeek v4 Pro 0813 - Flaq AI ha aggiornato DeepSeek v4 Pro alla release ufficiale `deepseek-v4-pro-0813` di DeepSeek. - Usa gli ID modello `0813` riportati di seguito per accedere alla versione ufficiale. - Gli ID modello Pro originali non sono disponibili. | Variante | ID modello 0813 | ID modello non disponibile | |----------|-----------------|----------------------------| | Da testo a testo | `deepseek-v4-pro-text-to-text-0813` | `deepseek-v4-pro-text-to-text` | | Ricerca web | `deepseek-v4-pro-web-search-0813` | `deepseek-v4-pro-web-search` | ### DeepSeek v4 Flash 0731 - Flaq AI ha aggiornato DeepSeek v4 Flash alla release ufficiale `deepseek-v4-flash-0731` di DeepSeek. - Usa gli ID modello `0731` riportati di seguito per accedere alla versione aggiornata. - Gli ID modello Flash originali non sono disponibili. | Variante | ID modello 0731 | ID modello non disponibile | |----------|-----------------|----------------------------| | Da testo a testo | `deepseek-v4-flash-text-to-text-0731` | `deepseek-v4-flash-text-to-text` | | Ricerca web | `deepseek-v4-flash-web-search-0731` | `deepseek-v4-flash-web-search` | ## Varianti del modello Questa API supporta quattro varianti del modello DeepSeek v4: | Modello | ID | Descrizione | |-------|----|-------------| | **DeepSeek v4 Pro Text to Text** | `deepseek-v4-pro-text-to-text-0813` | Ragionamento e scrittura testuale di alta qualità | | **DeepSeek v4 Flash Text to Text** | `deepseek-v4-flash-text-to-text-0731` | Generazione di testo più rapida e più conveniente | | **DeepSeek v4 Pro Web Search** | `deepseek-v4-pro-web-search-0813` | Risposte consapevoli del web con ragionamento DeepSeek v4 Pro | | **DeepSeek v4 Flash Web Search** | `deepseek-v4-flash-web-search-0731` | Risposte web-aware più rapide con DeepSeek v4 Flash | ## Confronto rapido | Funzionalità | Pro Text to Text | Flash Text to Text | Pro Web Search | Flash Web Search | |---------|------------------|------------|----------------|------------------| | Input di testo | Obbligatorio ✅ | Obbligatorio ✅ | Obbligatorio ✅ | Obbligatorio ✅ | | Input immagine | Non supportato ❌ | Non supportato ❌ | Non supportato ❌ | Non supportato ❌ | | Input file | Non supportato ❌ | Non supportato ❌ | Non supportato ❌ | Non supportato ❌ | | Web search | Non supportato ❌ | Non supportato ❌ | Abilitato ✅ | Abilitato ✅ | | Risposta streaming | SSE | SSE | SSE | SSE | | `max_tokens` | Opzionale | Opzionale | Opzionale | Opzionale | | `top_p` | Opzionale | Opzionale | Opzionale | Opzionale | | `top_k` | Opzionale | Opzionale | Opzionale | Opzionale | ## DeepSeek v4 Pro Text to Text ### Punto di accesso ```http POST /api/v1/chat/completions ``` ### Parametri della richiesta #### Obbligatori | Parametro | Tipo | Descrizione | |-----------|------|-------------| | `model` | string | Deve essere `"deepseek-v4-pro-text-to-text-0813"` | | `messages` | array | Messaggi ordinati solo testuali. Supporta i ruoli `system`, `user` e `assistant`. Consulta la LLM API per la struttura del messaggio. | | `stream` | boolean | `true` per SSE, `false` per una singola risposta JSON. | #### Supporto messaggi | Campo | Testo | File | Immagine | |-------|------|------|-------| | `messages` | Obbligatorio ✅ | Non supportato ❌ | Non supportato ❌ | #### Opzionali | Parametro | Tipo | Intervallo | Descrizione | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Numero massimo di token in output. | | `top_p` | number | `0.0` - `1.0` | Limita la massa di probabilità cumulativa dei token candidati. | | `top_k` | integer | `0` - `100` | Limita il numero di token candidati. | ### Richiesta di esempio ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'text/event-stream', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'deepseek-v4-pro-text-to-text-0813', messages: [ { role: 'user', content: 'Hello' } ], stream: true, max_tokens: 500, top_p: 0.5, top_k: 1 }) }); ``` ## DeepSeek v4 Flash Text to Text ### Punto di accesso ```http POST /api/v1/chat/completions ``` ### Parametri della richiesta #### Obbligatori | Parametro | Tipo | Descrizione | |-----------|------|-------------| | `model` | string | Deve essere `"deepseek-v4-flash-text-to-text-0731"` | | `messages` | array | Messaggi ordinati solo testuali. Supporta i ruoli `system`, `user` e `assistant`. Consulta la LLM API per la struttura del messaggio. | | `stream` | boolean | `true` per SSE, `false` per una singola risposta JSON. | #### Supporto messaggi | Campo | Testo | File | Immagine | |-------|------|------|-------| | `messages` | Obbligatorio ✅ | Non supportato ❌ | Non supportato ❌ | #### Opzionali | Parametro | Tipo | Intervallo | Descrizione | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Numero massimo di token in output. | | `top_p` | number | `0.0` - `1.0` | Limita la massa di probabilità cumulativa dei token candidati. | | `top_k` | integer | `0` - `100` | Limita il numero di token candidati. | ### Richiesta di esempio ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'application/json', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'deepseek-v4-flash-text-to-text-0731', messages: [ { role: 'user', content: 'Write a four-line modern poem about a programmer drinking coffee.' } ], stream: false, max_tokens: 500, top_p: 0.5, top_k: 1 }) }); ``` ## DeepSeek v4 Pro Web Search ### Punto di accesso ```http POST /api/v1/chat/completions ``` ### Parametri della richiesta #### Obbligatori | Parametro | Tipo | Descrizione | |-----------|------|-------------| | `model` | string | Deve essere `"deepseek-v4-pro-web-search-0813"` | | `messages` | array | Messaggi ordinati solo testuali. Supporta i ruoli `system`, `user` e `assistant`. Consulta la LLM API per la struttura del messaggio. | | `stream` | boolean | `true` per SSE, `false` per una singola risposta JSON. | #### Supporto messaggi | Campo | Testo | File | Immagine | |-------|------|------|-------| | `messages` | Obbligatorio ✅ | Non supportato ❌ | Non supportato ❌ | #### Opzionali | Parametro | Tipo | Intervallo | Descrizione | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Numero massimo di token in output. | | `top_p` | number | `0.0` - `1.0` | Limita la massa di probabilità cumulativa dei token candidati. | | `top_k` | integer | `0` - `100` | Limita il numero di token candidati. | ### Richiesta di esempio ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'text/event-stream', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'deepseek-v4-pro-web-search-0813', messages: [ { role: 'user', content: 'What date is it today?' } ], stream: true, max_tokens: 500, top_p: 0.5, top_k: 1 }) }); ``` ## DeepSeek v4 Flash Web Search ### Punto di accesso ```http POST /api/v1/chat/completions ``` ### Parametri della richiesta #### Obbligatori | Parametro | Tipo | Descrizione | |-----------|------|-------------| | `model` | string | Deve essere `"deepseek-v4-flash-web-search-0731"` | | `messages` | array | Messaggi ordinati solo testuali. Supporta i ruoli `system`, `user` e `assistant`. Consulta la LLM API per la struttura del messaggio. | | `stream` | boolean | `true` per SSE, `false` per una singola risposta JSON. | #### Supporto messaggi | Campo | Testo | File | Immagine | |-------|------|------|-------| | `messages` | Obbligatorio ✅ | Non supportato ❌ | Non supportato ❌ | #### Opzionali | Parametro | Tipo | Intervallo | Descrizione | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Numero massimo di token in output. | | `top_p` | number | `0.0` - `1.0` | Limita la massa di probabilità cumulativa dei token candidati. | | `top_k` | integer | `0` - `100` | Limita il numero di token candidati. | ### Richiesta di esempio ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'text/event-stream', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'deepseek-v4-flash-web-search-0731', messages: [ { role: 'user', content: 'What date is it today?' } ], stream: true, max_tokens: 500, top_p: 0.5, top_k: 1 }) }); ``` ## Formato della risposta I modelli LLM DeepSeek V4 restituiscono risposte di completamento compatibili con OpenAI. Con `stream: true`, la risposta viene trasmessa tramite eventi inviati dal server (SSE); con `stream: false`, viene restituita come un singolo oggetto JSON. ### Risposta di errore ```json { "error": { "code": "1001", "param": null, "message": "Authorization is empty", "type": "invalid_request_error" } } ``` ## Buone pratiche 1. **Scegli la variante giusta:** Usa i modelli Pro per un ragionamento di qualità superiore e i modelli Flash per carichi di lavoro con latenza e costi inferiori. 2. **Usa Web Search per gli eventi attuali:** Scegli Pro o Flash Web Search quando la risposta dipende da informazioni online aggiornate. 3. **Regola con attenzione i parametri di campionamento:** `top_p` e `top_k` sono supportati da tutte le varianti DeepSeek v4 e possono modificare la diversità dell'output. 4. **Invia solo input supportati:** Non inviare parti file o immagine a nessuna route DeepSeek v4. 5. **Allinea Accept alla modalità stream:** Usa `Accept: text/event-stream` per le richieste streaming e `Accept: application/json` per quelle non streaming.