Fenêtre gratuite de l'API DeepSeek Search : tarifs, Fetch API et date limite du 31 octobre

Réponse rapide : L'API DeepSeek Search est gratuite uniquement dans trois outils de codage, et seulement jusqu'au 31 octobre 2026 à 16h00 UTC. Les appels Search et Fetch que Claude Code, Codex ou DeepSeek Harness effectuent côté serveur ne coûtent rien jusque-là. Ensuite, et pour tout appel direct aux points de terminaison, vous payez 0,75 $ pour 1 000 requêtes réussies par point de terminaison. Les appels échoués, les résultats vides et les délais d'attente ne sont jamais facturés.

DeepSeek a ouvert ses API Search et Fetch à tous le 17 octobre 2026, en même temps que la sortie de DeepSeek-V4.1-Flash-1017. Elles fournissent à un agent des résultats web récents pour une requête et une copie Markdown propre de n'importe quelle page. Ce guide couvre ce qui est gratuit, ce que cela coûte après la fenêtre, les limites de débit, une première requête et le test des deux points de terminaison avec Apidog CLI.

Chaque fait ci-dessous provient du guide Search & Fetch de DeepSeek et de la page de tarification, consultés le 28 octobre 2026.

L'API DeepSeek Search est-elle gratuite ?

Oui, avec deux limites : d'où vous l'appelez et quand. La documentation de DeepSeek indique que les appels Search et Fetch côté serveur effectués via DeepSeek Harness, Claude Code ou Codex sont « actuellement gratuits ». La facturation à la requête pour ces appels commence à 00h00 le 1er novembre 2026 en UTC+8, soit le 31 octobre 2026 à 16h00 UTC.

Deux réserves empêchent qu'il s'agisse d'une véritable route à coût nul :

1. Vous avez toujours besoin d'une clé API DeepSeek approvisionnée. La fenêtre gratuite couvre les appels de recherche, pas le modèle. La page d'intégration Claude Code de DeepSeek indique que la synthèse des résultats de recherche utilise des requêtes LLM supplémentaires, et ces jetons sont facturés aux prix normaux du modèle.
2. La fenêtre ne couvre que les appels d'outils côté serveur. La documentation la limite à ces trois outils. Si votre propre code appelle les points de terminaison, vous payez dès la première requête réussie.

Si vous cherchez un modèle DeepSeek gratuit plutôt qu'une recherche gratuite, notre guide sur DeepSeek est-il gratuit liste toutes les routes, et clé API DeepSeek gratuite couvre la clé elle-même.

Ce que font les API DeepSeek Search et Fetch

L'API DeepSeek Search prend une requête et renvoie des résultats web structurés : titre, URL, extrait, un résumé plus long orienté modèle, un champ de contenu de page complète facultatif, un score de pertinence et un score d'autorité. L'API DeepSeek Fetch prend une URL et renvoie le titre de cette page ainsi que son contenu au format Markdown. Ensemble, elles offrent à un agent la recherche et la lecture en deux appels.

Un agent de recherche effectue généralement une recherche, puis récupère deux ou trois pages, et chacune constitue un appel facturable distinct après la fenêtre. Search prend en charge les opérateurs : site:, -site:, "phrase", -term, lang:en,ja, after: et before:.

Vous pouvez comparer cela à d'autres options dans notre récapitulatif des API de recherche web gratuites, de l'API de recherche web Claude et de l'API Perplexity Search.

Tarification de l'API DeepSeek Search après la fenêtre gratuite

Une fois la fenêtre fermée, les deux points de terminaison facturent de la même manière :

Les frais sont déduits de votre solde DeepSeek, et la page de tarification indique que le solde accordé est utilisé avant le solde rechargé lorsque vous disposez des deux.

Un calcul rapide pour un agent de recherche qui exécute 200 tâches par jour, chacune avec une recherche et trois appels Fetch :

• 200 recherches x 0,00075 $ = 0,15 $
• 600 appels Fetch x 0,00075 $ = 0,45 $
• Total : 0,60 $ par jour, environ 18 $ par mois, avant les jetons de modèle

Comme count ne change pas le prix, demandez jusqu'à 50 résultats en un seul appel plutôt que de paginer. Côté modèle, deepseek-flash coûte 0,15 $ par million de jetons d'entrée (échec de cache, heures creuses) et 0,60 $ par million de jetons de sortie, doublé aux heures de pointe ; voir tarification de DeepSeek V4.1 Flash.

Limites de débit de l'API DeepSeek Search

Certains articles tiers citent une limite de 5 QPS. Le guide de DeepSeek lui-même donne des chiffres différents, et ce sont ceux-là qu'il faut prendre en compte :

• Search : 100 requêtes par seconde
• Fetch : 25 requêtes par seconde, plus une limite par domaine dont la valeur n'est pas publiée

Les limites sont par compte, s'appliquent à toutes vos clés API et sont distinctes de la concurrence du modèle. Search et Fetch sont mesurés indépendamment, donc une rafale d'appels Fetch n'entame pas votre budget de recherche. Les dépassements renvoient HTTP 429.

Attention à la limite Fetch par domaine : un agent qui récupère 20 pages d'un même site de documentation peut l'atteindre bien en dessous de 25 QPS. Espacez les appels Fetch vers un même domaine et réessayez les 429 avec un backoff.

Points de terminaison et votre premier appel à l'API DeepSeek Search

Les deux points de terminaison utilisent POST, un jeton bearer et du JSON :

• Search : https://api.deepseek.com/v1/tools/search
• Fetch : https://api.deepseek.com/v1/tools/fetch

Champs de la requête Search

Une requête de recherche, tirée de la documentation :

curl https://api.deepseek.com/v1/tools/search \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "DeepSeek V4 release", "count": 5, "need_content": true}'

Chaque élément du tableau results contient title, url, snippet, summary, content, site_name, site_icon, date (RFC 3339 en UTC ou null), rerank_score et authority. Filtrez sur deux d'entre eux avant de lancer un appel Fetch :

• rerank_score va de 0 à 3. DeepSeek considère 1,5 ou plus comme de haute qualité.
• authority va de 0 à 4, avec -1 pour inconnu. 3 ou plus signifie une source hautement fiable.

Une requête Fetch prend un seul champ, url (HTTP ou HTTPS, jusqu'à 8 192 caractères, sans nom d'utilisateur ni mot de passe intégré) :

curl https://api.deepseek.com/v1/tools/fetch \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/article"}'

Elle renvoie title (qui peut être vide) et content au format Markdown.

Erreurs que vous rencontrerez

Le corps de l'erreur suit le format OpenAI : message, type, param (toujours null) et code.

Utiliser Search depuis Claude Code ou Codex vs l'appeler directement

La fenêtre gratuite ne s'applique que lorsqu'un outil de codage effectue l'appel pour vous, donc la configuration détermine la facture.

Claude Code. Pointez Claude Code vers le point de terminaison compatible Anthropic de DeepSeek et l'API de DeepSeek exécute l'outil Web Search côté serveur. Les variables principales de la page de DeepSeek :

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<your DeepSeek API key>
export ANTHROPIC_MODEL=deepseek-flash[1m]

Copiez le bloc complet, qui définit quelques variables de modèle supplémentaires, depuis la page de DeepSeek.

Codex. La recherche web intégrée de Codex ne fonctionne qu'avec deepseek-v4-pro, selon la page d'intégration Codex de DeepSeek. Le script d'installation désactive la recherche web par défaut, alors définissez ces deux lignes dans ~/.codex/config.toml et redémarrez :

model = "deepseek-v4-pro"
web_search = "live"

Le compromis : deepseek-v4-pro coûte plus cher par jeton que deepseek-flash.

Appels directs. Appelez vous-même les points de terminaison lorsque vous construisez votre propre agent ou souhaitez maîtriser count, need_content et les opérateurs. Vous payez dès le premier appel réussi. Si vous voulez seulement un agent qui effectue des recherches pendant qu'il code, utilisez Claude Code ou Codex pendant la fenêtre.

Laissez votre agent de codage tester l'API DeepSeek Search avec Apidog CLI

Avant d'intégrer Search et Fetch dans un produit, prouvez que l'authentification, la forme de la réponse et les erreurs se comportent comme documenté. Votre agent de codage peut créer et exécuter ces vérifications avec Apidog CLI, afin que les tests vivent dans un projet que votre équipe relance en CI.

Installez-le une fois :

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_APIDOG_TOKEN>
npx -y skills add https://apidog.com   # pick your agent when prompted

Ensuite, donnez à Claude Code, Codex ou l'agent que vous utilisez une seule invite :

In Apidog project <projectId>, add the DeepSeek endpoints POST /v1/tools/search
and POST /v1/tools/fetch with base URL https://api.deepseek.com and bearer auth
from the DEEPSEEK_API_KEY variable. Create test cases that assert: search returns
200 with a results array whose rerank_score values are between 0 and 3; fetch on
https://example.com returns 200 with non-empty content; a bad key returns 401.
Run them against the deepseek environment and summarize any failures.

L'agent lit le schéma de chaque charge utile, valide son JSON, puis écrit et exécute les tests :

apidog environment create deepseek --project <projectId> --base-url https://api.deepseek.com
apidog cli-schema get endpoint-create
apidog cli-schema validate endpoint-create --file search-endpoint.json
apidog endpoint create --project <projectId> --file search-endpoint.json
apidog cli-schema get test-case-create
apidog test-case create --project <projectId> --file search-case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> -r cli,json

Chaque exécution complète effectue deux appels facturables après la fenêtre (une recherche, un fetch), ce qui coûte 0,0015 $. La vérification 401 ne coûte rien car les requêtes échouées ne sont pas facturées. La même ligne apidog run ... -r junit s'intègre dans un pipeline, comme montré dans exécuter Apidog CLI en CI/CD. Si Claude Code est votre agent, Apidog CLI dans Claude Code détaille l'installation de la skill.

Le plan gratuit d'Apidog couvre jusqu'à 4 utilisateurs, donc une petite équipe peut partager le projet et son historique de tests.

FAQ

L'API DeepSeek Search est-elle gratuite après le 31 octobre ? Non. À partir de 16h00 UTC le 31 octobre 2026, les appels Search et Fetch via Claude Code, Codex et DeepSeek Harness coûtent 0,75 $ pour 1 000 requêtes réussies, comme les appels directs.

L'API DeepSeek Fetch est-elle gratuite ? Uniquement aux mêmes conditions que Search : gratuite lorsque Claude Code, Codex ou DeepSeek Harness l'appelle côté serveur avant l'échéance, puis 0,75 $ pour 1 000 requêtes réussies.

Ai-je besoin d'une clé API DeepSeek pour utiliser la recherche gratuite dans Claude Code ? Oui. Claude Code doit fonctionner avec une clé API DeepSeek via https://api.deepseek.com/anthropic, et les jetons de modèle dépensés pour synthétiser les résultats sont facturés normalement.

Quelle est la limite de débit de l'API DeepSeek Search ? Le guide de DeepSeek indique 100 QPS pour Search et 25 QPS pour Fetch par compte, plus une limite par domaine non publiée sur Fetch. Les dépasser renvoie HTTP 429.

Suis-je facturé lorsqu'une recherche ne renvoie rien ? Non. Les résultats vides, les requêtes échouées et les délais d'attente ne sont pas facturés. Search facture uniquement sur HTTP 200 avec un tableau results non vide.

Demander plus de résultats coûte-t-il plus cher ? Non. Le champ count (1 à 50) ne change pas le prix, donc une recherche à 50 résultats coûte le même prix qu'une recherche à 5 résultats.