Notizie sull’IA · 10 min di lettura

DeepSeek API: ricerca web, analisi file, OCR e voce, prezzi

DeepSeek porta ricerca web, analisi dei file, OCR e voce nella sua API. Scopri come funzionano le funzioni, quanto costano e quali limiti hanno.

Illustrazione di un nucleo di IA luminoso collegato da canali di luce a una lente d’ingrandimento, una pila di pagine scansionate, un’onda sonora e uno scudo

Nel Change Log del 13 novembre 2026 DeepSeek ha aperto agli sviluppatori ricerca web, ricerca con ragionamento approfondito, lettura di URL, input di file e controllo di sicurezza su deepseek-flash tramite gli endpoint Messages, Responses e Chat Completions. Ha inoltre reso disponibili API autonome per Search e Fetch, OCR, riconoscimento vocale e sintesi vocale, fatturate oltre ai token.

Che cosa ha annunciato DeepSeek il 13 novembre 2026?

DeepSeek ha pubblicato il 13 novembre 2026 nel suo Change Log ufficiale una voce intitolata «Rilascio della suite completa di API applicative», mettendo a disposizione degli sviluppatori le funzionalità della DeepSeek App e del client web. DeepSeek ha dichiarato che ricerca web, input di file, lettura di URL, interazione vocale e sicurezza operano già nell’app insieme all’inferenza del modello, aggiungendo: «Oggi apriamo queste funzionalità agli sviluppatori». Il servizio gestisce l’esecuzione degli strumenti e la composizione del contesto. DeepSeek ha condiviso il rilascio anche sul suo account X ufficiale il 13 novembre, ora di Pechino.

Il lancio comprende cinque funzionalità integrate nelle chat di deepseek-flash e quattro API di utilità autonome: Search e Fetch, OCR, riconoscimento automatico del parlato (ASR) e sintesi vocale (TTS). Segue un aggiornamento del Change Log del 17 ottobre 2026, in cui DeepSeek ha presentato la propria API di ricerca (DeepSeek Search), che secondo l’azienda indicizza centinaia di miliardi di pagine web, insieme alla versione DeepSeek-V4.1-Flash-1017 sotto il nome di modello deepseek-flash.

Per mostrare gli endpoint, DeepSeek ha pubblicato come open source un client di chat basato su browser (demo dal vivo e repository GitHub) capace di importare cronologie di chat DeepSeek esportate. DeepSeek precisa che chiavi API, conversazioni e immagini caricate rimangono nel browser e che il client serve solo a scopo dimostrativo.

Come funzionano le cinque funzionalità in chat su deepseek-flash?

Tutte e cinque le funzionalità in chat funzionano su deepseek-flash (attualmente indicato come DeepSeek-V4.1-Flash-1017 nella pagina dei prezzi di DeepSeek) attraverso tre endpoint API:

  • Messages (formato Anthropic): POST https://api.deepseek.com/anthropic/v1/messages
  • Responses: POST https://api.deepseek.com/responses
  • Chat Completions: POST https://api.deepseek.com/chat/completions

Secondo le guide Build a Chatbot e Web Tools, ogni funzionalità corrisponde a specifiche impostazioni della richiesta:

  • Ricerca web: con il ragionamento disattivato e lo strumento deepseek_web_search attivo, deepseek-flash esegue ricerche web o di immagini secondo necessità e risponde con citazioni. La ricerca di immagini si attiva automaticamente quando il messaggio dell’utente contiene immagini.
  • Ricerca con ragionamento approfondito: attivando il ragionamento insieme a deepseek_web_search, il modello cerca sul web e legge i link autonomamente in più passaggi di ragionamento, effettuando fino a circa 20 chiamate agli strumenti prima di rispondere.
  • Lettura di URL: attivare deepseek_read_url consente al modello di rilevare i link nel prompt dell’utente, recuperare le pagine e includerle nel contesto della risposta.
  • Input di file: PDF, documenti Office, immagini e altri file caricati tramite Files API vengono analizzati per il contesto con text_recognition (solo testo semplice, senza grafici e foto) oppure rich_layout_recognition (testo e figure ritagliate nelle posizioni originali).
  • Sicurezza del modello: aggiungere safety_check controlla input e output e restituisce un marcatore di rifiuto quando viene rilevato un rischio.

La guida al chatbot descrive anche marcatori opzionali di metadati dell’utente (data corrente, posizione e lingua dell’utente) e la generazione automatica dei titoli delle conversazioni tramite title. Le applicazioni client devono mostrare i blocchi di contenuto restituiti e reinviarli senza modifiche al turno successivo. Poiché DeepSeek gestisce le chiamate di ricerca e la composizione del contesto sul server, questo flusso si distingue dalla tradizionale chiamata di strumenti lato client, in cui l’applicazione esegue ogni chiamata localmente.

Come si attiva la ricerca web di DeepSeek API in una richiesta?

Gli sviluppatori attivano ricerca web DeepSeek, lettura di URL, controllo di sicurezza di livello alto e titoli automatici delle conversazioni aggiungendo questi parametri direttamente al corpo JSON di una richiesta deepseek-flash:

{
  "model": "deepseek-flash",
  "tools": [
    { "type": "deepseek_web_search" },
    { "type": "deepseek_read_url" }
  ],
  "safety_check": { "level": "high" },
  "title": { "enabled": true },
  "messages": [
    {
      "role": "user",
      "content": "Summarize the latest pricing updates on https://api-docs.deepseek.com/quick_start/pricing"
    }
  ]
}

Quando una richiesta dichiara gli strumenti web, imposta safety_check su high o attiva title, il servizio DeepSeek sovrascrive diversi parametri di campionamento e ignora valori del client come temperature e top_p. Il parametro max_tokens rimane attivo, ma limita ogni singolo passaggio di inferenza invece dell’intera ricerca a più passaggi.

API autonome DeepSeek Search, Fetch, OCR, ASR e TTS

Oltre alle funzioni di chat integrate, DeepSeek ha aperto quattro API autonome affinché gli sviluppatori possano richiamare ricerca, estrazione di pagine, OCR ed elaborazione vocale fuori da una sessione di chat.

API Search e Fetch

Come descritto nella guida Search & Fetch, POST https://api.deepseek.com/v1/tools/search interroga direttamente l’indice web di DeepSeek, mentre POST https://api.deepseek.com/v1/tools/fetch recupera una pagina web come Markdown. A differenza dello strumento in chat deepseek_web_search, la Search API autonoma non supporta ancora la ricerca di immagini.

DeepSeek OCR API

Disponibile su POST https://api.deepseek.com/v1/tools/ocr, la OCR API supporta PDF, Word, PowerPoint e i comuni formati di immagine, restituendo il testo estratto pagina per pagina. I file inviati all’endpoint OCR non vengono né archiviati da DeepSeek né passati a un modello di chat.

DeepSeek ASR (da voce a testo)

Disponibile su POST https://api.deepseek.com/v1/tools/asr, la ASR API trascrive file audio completi PCM WAV a 16 bit o Ogg Opus in un’unica richiesta, senza riconoscimento in streaming. Rileva automaticamente 21 lingue, tra cui cinese, cantonese, inglese, giapponese, coreano, tedesco, francese, spagnolo, portoghese, italiano, russo, arabo e hindi.

DeepSeek TTS (da testo a voce)

Disponibile tramite POST https://api.deepseek.com/v1/tools/tts per la sintesi del testo completo o lo streaming WebSocket, la TTS API offre due voci: stella (femminile, predefinita) e tide (maschile). Rileva automaticamente 10 lingue (mandarino, cantonese, inglese, giapponese, coreano, malese, arabo, indonesiano, thailandese e vietnamita) e produce wav per impostazione predefinita oppure pcm.

Quanto costano ricerca web, OCR e voce di DeepSeek API?

Al 15 novembre 2026 DeepSeek fattura tutte le chiamate agli strumenti e alle API autonome in aggiunta ai costi dei token del modello deepseek-flash, secondo la pagina ufficiale Models & Pricing.

Prezzi degli strumenti e delle API autonome

Voce Prezzo Unità Note
Ricerca (testo e immagini) $0.75 Per 1,000 ricerche Stesso prezzo tramite strumenti web o Search API
Recupero web $0.75 Per 1,000 recuperi Stesso prezzo tramite lettura URL o Fetch API
Analisi file e OCR API $0.225 Per 1,000 pagine Addebito per pagina analizzata
Da testo a voce (TTS) $0.45 di listino / $0.225 temporaneo Per 10,000 caratteri Sconto temporaneo del 50%
Da voce a testo (ASR) $0.116 di listino / $0.058 temporaneo Per ora di audio Sconto temporaneo del 50%

Prezzi dei token deepseek-flash (per 1M di token)

Tipo di token Fuori picco Picco
Input (cache hit) $0.003 $0.006
Input (cache miss) $0.15 $0.30
Output $0.60 $1.20

deepseek-flash supporta una finestra di contesto di 1M di token e fino a 384K token in output. I prezzi dei token fuori picco sono la metà delle tariffe di picco. Le ore di picco vanno da lunedì a venerdì dalle 01:00 alle 04:00 UTC e dalle 06:00 alle 10:00 UTC, escluse le festività cinesi; tutte le altre ore e i fine settimana usano le tariffe fuori picco. DeepSeek non ha annunciato una data di fine per lo sconto del 50% su TTS e ASR e afferma che i prezzi possono variare ed essere modificati. Per un confronto più ampio delle tariffe dei token tra fornitori, consulta il nostro confronto dei prezzi delle API di IA.

Quali regole di fatturazione sorprendono di più gli sviluppatori?

Il modello di fatturazione di DeepSeek lega i costi alle singole sottoquery, ai recuperi riusciti, alle pagine caricate e ai token di revisione della sicurezza, anziché alle semplici chiamate agli endpoint:

  • La ricerca è fatturata per query, non per chiamata allo strumento: una chiamata a deepseek_web_search con tre query di ricerca conta come tre ricerche fatturate. Per la ricerca di immagini, ogni immagine conta come una ricerca, più un’altra per ogni regione selezionata dal modello.
  • Risultati falliti e vuoti sono gratuiti: ricerche fallite, risultati vuoti, timeout e link non recuperati non comportano costi. Le richieste autonome Search e Fetch sono fatturate solo per risposte HTTP 200 con risultati non vuoti, indipendentemente dal numero di risultati o dai token della pagina.
  • La riapertura nella ricerca con ragionamento approfondito è gratuita: durante il ragionamento a più passaggi, una pagina viene fatturata solo quando viene recuperata dal web. Riaprire una pagina recuperata, navigarla o cercarvi del testo non comporta costi aggiuntivi di recupero.
  • I controlli di sicurezza sono fatturati come token di output: i token usati per la revisione di sicurezza sono riportati come safety_tokens e fatturati alle tariffe dei token di output.
  • L’analisi dei file è fatturata una volta al caricamento: l’analisi dei documenti viene addebitata per pagina una volta completato il caricamento; i turni di chat successivi che fanno riferimento al file pagano le tariffe standard dei token di input.
  • Fatturazione vocale: ASR fattura la durata dell’audio al secondo.

Limiti principali, controlli di sicurezza e obblighi di conformità

DeepSeek applica limiti rigorosi ai payload, restrizioni sugli strumenti e avvertenze sulla conformità per i nuovi endpoint.

Limiti tecnici e di concorrenza

  • Strumenti web: allowed_domains, blocked_domains e user_location non sono supportati su deepseek_web_search. Altri strumenti server non possono ancora essere combinati con deepseek_web_search, deepseek_read_url, safety_check o title. La ricerca con ragionamento approfondito si arresta dopo circa 20 chiamate agli strumenti.
  • Analisi dei file e OCR: entrambi limitano i file a 100 MiB e 1,000 pagine. L’analisi dei file impone un limite di caricamento di 120 secondi, un limite di analisi di 120 secondi e 15 caricamenti simultanei per account; file originali e risultati analizzati non possono essere scaricati. OCR autonomo consente 180 secondi in totale.
  • ASR e TTS: ASR limita i file a 8 MiB e 120 secondi, con fino a 50 richieste simultanee per account. TTS limita le richieste a 10,000 caratteri fatturati e non supporta il controllo della velocità.

Controlli di sicurezza del modello e conformità dei servizi pubblici

Per impostazione predefinita, l’API esegue controlli di sicurezza di livello low. Impostare safety_check su {"level": "high"} attiva la revisione di Model Content Safety sia sugli input (inclusi i risultati degli strumenti) sia sugli output. Le violazioni restituiscono 400 Content Exists Risk o terminano la risposta con un rifiuto (stop_reason "refusal" in Messages; finish_reason "content_filter" in Chat Completions). Poiché i token già trasmessi non possono essere ritirati, i client devono sostituire il testo trasmesso con un proprio messaggio di rifiuto quando ne arriva uno.

DeepSeek indica agli operatori che offrono servizi al pubblico di attivare safety_check e adempiere agli obblighi relativi a revisione della sicurezza dei contenuti, registrazione dei modelli di grandi dimensioni ed etichettatura dell’IA. DeepSeek precisa che safety_check aiuta la conformità senza sostituire gli obblighi del fornitore di revisionare i contenuti.

Quando usare gli strumenti web in chat o Search e Fetch autonomi?

La scelta tra gli strumenti web in chat di DeepSeek e le sue API autonome Search e Fetch dipende dal fatto che si voglia affidare il recupero a DeepSeek o al proprio codice. Usa deepseek_web_search e deepseek_read_url in deepseek-flash quando crei assistenti conversazionali che beneficiano di orchestrazione della ricerca gestita dal server, ricerca di immagini, ragionamento approfondito a più passaggi e citazioni automatiche.

Usa gli endpoint autonomi /v1/tools/search e /v1/tools/fetch per creare pipeline personalizzate di generazione aumentata dal recupero (RAG) che richiedono un proprio filtro dei domini, la suddivisione in blocchi o la selezione di un modello successivo sugli estratti di pagine Markdown. Anche OCR, ASR e TTS autonomi sono adatti a pipeline modulari in cui file o audio non appartengono allo stato della chat.

FAQ

Quali modelli DeepSeek supportano ricerca web e lettura di URL?

La documentazione DeepSeek indica deepseek-flash (attualmente indicato come DeepSeek-V4.1-Flash-1017 nella pagina dei prezzi) per gli endpoint Messages, Responses e Chat Completions. Le guide non indicano il supporto per altri ID di modello, quindi gli sviluppatori che necessitano di ricerca web gestita dal server, ricerca con ragionamento approfondito, lettura di URL, input di file e controlli di sicurezza dovrebbero usare deepseek-flash.

Si può limitare la ricerca web DeepSeek a domini specifici?

No. La guida Web Tools di DeepSeek conferma che allowed_domains, blocked_domains e user_location non sono supportati su deepseek_web_search. Se servono elenchi rigorosi di domini consentiti o bloccati, richiama l’API autonoma /v1/tools/search, filtra gli URL restituiti nel tuo backend e recupera le pagine approvate con /v1/tools/fetch.

Le ricerche fallite o gli URL irraggiungibili sono fatturati su DeepSeek API?

No. DeepSeek fattura la ricerca web solo quando una query restituisce risultati e la lettura di URL solo quando una pagina viene recuperata correttamente. Nelle API autonome Search e Fetch, timeout, richieste fallite e risultati vuoti non comportano costi; solo le risposte HTTP 200 con payload non vuoti sono fatturate a $0.75 per 1,000 richieste.

Quanto durerà lo sconto DeepSeek del 50% su TTS e ASR?

La pagina Models & Pricing di DeepSeek indica uno sconto temporaneo del 50% che porta TTS a $0.225 per 10,000 caratteri e ASR a $0.058 per ora di audio, senza specificare una data di fine. DeepSeek afferma anche che i prezzi possono variare e si riserva il diritto di modificare le tariffe API pubblicate.

Attivare safety_check soddisfa da solo le regole per i servizi pubblici di IA?

No. DeepSeek afferma che gli operatori che offrono un servizio al pubblico devono attivare safety_check e adempiere agli obblighi relativi alla revisione della sicurezza dei contenuti, alla registrazione dei modelli di grandi dimensioni e all’etichettatura dell’IA. La documentazione specifica che il parametro aiuta la conformità senza sostituire le responsabilità del fornitore di revisionare i contenuti.

Fonti

Scritto da

Chunyu Cai

Chunyu Cai è l’amministratore delegato di Lotook, LLC e un imprenditore che scrive di modelli di IA, agenti e di come cambiano il lavoro quotidiano. Chunyu Cai ha conseguito un master presso Imperial College London.