Recherche web, fichiers et voix de l'API DeepSeek : configuration, coûts réels et quand garder votre RAG
Un guide pratique sur la recherche web, la lecture d'URL, l'entrée de fichiers avec OCR et la voix de l'API DeepSeek : comment les configurer, ce qu'ils coûtent une fois les frais par requête ajoutés aux tarifs des tokens, et une méthode pilote pour décider quelles questions confier aux outils intégrés et lesquelles garder sur votre propre pile de récupération.
Ce guide explique comment configurer la recherche web, la lecture d'URL, l'entrée de fichiers avec OCR et la voix de l'API DeepSeek, ce que coûte réellement chaque réponse et comment décider où envoyer chaque question. Ces fonctionnalités s'accompagnent aussi d'obligations de gouvernance, que la première section présente.
Ce que DeepSeek a ajouté à l'API
La recherche s'appuie sur le moteur de recherche maison de DeepSeek. Selon le journal des modifications, DeepSeek Search est un moteur de recherche généraliste conçu nativement pour l'IA, qui indexe des centaines de milliards de pages web et prend en charge la recherche multilingue.
Vous pouvez lancer la recherche avec le mode réflexion désactivé ou activé. Lorsque la réflexion est activée, deepseek_web_search fonctionne comme une recherche à réflexion approfondie : au fil de plusieurs étapes de réflexion, le modèle effectue des recherches, ouvre des pages et y repère des passages, avec jusqu'à environ 20 appels d'outils avant de répondre. C'est utile pour les questions de recherche difficiles. Cela signifie aussi qu'une seule question d'utilisateur peut déclencher beaucoup d'activité facturable, un point sur lequel reviennent les sections consacrées aux coûts et aux mises en garde.
Cette version impose également une condition de gouvernance. L'annonce de lancement de DeepSeek précise que les applications ouvertes au public doivent activer les contrôles de sécurité, et que les développeurs restent responsables de la modération des contenus, de l'enregistrement des modèles lorsqu'il s'applique et de l'étiquetage des contenus générés par l'IA. Les applications publiques doivent donc activer le contrôle de sécurité, mais cela ne transfère pas votre travail de conformité à DeepSeek. Considérez ce point comme le socle de gouvernance de tout ce qui suit.
Si vous voulez une référence fonctionnelle, DeepSeek publie une démo de chat open source sur GitHub. La démo stocke votre clé API et vos paramètres dans le localStorage du navigateur, et les conversations ainsi que les pièces jointes d'origine dans IndexedDB. Cela convient pour un prototype local. En production, gardez les clés sur un backend.
Configurer deepseek_web_search et deepseek_read_url sur deepseek-flash
Choisir un endpoint
Copiez la structure exacte de requête correspondant à l'endpoint que vous utilisez depuis le guide Web Tools officiel. Considérez ce guide comme la source de référence à chaque évolution de l'API, et n'adaptez pas un exemple écrit pour un autre fournisseur.
Une séquence de configuration minimale
- Gardez la clé sur un backend. Le stockage navigateur de la démo de chat convient pour un prototype local, et pour rien de plus.
- Commencez avec un seul outil. En reprenant la structure de requête du guide Web Tools, appelez deepseek-flash avec deepseek_web_search activé et la réflexion désactivée, puis envoyez un petit ensemble de vraies questions d'utilisateurs.
- Journalisez l'utilisation à chaque requête, avec un enregistrement comme celui ci-dessous.
- Ajoutez deepseek_read_url séparément pour récupérer des pages précises, et testez-le seul avant de combiner les deux outils.
- Activez la réflexion en dernier, et comparez les résultats avec votre référence sans réflexion.
Ce qu'il faut journaliser dès le premier jour
L'enregistrement ci-dessous est le format de journal que nous suggérons, pas le format de réponse de DeepSeek. Les deux valeurs de tokens proviennent de l'exemple de la documentation de DeepSeek ; les autres valeurs sont des emplacements à remplir à partir de votre propre trafic.
{
"route": "public_freshness",
"endpoint": null,
"model": "deepseek-flash",
"thinking": false,
"tools_enabled": ["deepseek_web_search"],
"billed_search_queries": null,
"input_tokens": 9078,
"cached_input_tokens": 4096,
"output_tokens": null,
"latency_ms": null,
"peak_hours": null,
"answer_useful": null
}Surveillez trois champs de près : les requêtes facturées, les tokens d'entrée et l'utilité de la réponse. L'analyse des coûts présentée plus loin dans ce guide en dépend.
Réflexion activée ou désactivée
La recherche à réflexion approfondie vous offre plus de profondeur, mais moins de prévisibilité.
Combiner avec vos propres outils de fonctions
MxChat a indiqué que, lors de ses tests, un bot utilisant déjà des outils de fonctions, par exemple pour consulter des commandes ou remplir des formulaires, ne pouvait pas ajouter la recherche web DeepSeek avec la réflexion désactivée. Nous vous conseillons de le vérifier sur votre propre compte avant de vous y fier. Si cela se confirme chez vous, un assistant qui appelle déjà vos outils ne peut ajouter la recherche intégrée qu'en mode réflexion, et il hérite du profil de latence et de coût de ce mode.
Ce que vous ne pouvez pas configurer
L'outil de recherche intégré rejette les options allowed_domains, blocked_domains et user_location : vous ne pouvez donc pas restreindre les résultats à certains sites via l'outil. Si votre exigence est « citer uniquement notre documentation et ces trois régulateurs », l'outil intégré ne peut pas y répondre.
API autonomes Search et Fetch
DeepSeek propose aussi la recherche et la récupération sous forme d'API autonomes. Elles sont soumises à des limites au niveau du compte de 100 requêtes par seconde pour la recherche et 25 pour la récupération, distinctes des limites de concurrence des modèles. Comparez ces limites à votre trafic de pointe, et non à votre moyenne, car la moyenne vous induira en erreur.
Entrée de fichiers et OCR : limites et facturation
L'API Files fixe des limites de taille selon le type de fichier.
| Type de fichier | Taille maximale |
|---|---|
| Images | 64 MiB |
| Documents tels que PDF, Word et PowerPoint | 100 MiB |
| Texte brut, tableurs et livres numériques | 32 MiB |
Selon le guide OCR, l'OCR est facturé au nombre de pages reconnues avec succès, et une reconnaissance qui échoue ou expire n'est pas facturée. Consultez la page des tarifs pour connaître les frais actuels avant d'établir un budget.
L'entrée de fichiers fonctionne au mieux pour des questions-réponses ponctuelles sur un document, lorsqu'un utilisateur téléverse un contrat ou un formulaire numérisé et pose des questions dessus. Les équipes qui ont besoin d'une base de connaissances persistante et versionnée, avec contrôles d'accès, stratégie de découpage, règles de fraîcheur et suivi des citations, devront probablement encore construire cette couche elles-mêmes. Notre guide sur le découpage des tableaux PDF sans perdre leur source traite du volet provenance de ce travail.
Voix : reconnaissance vocale et synthèse vocale
Commencez par la couverture linguistique. Selon la documentation de DeepSeek, la reconnaissance vocale prend en charge 21 langues, dont le russe, tandis que la synthèse vocale prend en charge 10 langues, sans le russe. En pratique, un produit pourrait accepter une question orale dans une langue dans laquelle il ne peut pas répondre à voix haute. La couverture pourrait s'élargir : surveillez donc le journal des modifications et vérifiez vos langues cibles dans la documentation vocale de DeepSeek avant de vous engager.
Les coûts de la voix méritent la même attention. Dans l'unique échantillon de MxChat, la lecture à voix haute d'une réponse de 213 caractères a coûté environ $0.0096 au prix catalogue, alors que la génération de cette réponse sur deepseek-flash a coûté environ $0.0006 : la sortie vocale a donc coûté environ 16 fois plus que la génération du texte. Un seul court échantillon ne constitue pas une prévision, mais il montre que la sortie vocale peut coûter plus cher que le texte qu'elle lit ; modélisez-la donc séparément.
Ce que coûte réellement la recherche web DeepSeek : frais d'outils en plus des tarifs des tokens
Les frais par recherche ne sont qu'une ligne de la facture.
Tarifs des tokens et heures de pointe
Les tarifs hors pointe sont deux fois moins élevés que les tarifs de pointe. Les heures de pointe vont de 01:00 à 04:00 et de 06:00 à 10:00 UTC, du lundi au vendredi, hors jours fériés chinois.
Comportements de facturation à prendre en compte dans la conception
La recherche web est facturée par requête, et non par appel. Un appel de recherche qui renvoie des résultats est facturé pour chacune de ses requêtes : un appel comportant trois requêtes compte donc pour trois. Un appel qui échoue ou ne renvoie aucun résultat n'est pas facturé. Votre budget doit donc reposer sur le nombre de requêtes que le modèle émet réellement, et journaliser le trafic réel est le seul moyen de connaître ce nombre. Le traçage par requête, tel que décrit dans notre guide de traçage GenAI avec OpenTelemetry, vous fournit un historique des appels d'outils et des volumes de tokens sur lequel bâtir ce budget.
Ce que les remises ne couvrent pas
Les frais de recherche ne baissent ni hors pointe ni avec le cache, car les heures à demi-tarif et la remise sur le cache de DeepSeek ne s'appliquent qu'aux tokens. La part recherche de la facture reste identique à toute heure.
Croissance du contexte
La recherche agrandit aussi votre contexte. Dans l'exemple de la documentation, une requête de recherche a utilisé 9,078 tokens d'entrée plus 4,096 tokens en cache. Le contenu des pages récupéré par le modèle devient de l'entrée, et l'entrée se paie.
Ce qu'a révélé le test de MxChat
MxChat a comparé des réponses avec et sans recherche sur deepseek-flash.
| Indicateur (test MxChat) | Sans recherche | Avec recherche |
|---|---|---|
| Recherches facturées par réponse | Aucune | 2.9 en moyenne |
| Tokens d'entrée par réponse | 4,070 | 13,803 |
| Coût pour 1,000 réponses, hors pointe | $0.63 | $3.64 |
| Part des frais de recherche dans la facture | Sans objet | 60% |
Dans le test de MxChat, les réponses avec recherche ont déclenché en moyenne 2.9 recherches facturées, et les tokens d'entrée par réponse sont passés de 4,070 sans recherche à 13,803 avec recherche. Hors pointe, 1,000 réponses ont coûté $0.63 sans recherche et $3.64 avec recherche, et les frais de recherche représentaient 60% de la facture. Autrement dit, une réponse avec recherche a coûté près de six fois plus qu'une réponse sans recherche dans ce test, et l'essentiel de l'écart venait des frais par requête et des tokens d'entrée supplémentaires, pas de la réponse elle-même.
Contexte du marché
Anthropic affiche son outil de recherche web Claude à $10 pour 1,000 recherches et OpenAI affiche son outil de recherche web à $10 pour 1,000 appels, dans les deux cas en plus des coûts de tokens. Nous vous conseillons de comparer ces prix catalogue avec les frais actuels par requête de DeepSeek sur sa page des tarifs. Gardez à l'esprit que les frais par recherche ne sont qu'une partie de la comparaison. Le nombre de requêtes déclenchées par chaque réponse, et le volume que chaque recherche ajoute au contexte, peuvent peser tout autant.
Le pilote de routage par type de question
La page des tarifs ne suffit pas à prendre une décision. La méthode ci-dessous, que nous appelons le pilote de routage par type de question, est un court test sur votre propre trafic. Au lieu d'un simple oui ou non pour l'ensemble du produit, elle aboutit à une décision de routage pour chaque type de question. Il s'agit d'une méthode que nous suggérons, pas d'un benchmark publié.
- Échantillonnez de vraies questions. Extrayez un ensemble représentatif de vos journaux et classez-les en trois types : les questions qui nécessitent du contenu web public récent, les questions portant sur des documents téléversés et les questions qui dépendent de connaissances privées.
- Exécutez chaque question dans quatre configurations. Outils désactivés et activés, chacun avec la réflexion activée et désactivée, en journalisant avec l'enregistrement présenté dans la section de configuration.
- Ne touchez pas à votre prompt système de production. Dans le test de MxChat, un prompt de support restrictif a largement bloqué la recherche : le bot n'a effectué de recherche que dans 2 réponses sur 16. Dans l'une de ces deux réponses, il a lancé trois recherches facturées, s'est vu facturer 12,829 tokens d'entrée et a tout de même répondu qu'il ne disposait pas d'assez d'informations dans sa base de connaissances.
- Comptabilisez les réponses payées mais inutiles. Avec la réflexion désactivée, MxChat a constaté que 6 réponses avec recherche sur 20, soit 30%, avaient été payées sans être utiles. Suivez ce taux sur vos propres données, car il augmente le coût de chaque réponse utile sans apparaître comme une ligne distincte.
- Calculez les prix en pointe et hors pointe. Appliquez les deux tarifs de tokens, puis ajoutez les frais d'outils par requête, qui ne bénéficient jamais de remise.
- Réglez la gouvernance avant le lancement. Désignez un responsable pour chaque obligation du socle de gouvernance décrit au début de ce guide.
- Décidez par type de question. Vous enverrez probablement certains types aux outils intégrés et garderez les autres sur votre propre système de récupération.
Liste de contrôle avant lancement
- [ ] Structures de requête copiées depuis le guide Web Tools pour votre endpoint
- [ ] Mode réflexion choisi pour chaque route, latence mesurée
- [ ] Compatibilité avec les outils de fonctions testée sur votre propre compte
- [ ] Budget établi par requête, croissance des tokens d'entrée comprise
- [ ] Coûts vocaux modélisés au prix catalogue et langues de synthèse vocale vérifiées par rapport aux marchés cibles
- [ ] Limites de débit des API autonomes vérifiées par rapport au trafic de pointe
- [ ] Contrôles de sécurité activés et responsables de la gouvernance désignés
- [ ] Politique de confidentialité de DeepSeek examinée par le service juridique, après avoir confirmé auprès de DeepSeek que la version liée est toujours en vigueur
Matrice de décision : outils intégrés ou votre propre RAG
Utilisez ce tableau pour interpréter les résultats de votre pilote.
| Dimension | Outils DeepSeek intégrés | Votre propre RAG |
|---|---|---|
| Source des données | Web public via l'index de DeepSeek ; fichiers téléversés | Tout corpus que vous contrôlez, y compris des données privées |
| Contrôle des sources | Pas de listes autorisées ou bloquées de domaines, ni de ciblage géographique | Contrôle total des sources et du classement |
| Auditabilité | Limitée à ce que renvoient le modèle et l'outil | Vous définissez la journalisation, le versionnage et les pistes de citation |
| Résidence des données | Examinez le traitement des données du fournisseur au regard de vos règles de résidence avant le lancement | Peut être conçu en fonction de vos règles de résidence |
| Prévisibilité des coûts | Varie selon le nombre de requêtes par réponse et la croissance du contexte | Infrastructure essentiellement fixe plus les tokens |
| Effort d'exploitation | Faible ; aucun crawler, index ou OCR à faire tourner | Plus élevé ; vous construisez et maintenez le pipeline |
| Débit | Plafonds de recherche et de récupération au niveau du compte sur les API autonomes (voir la section de configuration) | Évolue avec l'infrastructure que vous provisionnez |
| Pages riches en JavaScript | Testez sur vos propres pages cibles avant de vous y fier | Dépend de votre outil de récupération et de votre configuration de rendu |
Là où les outils intégrés l'emportent généralement
Les outils intégrés sont pertinents pour les réponses issues du web public récent et pour la recherche multilingue sur un vaste index public. Ils conviennent aussi aux fonctionnalités à faible volume ou exploratoires, aux questions-réponses ponctuelles sur des fichiers et aux équipes qui ne disposent pas encore d'infrastructure de récupération.
Là où votre propre RAG l'emporte généralement
Votre propre pile est le meilleur choix pour les corpus privés ou internes qu'un moteur public ne peut pas voir. Elle l'emporte aussi lorsque vous avez besoin de listes autorisées ou bloquées de domaines, d'un contrôle strict des sources avec pistes d'audit, ou lorsque des règles de résidence et des contrats limitent les endroits où les données peuvent transiter. Comme l'outil intégré rejette les filtres de domaine et de localisation, vous ne pouvez pas garantir quelles sources fondent une réponse.
Hybride
Pour beaucoup de produits, la réponse réaliste est d'utiliser les deux, et le pilote vous indique où faire la séparation. Gardez votre propre système de récupération pour les connaissances privées et n'ouvrez la recherche intégrée qu'aux types de questions qui nécessitent des informations publiques récentes.
Mises en garde et questions ouvertes
Les chiffres de coût par réponse de ce guide proviennent du test de MxChat : considérez-les comme un point de données parmi d'autres plutôt que comme une prévision.
Les prix, promotions et limites peuvent évoluer : consultez donc la page des tarifs et le journal des modifications avant de vous engager.
La recherche à réflexion approfondie se ramifie en de nombreux appels d'outils, si bien que la latence et le coût par réponse varieront fortement. Définissez des délais d'expiration et des garde-fous budgétaires par requête, soit dans votre propre code, soit dans une couche de routage comme celle de notre guide Vercel AI Gateway.
Vérifiez que la version liée est bien en vigueur, puis confrontez-la à vos contrats et à vos exigences réglementaires. Notre liste de contrôle des risques liés aux fournisseurs d'inférence recense d'autres questions à poser à tout fournisseur de modèles.
Points clés
- Les outils de recherche de DeepSeek reposent sur son moteur de recherche maison, qui indexe des centaines de milliards de pages web.
- La recherche web de l'API DeepSeek est facturée par requête et non par appel, et les remises hors pointe et sur le cache ne s'appliquent qu'aux tokens, jamais aux frais de recherche.
- Dans le test indépendant de MxChat, les réponses avec recherche ont coûté $3.64 pour 1,000 hors pointe contre $0.63 sans recherche, et les frais de recherche représentaient 60% de la facture.
- L'outil de recherche intégré rejette les filtres de domaine et de localisation, et MxChat a constaté qu'ajouter la recherche web à vos propres outils de fonctions ne fonctionnait qu'en mode réflexion.
- Dans l'unique échantillon de MxChat, la synthèse vocale a coûté environ 16 fois plus que la génération du texte ; la synthèse vocale couvre 10 langues contre 21 pour la reconnaissance vocale.
- Les applications ouvertes au public doivent activer les contrôles de sécurité, mais la modération, l'enregistrement et l'étiquetage des contenus IA restent à la charge du développeur.
- Menez un pilote de routage par type de question : les outils intégrés conviennent au web public récent et aux fichiers ponctuels, tandis que les corpus privés, le contrôle des sources, l'auditabilité et la résidence des données plaident pour votre propre RAG.
Conclusion
Les outils intégrés de DeepSeek vous permettent d'ajouter la recherche web en direct, la lecture de fichiers et la voix à un produit LLM sans faire tourner votre propre crawler, votre propre index ou votre propre pipeline OCR. Les frais par recherche ne sont toutefois qu'une partie de la facture. Ce que vous payez réellement dépend du nombre de requêtes déclenchées par chaque réponse, de la croissance du contexte, du nombre de recherches inutiles et du coût de la sortie vocale, et les premiers tests indépendants suggèrent que les frais de recherche peuvent constituer la part la plus importante. Testez certaines contraintes au lieu de les supposer : il n'existe aucun filtre de domaine ou de localisation, combiner la recherche avec vos propres outils de fonctions nécessiterait le mode réflexion, et les obligations de gouvernance restent les vôtres.
Menez donc le pilote de routage par type de question sur votre propre trafic avec votre vrai prompt système, chiffrez-le aux tarifs de pointe et hors pointe, et envoyez chaque type de question vers l'option qui le sert le mieux. Pour la plupart des équipes, cela aboutit à un modèle hybride, où la recherche intégrée gère les informations publiques récentes et votre propre système de récupération tout ce qui est privé, contrôlé ou audité. Si un regard extérieur sur la conception de votre pilote ou votre modèle de coûts peut vous aider, l'équipe Optijara se fera un plaisir d'en discuter avec vous.
Questions fréquentes
Combien coûte la recherche web intégrée de DeepSeek par rapport à OpenAI et Anthropic ?
Anthropic affiche son outil de recherche web Claude à $10 pour 1,000 recherches et OpenAI affiche son outil de recherche web à $10 pour 1,000 appels, dans les deux cas en plus des coûts de tokens. Consultez la page des tarifs de DeepSeek pour connaître ses frais actuels par requête de recherche. DeepSeek facture par requête : un appel comportant trois requêtes compte donc pour trois, et les recherches échouées ou sans résultat ne sont pas facturées. Le coût réel par réponse utile dépend du nombre de requêtes émises par le modèle et du volume de contenu de recherche ajouté aux tokens d'entrée.
Les remises hors pointe de DeepSeek s'appliquent-elles aux frais de recherche web et de récupération ?
Non. Les tarifs des tokens hors pointe sont deux fois moins élevés qu'en pointe, les heures de pointe allant de 01:00 à 04:00 et de 06:00 à 10:00 UTC en semaine, hors jours fériés chinois. Les heures à demi-tarif et la remise sur le cache de DeepSeek ne s'appliquent qu'aux tokens : les frais de recherche sont donc identiques à toute heure de la journée.
Puis-je limiter la recherche web DeepSeek à des domaines précis ou à un pays ?
Pas via l'outil intégré. Il rejette les options allowed_domains, blocked_domains et user_location, vous ne pouvez donc pas restreindre les résultats à certains sites. Si vous avez besoin de listes de sources autorisées ou bloquées, ou d'un ciblage géographique, gardez cette récupération dans votre propre pipeline.
Puis-je utiliser la recherche web DeepSeek avec mes propres outils de fonctions ?
Peut-être, mais testez d'abord. Lors des tests de MxChat, un bot utilisant déjà des outils de fonctions, par exemple pour consulter des commandes ou remplir des formulaires, ne pouvait pas ajouter la recherche web DeepSeek avec la réflexion désactivée : la combinaison ne fonctionnait donc qu'en mode réflexion. Nous vous conseillons de le vérifier sur votre propre compte. En mode réflexion, la recherche à réflexion approfondie peut effectuer jusqu'à environ 20 appels d'outils avant de répondre : attendez-vous donc à une latence et à un coût plus variables.
Quelles tailles de fichiers l'API Files de DeepSeek accepte-t-elle, et comment l'OCR est-il facturé ?
Les images peuvent atteindre 64 MiB, les documents tels que PDF, Word et PowerPoint 100 MiB, et le texte brut, les tableurs et les livres numériques 32 MiB. L'OCR est facturé au nombre de pages reconnues avec succès ; les reconnaissances échouées ou expirées ne sont pas facturées. Consultez la page des tarifs pour connaître les frais actuels avant d'établir votre budget.
Dois-je remplacer mon pipeline RAG par les outils intégrés de DeepSeek ?
Généralement pas entièrement. Les outils intégrés conviennent aux questions sur le web public récent, à la recherche multilingue et aux questions-réponses ponctuelles sur des fichiers. Votre propre RAG reste mieux adapté aux corpus privés, au contrôle des domaines, aux pistes d'audit et aux exigences de résidence des données. Menez un pilote de routage par type de question sur de vraies questions, sans modifier votre prompt de production. Dans le test de MxChat, un prompt restrictif a largement bloqué la recherche, et avec la réflexion désactivée, 30% des réponses avec recherche ont été facturées sans être utiles. Routez par type de question au lieu de basculer l'ensemble du produit.
Sources
- https://api-docs.deepseek.com/news/news261113/
- https://api-docs.deepseek.com/quick_start/pricing/
- https://api-docs.deepseek.com/guides/web_tools/
- https://api-docs.deepseek.com/guides/build_a_chatbot/
- https://api-docs.deepseek.com/guides/files_api/
- https://api-docs.deepseek.com/guides/ocr/
- https://api-docs.deepseek.com/updates/
- https://github.com/deepseek-ai/chat-demo
- https://cdn.deepseek.com/policies/en-US/deepseek-privacy-policy-2025-02-14.html
- https://mxchat.ai/deepseek-web-search-api-pricing-chatbot-test/
- https://www.datastudios.org/post/deepseek-api-web-search-ocr-voice-0-75-per-1000-searches
- https://tproger.ru/news/deepseek-otkryla-v-api-poisk-chtenie-fajlov-i-golos-iz-svoego-pr



