Famille DeepSeek

Les modèles de la série V4 de DeepSeek, qui comprend V4.1 Flash, V4 Pro et V4 Flash. Ils s’appellent via l’API compatible OpenAI et prennent aussi en charge l’API native Anthropic, ce qui permet de les utiliser directement dans des outils comme Claude Code.

Tâches courantes

Modèles

La série V4 offre un contexte de 1M tokens et une sortie maximale de 384K tokens. V4.1 Flash accepte les images en entrée ; les autres modèles ne prennent en charge que le texte. La liste complète des modèles et les prix en vigueur figurent sur la page des modèles .

Alias et versions

• Les alias s’utilisent sans le préfixe deepseek/, par exemple "model": "deepseek-v4-pro" ; écrire deepseek/deepseek-v4-pro renvoie 404.
• Les modèles deepseek-chat et deepseek-reasoner de l’API officielle DeepSeek ne sont pas disponibles sur OfoxAI ; utilisez les ID de modèle du tableau ci-dessus.
• Les anciennes versions deepseek/deepseek-v4-pro-0423 et deepseek/deepseek-v4-flash-0423 restent utilisables, mais le thinking s’y active différemment ; voir Mode thinking.

Exemples d’appel

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.io/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="deepseek/deepseek-v4-flash-0731",
    messages=[{"role": "user", "content": "Explique en une phrase ce qu’est l’idempotence."}],
    extra_body={"thinking": {"type": "disabled"}},
)
print(resp.choices[0].message.content)

curl https://api.ofox.io/v1/chat/completions \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek/deepseek-v4-flash-0731",
    "messages": [{"role": "user", "content": "Explique en une phrase ce qu’est l’idempotence."}],
    "thinking": {"type": "disabled"}
  }'

Mode thinking

Lors de nos tests sur un même problème de mathématiques, V4 Pro a produit par défaut environ 12 000 tokens de thinking en environ 2 minutes ; thinking désactivé, la réponse arrive en environ 20 secondes. Les tokens de thinking sont facturés au prix unitaire de sortie ; leur nombre figure dans usage.completion_tokens_details.reasoning_tokens.

Lire le contenu du thinking

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.io/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="deepseek/deepseek-v4-flash-0731",
    messages=[{"role": "user", "content": "Combien font 17 × 23 ?"}],
)
msg = resp.choices[0].message
details = getattr(msg, "reasoning_details", None) or []
print("[Thinking]", "".join(d.get("text", "") for d in details))
print("[Réponse]", msg.content)

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.io/v1", api_key=os.environ["OFOX_API_KEY"])
 
stream = client.chat.completions.create(
    model="deepseek/deepseek-v4-flash-0731",
    messages=[{"role": "user", "content": "Combien font 17 × 23 ?"}],
    stream=True,
)
for chunk in stream:
    if not chunk.choices:
        continue
    delta = chunk.choices[0].delta
    thinking = getattr(delta, "reasoning_content", None)
    if thinking:
        print(thinking, end="", flush=True)
    if delta.content:
        print(delta.content, end="", flush=True)

• Dans une réponse non streamée, le contenu du thinking se trouve dans message.reasoning_details ; concaténez le text de chaque élément dans l’ordre.
• Dans une réponse streamée, le contenu du thinking se trouve dans delta.reasoning_content, comme dans l’API officielle DeepSeek.
• Dans une conversation à plusieurs tours, inutile de renvoyer le contenu du thinking dans l’historique des messages.

Utiliser avec Claude Code

La série DeepSeek V4 prend en charge l’API native Anthropic, à l’adresse https://api.ofox.io/anthropic, et s’utilise dans Claude Code et les autres outils fondés sur le protocole Anthropic :

curl https://api.ofox.io/anthropic/v1/messages \
  -H "x-api-key: $OFOX_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek/deepseek-v4-flash-0731",
    "max_tokens": 4000,
    "thinking": {"type": "disabled"},
    "messages": [{"role": "user", "content": "Explique en une phrase ce qu’est l’idempotence."}]
  }'

• Via l’API Anthropic, le contenu du thinking est renvoyé dans des blocs thinking, et "thinking": {"type": "disabled"} désactive également le thinking.
• Lorsque le thinking est activé, réglez un max_tokens suffisamment grand. Si le quota est insuffisant, la réponse peut ne contenir qu’un bloc thinking, sans réponse.

Les étapes complètes de configuration de Claude Code sont décrites dans Configuration de Claude Code.

Sortie JSON et appel d’outils

response_format accepte {"type": "json_object"} et {"type": "json_schema", ...} ; l’appel d’outils utilise le paramètre standard tools :

import json
import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.io/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="deepseek/deepseek-v4-pro-0813",
    response_format={"type": "json_object"},
    messages=[{"role": "user", "content": "Renvoie price et currency en JSON : une batte et une balle coûtent 1,10 dollar au total, et la batte coûte 1 dollar de plus que la balle. Combien coûte la balle ?"}],
    extra_body={"thinking": {"type": "disabled"}},
)
print(json.loads(resp.choices[0].message.content))

Avec json_object, indiquez explicitement dans le prompt « Renvoie en JSON » ainsi que les champs attendus.

Mise en cache des prompts

DeepSeek met automatiquement en cache les préfixes de requête répétés, sans modifier la requête. Le volume concerné figure dans usage.prompt_tokens_details.cached_tokens, et cette partie est facturée au prix unitaire de lecture du cache. Le cache fonctionne au mieux : une requête au préfixe identique peut ne pas y accéder.

Fournisseurs

Pour sélectionner un fournisseur, voir Routage des fournisseurs.

Erreurs courantes

Les autres erreurs générales sont décrites dans Gestion des erreurs.

Documentation officielle

• Documentation de l’API DeepSeek 
• DeepSeek · Mode thinking 
• DeepSeek · Compatibilité avec l’API Anthropic 

La documentation officielle décrit le comportement en appel direct à DeepSeek. Via OfoxAI, les ID de modèle et les adresses d’endpoint de cette page font foi.

FAQ