API DeepSeek v4

Riferimento API completo per i modelli LLM DeepSeek v4 basati su DeepSeek.

Aggiornamenti del modello

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 originali rimangono disponibili per le integrazioni API esistenti.

Varianti del modello

Questa API supporta quattro varianti del modello DeepSeek v4:

Confronto rapido

DeepSeek v4 Pro Text to Text

Endpoint

httpCopia
POST /api/v1/chat/completions

Parametri della richiesta

Obbligatori

Supporto messaggi

Opzionali

Richiesta di esempio

javascriptCopia
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',
    messages: [
      {
        role: 'user',
        content: 'Hello'
      }
    ],
    stream: true,
    max_tokens: 500,
    top_p: 0.5,
    top_k: 1
  })
});

DeepSeek v4 Flash Text to Text

Endpoint

httpCopia
POST /api/v1/chat/completions

Parametri della richiesta

Obbligatori

Supporto messaggi

Opzionali

Richiesta di esempio

javascriptCopia
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',
    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

Endpoint

httpCopia
POST /api/v1/chat/completions

Parametri della richiesta

Obbligatori

Supporto messaggi

Opzionali

Richiesta di esempio

javascriptCopia
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',
    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

Endpoint

httpCopia
POST /api/v1/chat/completions

Parametri della richiesta

Obbligatori

Supporto messaggi

Opzionali

Richiesta di esempio

javascriptCopia
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',
    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

jsonCopia
{
  "error": {
    "code": "1001",
    "param": null,
    "message": "Authorization is empty",
    "type": "invalid_request_error"
  }
}

Best practice

1. Scegli la variante giusta: Usa i modelli Pro per un ragionamento di qualità superiore e i modelli Flash per workload 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 sampling: 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.