DeepSeek V4 1M : max_tokens, facturation et concurrence

La fenêtre de contexte 1M de DeepSeek V4 est un budget partagé entre l'entrée et la sortie. Cela ne signifie pas que vous pouvez envoyer 1M tokens en entrée et générer ensuite 384K supplémentaires. La figure de 384K est le maximum de sortie, tandis que max_tokens est le plafond de sortie que vous fixez pour une requête. La sortie réelle est également limitée par l'espace restant dans la fenêtre 1M^[1][2].

Ce guide répond aux questions pratiques derrière cette spécification : comment budgétiser l'entrée et la sortie, comment fixer max_tokens, ce que les tokens de raisonnement font de l'utilisation, comment fonctionne la facturation du cache, et pourquoi Flash et Pro ont des limites de concurrence différentes.

Limites de DeepSeek V4 en un coup d'œil

DeepSeek a publié l'aperçu V4 le 24 avril 2026 avec les variantes Flash et Pro et une fenêtre de contexte 1M^[3]. La page de tarification officielle liste le même plafond de sortie 384K pour les deux modèles, ainsi que la sortie JSON, les appels d'outils, la complément préfixée et la complément FIM^[1].

1M signifie-t-il uniquement l'entrée ?

Non. La référence Chat Completions de DeepSeek indique que la longueur totale des tokens d'entrée et des tokens générés est limitée par la longueur du contexte du modèle^[2].

Utilisez ce modèle mental :

tokens d'entrée + tokens générés <= contexte 1M
tokens générés <= max_tokens
tokens générés <= limite de sortie du modèle 384K

Si l'invite remplit presque la fenêtre de contexte, le modèle ne peut pas aussi retourner une réponse 384K. Réservez de l'espace pour les instructions système, les schémas d'outils, l'historique de conversation et la complément.

Une grande fenêtre ne supprime pas non plus la valeur de la récupération et de la segmentation. L'envoi de moins de contexte, mieux organisé, améliore souvent la latence, le coût et la pertinence des réponses.

Comment fixer max_tokens

max_tokens est la longueur de complément maximale pour une requête. Un finish_reason de length peut signifier que la requête a atteint ce plafond ou épuisé le contexte disponible^[2].

Points de départ raisonnables :

Ce sont des points de départ d'ingénierie, pas des exigences officielles. Mesurez finish_reason, les tokens de complément réels, la latence et le taux de sortie utile avant d'augmenter le plafond.

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_REAPI_KEY",
    base_url="https://api.reapi.ai/v1",
)

response = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[
        {
            "role": "user",
            "content": "Review this repository inventory and produce a risk-ranked migration plan.",
        }
    ],
    max_tokens=16_384,
    reasoning_effort="high",
    extra_body={
        "thinking": {"type": "enabled"},
        "group": "default",
    },
)

Consultez la référence API DeepSeek V4 pour les champs de requête reAPI, et la page du modèle DeepSeek V4 pour le playground et les tarifs de passerelle en direct.

Tokens de raisonnement et utilisation de complément

Le mode raisonnement est activé par défaut. DeepSeek retourne le raisonnement dans reasoning_content, et l'objet d'utilisation peut le rapporter séparément comme completion_tokens_details.reasoning_tokens^[4][2].

Planifiez la capacité de complément autour du raisonnement ainsi que de la réponse finale visible. En mode raisonnement, temperature, top_p, presence_penalty et frequency_penalty sont acceptés pour la compatibilité mais n'entrent pas en vigueur^[4].

Pour l'extraction déterministe ou le travail à faible latence, testez Flash avec le raisonnement désactivé. Gardez le raisonnement activé pour la planification, la programmation et l'utilisation d'outils multi-étapes où le raisonnement supplémentaire est utile.

Comment fonctionne la facturation

DeepSeek Direct facture trois buckets de tokens :

1. entrée mise en cache;
2. entrée non mise en cache;
3. sortie.

Les tarifs USD officiels au 30 juillet 2026 étaient^[1] :

La formule générale est :

coût =
  entrée_mise_en_cache / 1M × tarif_mise_en_cache
  + entrée_non_mise_en_cache / 1M × tarif_non_mise_en_cache
  + sortie / 1M × tarif_sortie

Ce sont les tarifs directs de DeepSeek. reAPI est une passerelle distincte avec ses propres tarifs USD en direct, donc utilisez la carte de tarification sur la page reAPI DeepSeek V4 pour la facturation de passerelle.

Tirer parti du cache de contexte

Le cache disque de DeepSeek est activé automatiquement. Une requête ultérieure ne reçoit un cache hit que lorsqu'elle correspond complètement à une unité préfixe stockée; une formulation similaire ne suffit pas^[5].

Mettez le contenu stable en premier :

invite système stable
+ schémas d'outils stables
+ corpus de référentiel ou de document inchangé
+ la question qui change par requête

Utilisez les champs de réponse prompt_cache_hit_tokens et prompt_cache_miss_tokens pour calculer le taux de hit réel. N'estimez pas les économies à partir de la similarité d'invite seule.

Concurrence Flash et Pro

DeepSeek Direct publie des limites de concurrence au niveau du compte de 2 500 pour Flash et 500 pour Pro. Une requête occupe un créneau de concurrence jusqu'à ce que sa réponse se termine. La limite est par compte, pas par clé API, et les requêtes excédentaires reçoivent HTTP 429^[6].

Le user_id optionnel peut isoler le comportement de sécurité, de cache et de planification, mais les comptes ordinaires partagent toujours la concurrence de compte total entre tous les user_id. La création de clés ou d'user_id supplémentaires n'augmente pas la capacité.

Ces chiffres s'appliquent à DeepSeek Direct. La concurrence et la mise en file d'attente de passerelle peuvent différer; lors de l'utilisation de reAPI, respectez les limites et réponses publiées par reAPI.

Liste de contrôle de production pour les requêtes de contexte 1M

• Comptez les tokens au lieu de traiter les caractères comme des tokens.
• Réservez le contexte pour la sortie, les schémas d'outils et les tours de suivi.
• Fixez max_tokens à la tâche, pas automatiquement à 384K.
• Enregistrez finish_reason et distinguez la troncature des arrêts naturels.
• Gardez les préfixes réutilisables stables et suivez les tokens de hit du cache.
• Mesurez l'utilisation du raisonnement séparément de la longueur de réponse visible.
• Réessayez les réponses 429 avec backoff exponentiel et gigue.
• Routez le travail routinier à fort volume vers Flash et réservez Pro pour les tâches plus difficiles.
• Utilisez les identifiants de modèle V4 actuels; la date de dépréciation annoncée par DeepSeek pour deepseek-chat et deepseek-reasoner était le 24 juillet 2026^[3].

FAQ

DeepSeek V4 Flash prend-il en charge le contexte 1M ?

Oui. Flash et Pro ont tous deux une fenêtre de contexte 1M et un maximum de sortie 384K^[1].

Le contexte 1M est-il entièrement l'entrée ?

Non. L'entrée et la sortie générée partagent la limite de contexte du modèle^[2].

Puis-je fixer max_tokens à 384K ?

384K est le plafond de sortie du modèle, mais la requête doit aussi avoir suffisamment d'espace dans la fenêtre de contexte 1M. Le paramètre ne garantit pas une complément 384K.

Les tokens de raisonnement comptent-ils vers l'utilisation de complément ?

Les plans de capacité et de facturation doivent les inclure. DeepSeek rapporte les tokens de raisonnement dans les détails d'utilisation de complément^[2].

Les limites de concurrence sont-elles par clé API ?

Non. DeepSeek Direct limite la concurrence par compte : 2 500 pour Flash et 500 pour Pro^[6].

Dois-je activer la mise en cache du prompt ?

Non. Le cache disque de contexte est automatique. Gardez les préfixes partagés stables et inspectez les champs de cache hit dans usage^[5].

Lectures complémentaires

• Modèle DeepSeek V4 et tarification en direct
• Référence API DeepSeek V4
• Parcourir les modèles de chat reAPI

Références

1. DeepSeek. Models & Pricing — V4 context, output, features, prices, and concurrency. Retrieved July 30, 2026 from api-docs.deepseek.com/quick_start/pricing
2. DeepSeek. Create Chat Completion — max_tokens, context limits, finish reasons, and usage. Retrieved July 30, 2026 from api-docs.deepseek.com/api/create-chat-completion
3. DeepSeek. DeepSeek-V4 preview release. April 24, 2026. api-docs.deepseek.com/news/news260424
4. DeepSeek. Thinking Mode — controls, reasoning effort, and reasoning content. Retrieved July 30, 2026 from api-docs.deepseek.com/guides/thinking_mode
5. DeepSeek. Context Caching — prefix matching and usage fields. Retrieved July 30, 2026 from api-docs.deepseek.com/guides/kv_cache
6. DeepSeek. Rate Limit & Isolation — account-level concurrency and user_id. Retrieved July 30, 2026 from api-docs.deepseek.com/quick_start/rate_limit