Après l’ouverture des outils de l’app DeepSeek le 13 novembre, comment le JSON deepseek-flash déclare-t-il deepseek_web_search, deepseek_read_url et safety_check, et comment facturer tool_search à part des jetons ?

L’identifiant du modèle n’active pas la recherche. tools, thinking et safety_check décident du JSON. Le compte facturé est tool_search.

Mettre model à deepseek-flash n’active pas la recherche. Le 13 novembre 2026, DeepSeek a ouvert sur l’API les outils derrière son app de chat. L’id deepseek-flash est DeepSeek-V4.1-Flash-1017. Les anciens ids deepseek-v4-flash et deepseek-v4-flash-vision-exp y aboutissent encore et sont facturés au prix Flash. Le contexte fait 1 000 000 de jetons. La sortie maximale fait 384 000. La réflexion est le défaut.

Cette page est datée du 16 novembre 2026, d’après le journal du 13 novembre, le guide des outils web, le guide Search et Fetch, le guide de sûreté et la page de prix. Il y a trois jours, nous avons couvert l’usage de Gemini 4 Carbon. Ici, les champs qui changent la requête et la facture sont tools, thinking, safety_check et usage.server_tool_use.

Ce qui s’est ouvert le 13 novembre

Le même modèle accepte les outils sur trois points d’accès. Messages est POST https://api.deepseek.com/anthropic/v1/messages avec x-api-key. Responses est POST https://api.deepseek.com/responses. Chat Completions est POST https://api.deepseek.com/chat/completions. Les deux derniers envoient Authorization: Bearer. Search, Fetch, OCR, ASR et TTS existent aussi en appels autonomes. La recherche d’images n’est pas sur POST /v1/tools/search. Elle ne tourne que dans deepseek_web_search.

CapacitéJSON qui l’activeCe qui revient
Recherche webdeepseek_web_search, réflexion coupéeLe modèle cherche quand il le juge utile et cite
Recherche en réflexiondeepseek_web_search, réflexion activesearch, open_page, find_in_page, environ 20 appels
Lecture d’URLdeepseek_read_urlLiens du dernier message utilisateur, au plus les 10 premières URL distinctes
Sûretésafety_check.level = highRevue de l’entrée et de la sortie. Requis pour un service public
Fichiersfile_id de l’API FilesPDF, Office et images analysés avant le tour de chat

Le JSON de requête sur trois points d’accès

Messages nomme chaque outil deux fois, type et name. Responses et Chat n’envoient que type. tool_choice ne peut pas nommer ces outils. Cela renvoie 400, deepseek_web_search cannot be forced. tool_choice none coupe chaque outil web déclaré, y compris la lecture d’URL. Sur Responses et Chat, required est traité comme auto.

N’envoyez pas allowed_domains, blocked_domains ni user_location. Ne déclarez pas le même outil deux fois. Ne mélangez pas un autre outil serveur. L’erreur dit que d’autres outils ne peuvent pas encore être utilisés avec deepseek_web_search, deepseek_read_url, safety_check ou title. Sur Responses, un outil web_search et un text.format autre que text renvoient 400. Sur Chat, web_search_options et un response_format autre que text renvoient 400. Le JSON structuré et ces outils web ne partagent pas une requête. Mettez votre schéma sur un appel suivant. Voir ce qu’est une sortie structurée.

Réflexion coupée : recherche avec citations. Réflexion active : recherche profonde. Si les deux sont actifs, le tour n’exécute pas deepseek_read_url. Les liens sont lus quand la réflexion est coupée, ou quand seul deepseek_read_url est déclaré. Messages et Chat mettent thinking.type à disabled ou enabled. L’exemple Responses de la recherche profonde met reasoning.effort à high.

{
  "model": "deepseek-flash",
  "thinking": {
    "type": "disabled"
  },
  "safety_check": {
    "level": "high"
  },
  "tools": [
    {
      "type": "deepseek_web_search",
      "name": "deepseek_web_search"
    },
    {
      "type": "deepseek_read_url",
      "name": "deepseek_read_url"
    }
  ],
  "messages": [
    {
      "role": "user",
      "content": "What changed in the DeepSeek API on 13 November 2026?"
    }
  ]
}

Responses, recherche avec réflexion :

{
  "model": "deepseek-flash",
  "reasoning": {
    "effort": "high"
  },
  "safety_check": {
    "level": "high"
  },
  "tools": [
    {
      "type": "deepseek_web_search"
    },
    {
      "type": "deepseek_read_url"
    }
  ],
  "input": "Which official page states the height of Tokyo Tower?"
}

Blocs, kind et citations

Sur Messages, chaque appel est un bloc server_tool_use plus un résultat. Associez-les par tool_use_id. En flux, les deux blocs arrivent entiers dans content_block_start. Lisez l’usage final dans message_delta. L’usage de message_start ne couvre que la première étape d’inférence.

input.actionnamekindRésultat
searchdeepseek_web_searchdeep_search pendant la réflexion, sinon searchweb_search_tool_result
open_pagedeepseek_web_searchdeep_searchweb_fetch_tool_result. data est une chaîne vide. Pas de signature
find_in_pagedeepseek_web_searchdeep_searchMême forme. title est null. Non facturé
read_linkdeepseek_read_urlread_linkweb_fetch_tool_result plus signature

La recherche d’images met kind à image_search ou deep_image_search. queries est un tableau vide. Un résultat peut ajouter image_url pour l’affichage seulement. Les citations Messages sont sur les blocs text, type web_search_result_location. cited_text est le texte de réponse de ce bloc, pas une citation de la page. encrypted_index est toujours une chaîne vide. Une URL au plus par bloc. En flux, elles arrivent en citations_delta.

Responses place l’appel dans un web_search_call avec kind et action. La réponse est un output_text annoté url_citation. start_index et end_index comptent des points de code Unicode. Chat place les appels dans message.server_tool_calls. Chaque étape a reasoning_content et calls. message.content n’a pas de marqueurs de citation. Les citations sont dans message.annotations. message.reasoning_content n’est que la dernière étape.

Une réponse qui a utilisé ces outils ne peut pas être poursuivie. L’API renvoie 400 et demande de renvoyer la requête précédente. Au tour suivant, repassez le contenu assistant inchangé, y compris kind et signature. Les extraits de recherche et la réflexion antérieure ne reviennent pas dans le contexte. Seul le texte de réponse. Une page lue revient depuis signature. Pour read_link, data est toujours vide. Sans signature, la requête réussit encore, mais la page a disparu. Les codes d’échec sont url_not_accessible, url_not_allowed et unavailable. url_not_allowed couvre aussi une page refusée par la revue de sûreté.

Un élément de recherche Responses :

{
  "type": "web_search_call",
  "id": "srvtoolu_s_00_3f2a9c",
  "status": "completed",
  "kind": "search",
  "action": {
    "type": "search",
    "queries": [
      "DeepSeek API 13 November 2026"
    ],
    "sources": [
      {
        "type": "url",
        "url": "https://example.com/news",
        "title": "Change log",
        "snippet": "Web search and URL reading are now API tools.",
        "published_at": "2026-11-13T00:00:00+00:00"
      }
    ]
  }
}

JSON Search et Fetch autonomes

Quand c’est votre code, et non le modèle, qui décide de chercher, appelez les API JSON brutes. Search est POST https://api.deepseek.com/v1/tools/search. query est obligatoire, 1 à 128 caractères, pas seulement des espaces. count va de 1 à 50 et vaut 10 par défaut. ori_question est facultatif, également 1 à 128 caractères. localization est une IP facultative. need_content vaut false par défaut. Les champs inconnus sont ignorés. Opérateurs transmis tels quels : site:, -site:, -, -"...", "...", lang:, after: et before:.

{
  "query": "DeepSeek site:api-docs.deepseek.com after:2026-11-01",
  "count": 10,
  "need_content": false
}

Fetch est POST https://api.deepseek.com/v1/tools/fetch. Le seul champ est url, 8 192 caractères au plus, HTTP ou HTTPS, avec un hôte et sans nom d’utilisateur ni mot de passe. Le corps est title et content en Markdown. Un titre absent est une chaîne vide.

{
  "url": "https://api-docs.deepseek.com/updates"
}
ChampCe qu’il faut garder
rerank_score0 à 3. 1,5 et plus est la bande de haute qualité du guide
authority0 à 4. −1 veut dire inconnu. 3 et plus est très autoritaire
snippet / summaryCourt pour l’interface, long pour le modèle
contentVide si need_content n’est pas true, ou si la page n’a pas de contenu
dateRFC 3339 en UTC, ou null

file_id, OCR et JSON vocal

L’entrée fichier se fait en deux temps. POST https://api.deepseek.com/files, purpose avant file. text_recognition laisse tomber les graphiques. rich_layout_recognition découpe les figures dans le texte et dépense des jetons d’image. L’objet fichier ne revient qu’après l’analyse. id ressemble à file-api-.... Une déconnexion n’annule pas une analyse qui réussit ensuite : le fichier est stocké et facturé. Ni l’original ni l’analyse ne se téléchargent. Chat Completions le référence ainsi :

{
  "role": "user",
  "content": [
    {
      "type": "file",
      "file_id": "file-api-xxxxxxxxxxxxxxxx"
    },
    {
      "type": "text",
      "text": "Summarize the revenue chart."
    }
  ]
}

Messages exige l’en-tête anthropic-beta: files-api-2025-04-14 et un bloc document dont source.type est file. Responses utilise input_file et file_id. Un document analysé ne peut pas être envoyé comme bloc image. On ne colle pas les octets ni une URL de fichier dans la requête de chat. Une requête cite au plus 20 documents et 8 Mio de texte. L’analyse complète reste dans le contexte aux tours suivants. Trop long : 400. Rien n’est tronqué en silence.

Limites : PDF, Word, PowerPoint et images courantes, format lu dans les octets. 100 Mio, sinon 413. 1 000 pages. 120 secondes pour l’envoi, sinon 408. 120 secondes pour l’analyse, sinon 504. 15 envois de documents en cours par compte. Les fichiers protégés par mot de passe renvoient 400. Texte brut, csv, json, code source, xlsx, xls, epub et mobi utilisent purpose user_data et ne sont pas facturés à la page. Ces fichiers plafonnent à 32 Mio, le texte à 8 Mio. AZW3 et les livres avec DRM ne sont pas pris en charge.

L’analyse coûte 0,225 $ pour 1 000 pages, une fois, seulement si elle réussit. Les tours de chat suivants facturent les jetons d’entrée, pas à nouveau les pages. L’OCR a le même prix à la page sur POST /v1/tools/ocr et n’entre pas dans l’API Files. C’est du multipart, file plus purpose, pas un corps JSON. L’ASR est de l’audio multipart, pas du JSON. Le TTS est du JSON, POST /v1/tools/tts :

Le prix catalogue du TTS est 0,45 $ pour 10 000 caractères, le prix limité publié est 0,225 $. Un caractère chinois compte pour 2. Tout autre caractère compte pour 1. Les voix sont stella (défaut) et tide. Il n’y a pas de champ de langue. Le prix catalogue de l’ASR est 0,116 $ par heure d’audio, prix limité 0,058 $, facturé à la seconde, une fraction arrondie à 1 seconde. La page de prix ne donne pas de date de fin pour le demi-tarif.

{
  "text": "Hello from DeepSeek.",
  "voice_id": "stella",
  "format": "wav",
  "filter_markdown": true
}

safety_check et JSON de refus

Pour un service que le public peut atteindre, mettez safety_check à {"level":"high"}. low équivaut à omettre le champ. Tout autre niveau renvoie 400. Le paramètre ne remplace pas vos propres obligations de revue, d’enregistrement ou d’étiquetage. Une entrée refusée renvoie 400 Content Exists Risk. Ces jetons d’entrée sont quand même facturés, au prix du cache touché. Après le modèle, la connexion reste ouverte pendant la revue de la sortie. Le texte déjà diffusé ne se retire pas. Remplacez ce que vous avez affiché. Les jetons consommés avant le refus sont facturés. Les jetons de revue sont dans les jetons de sortie et aussi dans usage.output_tokens_details.safety_tokens pour Messages et Responses, ou usage.completion_tokens_details.safety_tokens pour Chat. Une image bloquée peut nommer un chemin comme messages.1.content.0, dans stop_details.explanation, un contenu de refus, ou message.refusal. Une requête avec les outils web et sans safety_check peut quand même finir en refus.

APIJSON du refus
Messagesstop_reason refusal, stop_details.type refusal. Hors flux, la réflexion et le texte de réponse partent, les blocs d’outils et un bloc text vide restent
Responsesstatus incomplete, incomplete_details.reason content_filter. output ne garde que les web_search_call exécutés
Chatfinish_reason content_filter. content est une chaîne vide. annotations est omis. server_tool_calls reste, la réflexion de chaque étape est vidée

Facturer tool_search, pas web_search_requests

Facturez les jetons et les outils sur des lignes séparées. Les prix Flash sont pour 1 000 000 de jetons. Les heures de pointe sont 01:00–04:00 et 06:00–10:00 UTC, du lundi au vendredi, hors jours fériés chinois. Toute autre heure est creuse, y compris les week-ends et les jours fériés chinois toute la journée. Le creux vaut la moitié de la pointe. cache_creation_input_tokens reste à 0.

FenêtreCache touché / 1MCache manqué / 1MSortie / 1M
Creux$0.003$0.15$0.60
Pointe$0.006$0.30$1.20

La recherche et le fetch web coûtent 0,75 $ pour 1 000 usages réussis, que le modèle ait appelé l’outil ou que vous ayez appelé /v1/tools/search ou /v1/tools/fetch. Une recherche d’outil qui renvoie des résultats est facturée par requête : trois requêtes comptent pour trois. count ne change pas le prix de l’API Search. Un HTTP 200 avec un tableau results vide n’est pas facturé. Fetch n’est facturé que si le contenu de la page revient. Une page que la sûreté remplace ensuite par url_not_allowed ou unavailable a quand même été lue, donc elle est facturée. Rouvrir la même page pendant la recherche profonde est gratuit. find_in_page est gratuit.

Search est limité à 100 requêtes par seconde et par compte. Fetch à 25, plus un plafond par domaine. Les plafonds sont par compte, pas par clé, et séparés de la concurrence Flash de 2 500. Dans le guide, une recherche citée à deux requêtes rapporte web_search_requests 1 et tool_search 2. Stockez tool_search, tool_fetch et tool_image_search. N’ajoutez pas web_search_requests. Sur Responses et Chat, server_tool_use omet ce trio quand les trois valent 0.

Si la génération échoue alors que le statut HTTP est déjà 200, le corps est une erreur plus usage. Le flux Messages se termine par un événement error, sans message_delta après. Vérifiez le corps. Un SDK ne lève pas sur le statut 200. L’exemple publié de cette recherche à deux requêtes. thinking_tokens et safety_tokens ne sont pas sur cet objet. Ils apparaissent à part quand la réflexion est active, ou quand safety_check vaut high, et ils sont déjà dans output_tokens :

{
  "input_tokens": 1905,
  "cache_creation_input_tokens": 0,
  "cache_read_input_tokens": 0,
  "output_tokens": 72,
  "service_tier": "standard",
  "server_tool_use": {
    "web_search_requests": 1,
    "web_fetch_requests": 0,
    "tool_search": 2,
    "tool_fetch": 0,
    "tool_image_search": 0
  }
}

JSON à vérifier avant la mise en ligne

  1. Le corps a deepseek-flash. Les outils Messages ont type et name. La réflexion est disabled si vous vouliez la recherche avec citations.
  2. Une app publique envoie safety_check.level high. response_format et text.format restent text sur ces appels.
  3. L’analyseur associe tool_use_id et kind, et garde signature pour le tour suivant.
  4. La facture utilise tool_search, tool_fetch et tool_image_search, plus l’entrée en échec de cache, l’entrée en succès de cache et la sortie. Elle n’ajoute pas web_search_requests.
  5. Une query autonome fait 1 à 128 caractères. count va de 1 à 50. Des résultats vides ne sont pas un frais.

Vérifiez le JSON en local avec le validateur JSON, JSONPath ($.usage.server_tool_use.tool_search) et JSON Diff contre la requête précédente. Rien n’est envoyé.

FAQ

thinking change-t-il la recherche ?

Oui. thinking.type disabled est une recherche web avec citations, kind vaut search. enabled est la recherche en réflexion profonde : search, open_page et find_in_page, environ 20 appels, kind vaut deep_search. La réflexion est le défaut. Si la réflexion et deepseek_web_search sont tous deux actifs, ce tour n’exécute pas deepseek_read_url.

tool_choice peut-il forcer deepseek_web_search ?

Non. Nommer l’outil renvoie 400, deepseek_web_search cannot be forced. Le modèle décide. tool_choice none coupe les outils web déclarés, y compris la lecture d’URL. Sur Responses et Chat, required est traité comme auto.

La facture doit-elle utiliser web_search_requests ?

Non. Ce compte inclut les erreurs et sert à l’affichage. Facturez tool_search, tool_fetch et tool_image_search. Dans le guide, un bloc de recherche à deux requêtes rapporte web_search_requests 1 et tool_search 2. Une recherche qui renvoie des résultats est facturée par requête. Une recherche vide ou en échec ne l’est pas.

POST /v1/tools/search fait-il une recherche d’images ?

Non. La recherche d’images ne tourne que dans deepseek_web_search. kind vaut image_search ou deep_image_search, et queries est vide. Chaque image compte pour une recherche, chaque zone choisie par le modèle pour une de plus.

Que envoie un service public pour la sûreté ?

DeepSeek indique qu’un service ouvert au public active safety_check avec level high. low équivaut à omettre le champ. Une entrée à risque renvoie 400 Content Exists Risk, et ces jetons d’entrée sont quand même facturés au prix du cache touché. Un refus est stop_reason refusal, Responses incomplete avec content_filter, ou Chat finish_reason content_filter.

Puis-je poursuivre une réponse qui a cherché ?

Non. Une réponse qui a utilisé deepseek_web_search ou deepseek_read_url renvoie 400. Renvoyez la requête précédente. Au tour suivant, repassez les blocs assistant inchangés, y compris kind et signature. Sans signature valide la requête réussit encore, mais la page ne revient pas dans le contexte.

Résumé

Les outils du 13 novembre 2026 changent la requête, les blocs à conserver et une deuxième ligne de facture. Déclarez deepseek_web_search et deepseek_read_url sur deepseek-flash. Coupez la réflexion pour la recherche avec citations, activez-la pour la recherche profonde. Les apps publiques mettent safety_check.level à high. Facturez tool_search, pas web_search_requests.