Note de l’auteur : deepseek-flash sait désormais chercher sur le web par lui-même, mais le commutateur de réflexion change la façon dont la recherche s’effectue, la facturation se compte en requêtes (query), et au tour suivant il ne reste que le corps de la réponse. Cet article clarifie les trois points qui le distinguent d’un appel d’outil classique, et les cas où il ne faut pas laisser le modèle chercher lui-même.
Le 13/11/2026, DeepSeek a officiellement annoncé l’ouverture au public de la capacité de conversation de son App via l’API. Pour cette mise en service, seul deepseek-flash embarque ce lot de capacités, dans la version DeepSeek-V4.1-Flash-1017. Déclarez un deepseek_web_search, et deepseek-flash peut aller sur Internet tout seul ; l’appel de l’outil et l’assemblage du contexte sont gérés côté serveur.
Beaucoup vont comprendre ça comme « on active un commutateur, et pour le reste c’est un appel de fonction ordinaire ». Ce n’est pas un simple commutateur. Selon que la réflexion est activée ou non, la manière de chercher change ; le nombre affiché dans la réponse n’est pas celui qui sera facturé ; et au tour suivant, tout ce que le modèle a cherché, lu ou pensé a disparu du contexte.
L’essentiel : après cette lecture, vous saurez en quoi deepseek-flash diffère d’un appel d’outil ordinaire sur les trois points — réflexion, facturation, tour suivant — et vous saurez décider quand laisser le modèle chercher lui-même et quand c’est au programme de s’en charger.

deepseek-flash sait chercher, mais oublie aussi : trois points clés
Commençons par la conclusion. Le tableau ci-dessous présente les trois différences entre la recherche intégrée de deepseek-flash et le schéma que vous connaissez bien : « le modèle lance l’appel, le programme l’exécute, le résultat est renvoyé ».
| Point clé | Comportement réel de deepseek-flash | Différence avec un appel de fonction classique |
|---|---|---|
| Réflexion | Réflexion désactivée : recherche web ou d’images avec citations ; réflexion activée : recherche en réflexion approfondie | Une même déclaration d’outil donne deux flux différents selon l’interrupteur de réflexion |
| Facturation | La recherche intégrée est facturée au nombre de query : trois query dans une même recherche comptent pour trois | Ce n’est pas « un appel = une unité », et le nombre d’appels indiqué dans le usage ne correspond pas non plus au nombre d’unités facturées |
| Tour suivant | Les résultats de recherche, les pages ouvertes et la réflexion ne passent pas au tour suivant : seul le texte de la réponse est conservé | Avec un appel de fonction classique, c’est vous qui réécrivez généralement le résultat dans l’historique, donc vous pouvez le conserver |
D’où viennent ces trois différences
Les trois différences découlent d’un même choix de conception : l’appel d’outil se produit côté serveur. Vous ne voyez pas les messages tool call intermédiaires et vous n’avez aucun moyen de décider ce qui est réécrit dans l’historique. Le serveur cherche, lit et assemble le contexte à votre place ; une fois la réponse terminée, tout le processus intermédiaire est jeté avec elle.
L’intégration est ainsi très simple, mais le prix à payer est une perte de contrôle. Quels query sont envoyés, quelles pages ont été ouvertes, si le tour suivant peut encore citer le texte original du tour précédent : c’est le serveur qui décide. Une fois ce point compris, tout ce qui suit dans les trois prochaines sections devient cohérent.
Comment l’option de réflexion de deepseek-flash change la recherche
La documentation officielle Build a Chatbot donne une comparaison très claire : avec la même déclaration de deepseek_web_search, le comportement change selon que l’option de réflexion est activée ou non.

| Option de réflexion | Outils déclarés | Comportement réel | Lecture séparée du lien |
|---|---|---|---|
| Désactivée | deepseek_web_search |
Recherche des pages web ou des images selon la question, réponse avec citations | Non concerné |
| Désactivée | deepseek_web_search + deepseek_read_url |
Recherche avec citations ; les liens présents dans les messages de l’utilisateur sont récupérés séparément | Oui |
| Activée | deepseek_web_search |
Recherche en réflexion profonde ; pendant un raisonnement multi-étapes, le modèle effectue lui-même les recherches et ouvre les pages | Le modèle décide lui-même quelles pages ouvrir |
| Activée | deepseek_web_search + deepseek_read_url |
Toujours une recherche en réflexion profonde | Pas de lecture séparée des liens |
| Peu importe | Seulement deepseek_read_url |
Identifie et récupère les liens présents dans les messages de l’utilisateur | Oui |
Les deux pièges de la recherche en réflexion profonde de deepseek-flash
Le premier piège concerne la lecture des liens. L’utilisateur colle un lien et vous pensez que déclarer deepseek_read_url suffit à garantir que cette page sera lue. Mais dès que la réflexion est activée et que deepseek_web_search est également déclaré, ce tour passe par la recherche en réflexion profonde : le lien n’est plus lu séparément, et c’est au modèle de décider pendant son raisonnement s’il ouvre cette page. Si votre produit promet de « lire l’article source dès qu’un lien est collé », soit vous désactivez la réflexion, soit vous ne déclarez que deepseek_read_url pour ce tour.
Le deuxième piège concerne les paramètres. Lorsque vous activez deepseek_web_search et deepseek_read_url, réglez safety_check sur high ou activez le paramètre title, le serveur ignore un certain nombre de paramètres d’échantillonnage, comme temperature et top_p. La liste des paramètres ignorés n’est pas exactement la même selon les trois protocoles. max_tokens (ou max_output_tokens dans le protocole Responses) reste actif, mais il limite la sortie de chaque étape de raisonnement d’un tour, pas le total du tour. Dans une recherche en réflexion profonde, estimer le coût maximal d’un tour avec max_tokens n’est donc pas fiable.
Comment est calculée la facturation de la recherche web de deepseek-flash
La facturation est l’endroit où l’on se trompe le plus facilement, car deux unités de comptage coexistent. Voici les deux, séparément.

| Scénario | Unité de comptage | Ce qui compte pour une unité | Cas non facturés |
|---|---|---|---|
| Recherche web intégrée | query | Une recherche renvoyant des résultats compte autant de fois qu’elle contient de query | Échec, aucun résultat |
| Recherche d’images intégrée | image + zone | Chaque image compte pour 1, et chaque zone encadrée par le modèle dans l’image ajoute 1 | Échec, aucun résultat |
| Lecture de liens intégrée | page récupérée avec succès | Facturé dès que la page est récupérée, y compris celles ensuite remplacées par url_not_allowed ou unavailable lors du contrôle de sécurité |
Liens non récupérables |
| Visites répétées dans la recherche avec réflexion approfondie | récupération réelle | Seule la récupération réellement effectuée depuis le web est facturée | Réouverture de la même page, déplacement dans la page, contenu déjà renvoyé avec les résultats de recherche |
| API Search / Fetch indépendante | requête réussie | Compté une fois seulement si HTTP 200 et résultats présents ; count ne change pas le prix de cette requête |
Échec, résultat vide, timeout |
Sur la page tarifaire officielle (2026-11-15), Search (texte et image) et Web fetch sont à 0,75 USD par 1000 appels. Le prix unitaire est identique, mais « une fois » pour un outil intégré désigne un query, tandis que « une fois » pour l’API indépendante désigne une requête réussie : les deux quantités ne sont pas directement comparables.
Ne confondez pas les champs usage de deepseek-flash
Dans l’usage renvoyé, deux groupes de champs se ressemblent beaucoup mais n’ont pas le même sens :
| Champ | Signification | Utilisable pour le rapprochement |
|---|---|---|
web_search_requests |
Nombre de blocs de résultats de recherche affichés, erreurs incluses | Non |
web_fetch_requests |
Nombre de blocs de résultats de récupération affichés, erreurs incluses | Non |
tool_search |
Nombre de recherches facturées | Oui |
tool_fetch |
Nombre de récupérations facturées | Oui |
tool_image_search |
Nombre de recherches d’images facturées | Oui |
Si vous comptabilisez l’usage sur web_search_requests, le chiffre risque d’être trop élevé, car il inclut les blocs de résultats en échec ; et il ne permet pas non plus de voir combien de query contient une recherche. Pour le rapprochement, utilisez les trois champs tool_*.
Les frais d’outils sont facturés en plus des frais de tokens. Sur le site officiel, le tarif des tokens de deepseek-flash se divise en heures pleines et heures creuses : les heures pleines vont du lundi au vendredi, de 01:00 à 04:00 et de 06:00 à 10:00 UTC (hors jours fériés légaux chinois), tout le reste est en heures creuses, et le tarif creux est la moitié du tarif plein.
Pourquoi deepseek-flash « oublie » au tour suivant
La documentation officielle précise que, dans une conversation à plusieurs tours, les résultats de recherche, les pages ouvertes et le raisonnement du tour précédent ne sont pas repris dans le contexte du tour suivant : seul le corps de la réponse est conservé.
Ainsi, le « il oublie » du titre désigne l’effacement du contexte, pas le fait que le modèle n’ait rien trouvé. Au tour précédent, il a peut-être lu cinq pages et cité trois passages originaux ; au tour suivant, il ne dispose plus que de la réponse qu’il a lui-même rédigée. Si l’utilisateur demande ensuite « que disait exactement la deuxième source ? », le modèle doit soit relancer une recherche (ce qui repaye l’usage de l’outil), soit se contenter de déduire à partir de sa propre réponse.

Quand vaut-il mieux ne pas laisser deepseek-flash chercher par lui-même
Dans les cas suivants, il est préférable de laisser le programme décider quoi chercher plutôt que de confier cette tâche au modèle :
- Besoin de citer le texte original entre les tours : par exemple des clauses réglementaires, des contrats ou des questions-réponses sur des documents longs, où la réponse du tour suivant doit encore s’appuyer sur le texte original.
- Besoin d’une facturation prévisible : la recherche avec raisonnement approfondi lance plusieurs requêtes et ouvre plusieurs pages, sans qu’on puisse le maîtriser à l’avance.
- Besoin de restreindre les sources : n’autoriser que certains sites, ou imposer l’exclusion de certains sites.
- Coller un lien oblige à lire le texte original : quand le raisonnement ouvre le lien, il arrive que son contenu ne soit pas lu séparément.
- Clé API hors du site officiel de DeepSeek : la plateforme utilisée n’a pas forcément déjà branché les outils intégrés ; la section suivante l’explique en détail.
Prise en main rapide de deepseek-flash : comment garder une page web dans le contexte ?
Pour garder une page web dans le contexte, l’idée est de séparer la « recherche » et la « réponse » : le programme appelle les interfaces de recherche et de récupération, assemble lui-même le corps du texte dans messages, puis le confie à deepseek-flash pour obtenir la réponse. Ainsi, le texte original de la page reste dans l’historique que vous conservez de votre côté, et il n’est pas perdu au tour suivant.
Sur APIYI apiyi.com, deux interfaces indépendantes sont déjà disponibles : deepseek-search et deepseek-fetch, mises en ligne le 21 octobre 2026. Ce ne sont pas des modèles de conversation : elles ne consomment pas de tokens et sont facturées au nombre de requêtes réussies, avec les mêmes règles de facturation que les interfaces indépendantes du site officiel. Voici les étapes :
- Dans la console APIYI, créez un nouveau jeton et choisissez le groupe
defaultousvip. Avec le groupe ClaudeCode, vous recevrez une erreur 503, avec le message d’erreur exact :no available channels for model deepseek-search. - Recherche : envoyez une requête
POSTà/v1/tools/search, avec l’URL de basehttps://api.apiyi.com. Le corps de la requête n’a pas besoin du champmodel. queryest obligatoire, de 1 à 128 caractères, et prend en chargesite:,-site:, les guillemets,lang:,after:etbefore:.countaccepte une valeur de 1 à 50, avec 10 par défaut ; cela n’a pas d’incidence sur le prix.need_contentvautfalsepar défaut ; si vous le passez àtrue, le corps du texte est renvoyé en même temps.localization: indiquez l’IP de l’utilisateur. Si vous mettez un code de langue commezh-CN, l’API renvoie une erreur 400.- Récupération : sélectionnez le lien à lire, puis envoyez une requête
POSTà/v1/tools/fetch.urldoit être une adresse http ou https avec un nom de domaine, d’une longueur maximale de 8192 caractères, et ne doit contenir ni nom d’utilisateur ni mot de passe. - Réponse : insérez le corps du texte extrait dans
messagessous forme d’un message, appelezdeepseek-flash, et réglez lebase_urlcompatible OpenAI surhttps://api.apiyi.com/v1. - Conservation : ajoutez ce corps de page à votre propre historique de conversation et joignez-le au tour suivant, ou ne conservez qu’un résumé pour limiter les tokens.
Les limites de débit côté amont, selon la documentation, sont les suivantes : Search à 100 QPS, Fetch à 25 QPS, avec une limite supplémentaire par domaine. La documentation signale aussi deux points après de nouveaux tests : des mots-clés mal encodés peuvent renvoyer quelques résultats et être facturés normalement ; et certains sites renvoient la page d’accueil pour une page inexistante (soft 404), que Fetch compte comme une requête réussie. Mieux vaut filtrer vous-même les liens avant la récupération.
🎯 Conseil technique : pour les cas où vous devez citer le texte original sur plusieurs tours, je vous conseille de valider d’abord toute la chaîne « search → fetch → deepseek-flash » avec le quota de test gratuit pour les nouveaux utilisateurs sur APIYI apiyi.com, puis de vérifier que la longueur du texte extrait et le nombre de requêtes facturées correspondent à vos attentes avant de passer en production.
Ce qu’il faut savoir quand la clé deepseek-flash ne vient pas du site officiel
Une chose à clarifier d’emblée : au 15 novembre 2026, ni le tableau récapitulatif des modèles d’APIYI ni le fil d’actualité en temps réel n’indiquent que deepseek-flash prend en charge deepseek_web_search. La dernière entrée DeepSeek du fil d’actualité concerne la mise en ligne de la version économique du 11 novembre 2026 ; le 13 novembre, cette API App n’apparaissait pas encore. Donc si vous appelez deepseek-flash via APIYI, vous ne pouvez pas considérer que déclarer deepseek_web_search lui permettra de chercher tout seul : aujourd’hui, il est positionné comme modèle de réponse.
Le tableau ci-dessous présente les tarifs au 15 novembre 2026 ; les prix par token sont en dollars pour 1 million de tokens, et les modèles facturés à l’appel en dollars par appel :
| Modèle | Prix affiché sur APIYI apiyi.com | Comparaison site officiel | Remarque |
|---|---|---|---|
deepseek-flash |
Entrée 0,3 – sortie 1,2 – lecture cache 0,006 | En heure de pointe identique : 0,3 / 1,2 / 0,006 ; moitié prix en heures creuses | Le tableau récapitulatif ne mentionne pas le demi-tarif heures creuses |
deepseek-search |
0,0009 / appel (soit 0,90 / 1000 appels) | 0,75 / 1000 appels | Groupes : default et svip uniquement |
deepseek-fetch |
0,0009 / appel (soit 0,90 / 1000 appels) | 0,75 / 1000 appels | Groupes : default et svip uniquement |
Les 0,90 dollar / 1000 appels indiqués sur la page des capacités et les 0,0009 dollar / appel du tableau récapitulatif correspondent au même tarif. D’après la documentation APIYI, une fois le bonus de recharge pris en compte, un gros client qui recharge paie environ 0,75 dollar / 1000 appels, soit le niveau du site officiel ; un utilisateur ordinaire paie environ 0,82 dollar / 1000 appels. Ces deux montants sont calculés après conversion du bonus de recharge : ce ne sont pas les tarifs du tableau récapitulatif. Les prix incluent les taxes et une facture peut être émise.
Autre point : l’OCR, l’ASR et le TTS ne sont pas encore disponibles sur APIYI ; nous mettrons ce modèle en ligne dès que possible. Les modèles et les prix font foi sur la liste des modèles de la plateforme.
💡 Conseil de choix : si votre activité a besoin de la « recherche multi-étapes menée par le modèle lui-même » intégrée au site officiel, il faut pour l’instant utiliser une clé du site officiel ; si vous privilégiez la conservation du texte source et une facturation prévisible, utilisez l’interface indépendante d’APIYI apiyi.com avec deepseek-flash pour les réponses : tout le flux reste entre vos mains.
FAQ – Questions fréquentes
Q1 : Qu’est-ce que la recherche intégrée de deepseek-flash ?
Il s’agit de l’outil côté serveur `deepseek_web_search` disponible sur deepseek-flash (V4.1-Flash-1017), utilisable sur les trois protocoles Messages, Responses et Chat Completions. L’invocation de l’outil et l’assemblage du contexte sont pris en charge par le serveur, et les frais d’outil sont facturés séparément des frais de tokens.
Q2 : Quelle différence entre la recherche interne de deepseek-flash et un appel programmé à Search / Fetch ?
La recherche intégrée est facturée par requête, et les résultats intermédiaires ne sont pas conservés pour le tour suivant ; l’API indépendante est facturée par requête réussie, le paramètre `count` n’influence pas le prix, et c’est à vous de décider si vous conservez ou non le texte principal renvoyé. La première est plus simple à intégrer, la seconde offre davantage de contrôle.
Q3 : Quand ces capacités de recherche web de deepseek-flash ont-elles été annoncées ?
DeepSeek les a officiellement publiées le 13 novembre 2026 (22 h 24, heure de Pékin), la page d’actualités et le journal des modifications étant datés du même jour. Sur APIYI, `deepseek-search` et `deepseek-fetch` ont été mis en ligne le 21 octobre 2026, ce qui est une chose distincte de cette annonce.
Q4 : La version économique ou V4 Pro peut-elle faire sa propre recherche ?
La documentation officielle précise que ces capacités conversationnelles ne sont proposées que sur deepseek-flash et qu’il ne faut pas les appliquer à deepseek-v4-pro ni aux identifiants de la version économique. La version économique d’APIYI, `deepseek-v4-1-flash-economy-261017`, charge les mêmes poids que V4.1-Flash-1017, simplement avec une vitesse plus lente. Les estimations de la documentation indiquent environ 2 secondes pour le premier token et environ 15 millisecondes par token. Ce n’est pas une API de recherche.
Q5 : Sur APIYI, comment faire répondre deepseek-flash à partir de pages web ?
Utilisez un jeton `default` ou `svip` pour appeler `/v1/tools/search` et `/v1/tools/fetch`, intégrez le texte principal dans les messages, puis appelez `deepseek-flash`. Pour les paramètres détaillés, consultez la page DeepSeek Search / Fetch du centre de documentation d’APIYI, apiyi.com.
Q6 : Quelles précautions prendre côté sécurité lorsqu’on propose un service au public ?
La documentation officielle exige d’activer `safety_check` (niveau `high` dans les exemples de la doc) lorsqu’on expose le service au public, et d’effectuer soi-même la modération de contenu, l’enregistrement du grand modèle de langage et l’étiquetage IA. Une fois activé, les paramètres d’échantillonnage comme `temperature` sont ignorés, et en cas de refus du modèle, `stop_reason` vaut `refusal`. La sécurité du modèle est facturée au token de sortie, sans tarif unitaire distinct.
Q7 : Si aucune requête ne renvoie de résultat, suis-je facturé ?
En cas d’échec ou d’absence de résultat, la recherche intégrée n’est pas facturée. L’API indépendante ne facture que lorsque le code HTTP est 200 et qu’un résultat est renvoyé ; les erreurs 400 et les 404 d’échec de récupération ne sont pas facturées. La documentation mentionne toutefois lors de ses tests que des mots-clés illisibles et des 404 doux peuvent encore être facturés.
deepseek-flash : il sait chercher, mais il oublie aussi — points clés
- La réflexion change la recherche : sans réflexion, on obtient une recherche avec citations ; avec la réflexion, on obtient une recherche approfondie en plusieurs étapes.
- Les liens ne sont pas forcément lus : lorsque la réflexion est activée et que
deepseek_web_searchest déclaré, les liens ne sont pas lus séparément. - La facturation se compte par query : trois query dans une seule recherche comptent pour trois ; les échecs ou les résultats vides ne sont pas facturés.
- Pour le rapprochement de facturation, regardez le champ tool :
web_search_requestssert uniquement à l’affichage ; le nombre de débits se lit dans des champs commetool_search. - Au tour suivant, il ne reste que la réponse : les pages web, leur contenu et la réflexion sont perdus ; « oublier » fait référence au contexte.
- Pour conserver les pages web, cherchez vous-même : sur APIYI apiyi.com, utilisez
deepseek-searchavecdeepseek-fetch, puis confiez le résultat à deepseek-flash.
En résumé
deepseek-flash cherche et oublie. Trois points à retenir :
- Réflexion : une même déclaration
deepseek_web_searchemprunte deux parcours différents selon que la réflexion est activée ou non, et le comportement de lecture des liens change en conséquence. - Facturation : les outils intégrés facturent par query, par image et par zone sélectionnée ; les interfaces autonomes facturent par requête réussie. Ne mélangez pas les deux unités.
- Tour suivant : seul le corps de la réponse est conservé. Si vous devez citer le texte original d’un tour à l’autre, c’est à votre programme de rechercher et de sauvegarder le contenu.
Si votre clé est chez APIYI, la documentation actuelle n’indique pas que deepseek-flash est déjà connecté à la recherche intégrée. Vous pouvez d’abord tester l’association de l’interface autonome et de deepseek-flash avec le quota gratuit d’APIYI apiyi.com, puis décider si vous avez besoin de la recherche intégrée officielle.
📚 Références
- Page d’actualités DeepSeek (2026-11-13) : annonce de l’ouverture des capacités de l’App à l’API
- Lien :
api-docs.deepseek.com/zh-cn/news/news261113 -
Description : confirme que seul deepseek-flash embarque cet ensemble de capacités
-
Guide DeepSeek « Build a Chatbot » : comparaison du comportement entre le commutateur de réflexion et la combinaison d’outils
- Lien :
api-docs.deepseek.com/guides/build_a_chatbot -
Description : règles de recherche en réflexion profonde, lecture de liens et contexte multi-tours
-
Guide DeepSeek Web Tools : section Usage and Billing des outils intégrés
- Lien :
api-docs.deepseek.com/guides/web_tools -
Description : facturation au nombre de query, signification du champ usage
-
Page tarifs DeepSeek : prix des tokens, heures de pointe et heures creuses, prix unitaire des outils
- Lien :
api-docs.deepseek.com/quick_start/pricing -
Description : données du 2026-11-15
-
Documentation APIYI DeepSeek Search / Fetch : paramètres et facturation de l’interface autonome
- Lien :
docs.apiyi.com/api-capabilities/deepseek-search-fetch/overview -
Description : exigences de groupe, limites de paramètres, notes sur le retest de la documentation
-
Tableau général des modèles APIYI : modèles et prix en temps réel
- Lien :
docs.apiyi.com/models - Description : c’est la référence pour les modèles et les prix
Auteur : équipe technique APIYI
Échanges techniques : n’hésitez pas à nous contacter depuis la page d’accueil de APIYI apiyi.com ; vous trouverez davantage de ressources dans le centre de documentation docs.apiyi.com
