Guide de l'API DeepSeek V4 : modèles, clé et appels (2026)

DeepSeek V4 est la nouvelle génération de modèles de DeepSeek. Elle met l'accent sur le chinois, le code et le rapport qualité-prix. De nombreuses équipes l'utilisent pour le service client, la création de contenu, le développement logiciel et l'analyse de données.

Cet article explique comment obtenir une clé API DeepSeek V4, comment appeler le modèle et quels points surveiller lors d'une migration.

Remarque : DeepSeek est une marque de son détenteur. Les exemples ci-dessous correspondent aux versions courantes d'octobre 2026 ; les noms de modèles et les tarifs applicables figurent sur la page Tarifs des modèles.

1. À quoi sert DeepSeek V4

Questions-réponses en chinois, service client et base de connaissances.
Génération, explication et revue de code.
Synthèse de documents longs et extraction structurée.
Nœuds de raisonnement dans les agents et les workflows.
Traitement de contenu par lots.

Le modèle convient particulièrement aux charges de travail où le volume est élevé et où le coût par appel doit rester maîtrisé. Pour les tâches qui exigent une compréhension visuelle avancée ou des sorties très créatives, comparez avec d'autres modèles avant de généraliser.

2. Obtenir une clé

Plateforme DeepSeek

Créez un compte sur la plateforme ouverte DeepSeek, générez une clé et rechargez le solde. Cette voie convient aux équipes qui peuvent utiliser directement les services de l'éditeur et suivre sa facturation.

Passerelle ZSQH AI Gateway

Créez un compte sur ZSQH AI Gateway.
Créez une clé et fixez un quota.
Rechargez le solde.
Appelez l'API avec le SDK OpenAI.

L'intérêt d'une passerelle est de regrouper plusieurs fournisseurs derrière une seule clé et une seule facture, tout en conservant la possibilité de revenir à un accès direct si nécessaire.

3. URL de base et nom du modèle

L'adresse compatible OpenAI de la passerelle est :

https://ai.zhongshangqihang.com/v1

Les noms de modèles figurent sur la page de tarifs, par exemple deepseek-v4 ou deepseek-chat. Ne recopiez pas un nom de modèle d'une ancienne version sans vérifier qu'il est toujours disponible : cela produit fréquemment une erreur 404. L'URL de base s'arrête à /v1 ; le chemin complet de la requête est ajouté par le SDK.

4. Test en curl

export DEEPSEEK_API_KEY="sk-votre-cle"

curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4",
    "messages": [{"role": "user", "content": "Répondez seulement OK"}]
  }'

Si la réponse contient un identifiant de requête, conservez-le : il facilite le diagnostic auprès du fournisseur en cas d'erreur intermittente.

5. Appel en Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-votre-cle",
    base_url="https://ai.zhongshangqihang.com/v1",
)

resp = client.chat.completions.create(
    model="deepseek-v4",
    messages=[{"role": "user", "content": "Écrivez un exemple Python qui lit un fichier CSV"}],
)
print(resp.choices[0].message.content)

Comme pour tout fournisseur, gardez la clé côté serveur et prévoyez un délai d'attente adapté à la longueur des réponses attendues.

6. Migrer depuis une ancienne version

Confirmez d'abord le nouveau nom de modèle et la longueur de contexte.
Comparez la qualité des sorties sur un jeu de tests fixe.
Vérifiez la compatibilité des appels d'outils et des sorties JSON.
Déployez progressivement sur 3 à 7 jours avec un trafic réduit.
Conservez l'ancien modèle comme solution de repli.

N'effectuez pas un basculement complet en une seule fois. Une mise à niveau de modèle peut modifier le style des réponses, le respect des consignes et la prise en charge de certains paramètres. Un jeu de tests représentatif vaut mieux qu'une impression subjective sur quelques requêtes.

7. Coûts et limitation de débit

Le prix des tokens d'entrée et de sortie figure sur la page de tarifs.
Le contexte long amplifie le coût, surtout lorsque le même document est renvoyé à chaque tour.
Aux heures de pointe, des limitations de débit peuvent apparaître ; en production, prévoyez des nouvelles tentatives et un modèle de secours.
Pour les traitements par lots, privilégiez l'asynchronisme et la mise en file d'attente.

Surveillez également les nouvelles tentatives : une boucle de retry mal bornée peut doubler ou tripler la facture sans améliorer le taux de réussite.

Questions fréquentes

Quelle différence entre DeepSeek V4 et V3 ?

Les versions, la longueur de contexte, les capacités et les tarifs peuvent différer. La documentation de l'éditeur et la page de tarifs font référence.

Une clé peut-elle appeler Claude ?

Avec une passerelle, une clé peut appeler les différents modèles ouverts sur le compte. Une clé de la plateforme DeepSeek ne donne accès qu'aux modèles DeepSeek.

Pourquoi une erreur 404 ?

La cause la plus fréquente est un nom de modèle obsolète ou une URL de base incorrecte. Vérifiez d'abord le nom exact sur la page de tarifs, puis l'adresse utilisée par le SDK.

Pour aller plus loin

Si vous avez besoin d'un accès stable depuis la Chine ou d'une entrée unifiée pour plusieurs modèles, vous pouvez créer un compte ZSQH AI Gateway, tester à faible volume, puis migrer progressivement. Les modèles et les tarifs applicables figurent sur la page Tarifs des modèles.