Comment obtenir une clé API DeepSeek : guide étape par étape

Pour obtenir une clé API DeepSeek, connectez-vous à la plateforme officielle DeepSeek, ouvrez la page API Keys, créez une nouvelle clé, puis copiez-la dans un emplacement sécurisé. Vous pourrez ensuite l’utiliser côté serveur avec l’URL de base https://api.deepseek.com.

Dernière vérification : 10 juillet 2026 : les modèles actuellement documentés pour l’API officielle sont deepseek-v4-flash et deepseek-v4-pro. Les anciens identifiants deepseek-chat et deepseek-reasoner doivent être abandonnés avant leur retrait annoncé le 24 juillet 2026 à 15 h 59 UTC.

Les étapes pour créer une clé API DeepSeek

Voici le parcours complet :

Créer un compte ou se connecter à DeepSeek.
Accéder à la page officielle des clés API.
Générer une nouvelle clé et la copier immédiatement.
Vérifier le solde disponible ou recharger le compte.
Stocker la clé dans une variable d’environnement.
Effectuer un premier appel pour confirmer son fonctionnement.

Clé officielle, DeepSeek Chat ou modèle local : quelle différence ?

Avant de créer une clé, vérifiez que vous avez réellement besoin de l’API officielle.

Solution	Clé API DeepSeek nécessaire ?	Usage principal
DeepSeek Chat sur le Web	Non	Discuter manuellement avec le modèle
API officielle DeepSeek	Oui	Intégrer DeepSeek dans une application, un script ou un outil
Modèle exécuté localement	Non	Héberger un modèle sur votre propre machine ou serveur
Fournisseur tiers	Non, sauf indication contraire	Utiliser DeepSeek avec la clé et la facturation du fournisseur

Une clé créée par OpenRouter, un hébergeur cloud ou une autre plateforme n’est pas une clé officielle DeepSeek. Elle utilise généralement l’endpoint, les tarifs, les règles de confidentialité et les limites de ce fournisseur.

L’API officielle est administrée depuis platform.deepseek.com et interrogée via api.deepseek.com. DeepSeek indique également que son service de chat et son Open Platform utilisent le même compte utilisateur, même s’il s’agit de deux modes d’utilisation différents.

Comment obtenir une clé API DeepSeek officielle

1. Connectez-vous à la plateforme DeepSeek

Rendez-vous sur la plateforme API officielle de DeepSeek.

Connectez-vous avec votre compte existant ou suivez la procédure d’inscription proposée. Si vous utilisez déjà DeepSeek Chat, essayez d’abord de vous connecter avec le même compte : les conditions de l’Open Platform précisent que les deux services partagent le même compte.

Évitez les sites dont le nom de domaine ressemble à DeepSeek mais qui ne sont pas exploités par l’entreprise. Une page tierce peut vendre un accès aux mêmes modèles sans vous fournir une véritable clé DeepSeek.

2. Ouvrez la page « API Keys »

Une fois connecté, ouvrez directement la page :

Accéder aux clés API DeepSeek

La documentation technique officielle renvoie vers cette page pour créer les identifiants utilisés par l’authentification Bearer.

3. Créez une nouvelle clé

Utilisez la commande de création affichée sur la page. Si le formulaire propose de nommer la clé, choisissez un nom permettant d’identifier son usage, par exemple :

site-production ;
application-test ;
automatisation-n8n ;
développement-local.

Évitez les noms vagues comme test ou key1, surtout si vous prévoyez plusieurs intégrations.

Après la génération, copiez immédiatement le secret et placez-le dans un gestionnaire de mots de passe, un gestionnaire de secrets ou un coffre-fort prévu à cet effet. Ne comptez pas sur la possibilité de récupérer ultérieurement sa valeur complète.

4. Vérifiez le solde de votre compte

La possession d’une clé ne garantit pas que le compte dispose d’un solde suffisant pour effectuer des requêtes.

Consultez la section de facturation de la plateforme. Le solde total peut comprendre :

un solde rechargé par l’utilisateur ;
un éventuel solde accordé par DeepSeek ;
ou les deux.

L’API officielle expose également un endpoint /user/balance qui indique notamment si le solde est suffisant, ainsi que la part accordée et la part rechargée.

Lorsque le solde est insuffisant, l’API renvoie une erreur HTTP 402. La page de recharge DeepSeek permet actuellement d’ajouter des fonds. La FAQ officielle mentionne PayPal, les cartes bancaires, Alipay et WeChat Pay parmi les moyens proposés.

Une clé API DeepSeek est-elle gratuite ?

La création de la clé n’est pas présentée comme un abonnement payant. La facturation porte sur les jetons traités par les modèles lors de vos requêtes.

À la date du 10 juillet 2026, la documentation officielle mentionne l’existence possible d’un granted balance, c’est-à-dire un solde accordé, mais elle ne promet pas un quota gratuit fixe et universel pour chaque nouveau compte. Vérifiez donc votre propre page de facturation au lieu de vous fier à un ancien tutoriel annonçant un nombre précis de jetons gratuits.

Tarifs actuels des modèles DeepSeek

Les tarifs suivants sont exprimés pour un million de jetons :

Modèle	Entrée avec cache	Entrée sans cache	Sortie
`deepseek-v4-flash`	0,0028 $	0,14 $	0,28 $
`deepseek-v4-pro`	0,003625 $	0,435 $	0,87 $

deepseek-v4-flash convient généralement aux tests, aux automatisations et aux applications à fort volume. deepseek-v4-pro vise les tâches plus complexes pour lesquelles la qualité du raisonnement est prioritaire.

Les prix peuvent évoluer. Consultez toujours la page Models & Pricing avant d’établir un budget de production. DeepSeek facture les jetons d’entrée et de sortie, puis déduit les frais du solde accordé ou rechargé.

Comment stocker la clé sans l’exposer

Une clé API doit être traitée comme un mot de passe. Toute personne qui l’obtient peut potentiellement envoyer des requêtes facturées sur votre compte.

Utilisez une variable d’environnement

Pour un test local sous macOS, Linux ou WSL :

export DEEPSEEK_API_KEY="collez_votre_cle_ici"

Sous Windows PowerShell :

$env:DEEPSEEK_API_KEY = "collez_votre_cle_ici"

Votre programme pourra ensuite lire DEEPSEEK_API_KEY sans inscrire directement le secret dans le code.

Protégez également les fichiers `.env`

Un fichier .env peut être pratique en développement local, à condition de ne jamais le publier. Ajoutez-le au fichier .gitignore de votre projet :

.env
.env.local
.env.production

Vous pouvez fournir un fichier .env.example sans véritable secret :

DEEPSEEK_API_KEY=remplacez_par_votre_cle

N’utilisez pas la clé directement dans le navigateur

Ne placez pas une clé DeepSeek dans :

du JavaScript exécuté côté client ;
une application mobile sans serveur intermédiaire ;
le code source public d’un site ;
une extension distribuée avec le secret intégré ;
un dépôt GitHub ;
une capture d’écran ou un ticket d’assistance public.

Pour une application Web, le navigateur doit appeler votre propre backend. C’est ensuite le serveur qui contacte l’API DeepSeek avec la clé conservée dans un environnement sécurisé.

En production, privilégiez un gestionnaire de secrets fourni par votre hébergeur plutôt qu’une valeur enregistrée en clair sur le serveur.

Tester la clé API avec Python

L’API DeepSeek utilise un format compatible avec le SDK OpenAI. Il suffit de modifier l’URL de base, la clé et le nom du modèle. Elle propose également une interface compatible avec le format Anthropic.

1. Installez le SDK

python -m pip install --upgrade openai

2. Créez un fichier `test_deepseek.py`

import os

from openai import OpenAI


api_key = os.getenv("DEEPSEEK_API_KEY")

if not api_key:
    raise RuntimeError(
        "La variable d'environnement DEEPSEEK_API_KEY est absente."
    )

client = OpenAI(
    api_key=api_key,
    base_url="https://api.deepseek.com",
)

response = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[
        {
            "role": "user",
            "content": "Réponds uniquement par : clé valide",
        }
    ],
    max_tokens=20,
    stream=False,
    extra_body={
        "thinking": {
            "type": "disabled",
        }
    },
)

print(response.choices[0].message.content)
print(response.usage)

3. Exécutez le script

python test_deepseek.py

Si la requête réussit, le programme affiche le contenu de la réponse ainsi que les informations de consommation retournées par l’API.

L’exemple utilise :

https://api.deepseek.com comme URL de base ;
deepseek-v4-flash comme modèle ;
une clé lue depuis DEEPSEEK_API_KEY ;
le mode de raisonnement (thinking) désactivé pour un test simple ;
une sortie limitée à quelques jetons.

DeepSeek active actuellement le mode de raisonnement (thinking) par défaut. Le paramètre thinking.type accepte enabled ou disabled. Pour une première vérification, le désactiver réduit la complexité de la requête.

N’utilisez pas deepseek-chat ou deepseek-reasoner dans un nouveau projet. Ces anciens noms ne sont maintenus que temporairement et leur retrait est annoncé pour le 24 juillet 2026 à 15 h 59 UTC.

Quel modèle choisir pour un premier appel ?

`deepseek-v4-flash`

Choisissez deepseek-v4-flash pour :

vérifier rapidement une clé ;
créer un chatbot simple ;
résumer ou classer du texte ;
exécuter des automatisations fréquentes ;
limiter le coût par requête.

Il s’agit généralement du choix le plus adapté à un premier test.

`deepseek-v4-pro`

Choisissez deepseek-v4-pro pour :

les problèmes de programmation complexes ;
le raisonnement approfondi ;
les agents exécutant plusieurs étapes ;
les analyses où la qualité prime sur le coût.

Les deux modèles figurent actuellement dans l’endpoint officiel /models. Ils prennent en charge les modes avec et sans raisonnement (thinking), avec une longueur de contexte annoncée d’un million de jetons.

Résoudre les erreurs les plus courantes

Code	Signification	Vérifications à effectuer
`400`	Format de requête incorrect	Vérifiez le JSON, les messages et les paramètres envoyés
`401`	Échec de l’authentification	Vérifiez la clé, la variable d’environnement et l’en-tête Bearer
`402`	Solde insuffisant	Consultez le solde et rechargez le compte si nécessaire
`422`	Paramètre invalide	Vérifiez le nom du modèle et les valeurs des paramètres
`429`	Limite de requêtes atteinte	Réduisez la cadence ou le nombre de requêtes simultanées
`500`	Erreur interne du serveur	Réessayez après un court délai
`503`	Serveur surchargé	Attendez puis relancez la requête

Ces codes et leurs causes sont documentés sur la page officielle Error Codes.

Erreur 401 : Authentication Fails

Contrôlez les points suivants :

DEEPSEEK_API_KEY existe bien dans le terminal qui lance le programme.
La clé ne contient ni espace initial ni saut de ligne accidentel.
La clé n’a pas été supprimée ou remplacée.
Le client utilise https://api.deepseek.com.
L’authentification est envoyée sous la forme Authorization: Bearer VOTRE_CLE.

Si la clé a été exposée publiquement, ne continuez pas à l’utiliser. Désactivez-la ou supprimez-la depuis la page API Keys, puis créez-en une nouvelle.

Erreur 402 : Insufficient Balance

Cette erreur indique que le solde utilisable ne permet plus de traiter la requête.

Vérifiez :

le compte actuellement connecté ;
le solde accordé encore disponible ;
le solde rechargé ;
l’éventuelle date d’expiration d’un solde promotionnel.

La FAQ précise que le solde rechargé n’expire pas, tandis que la date d’expiration d’un solde accordé peut être consultée dans la facturation.

Erreur 429 : Rate Limit Reached

Réduisez le nombre de requêtes simultanées et ajoutez des tentatives espacées dans votre application.

Les limites publiées sont actuellement calculées au niveau du compte, indépendamment de la clé utilisée. DeepSeek indique une limite de concurrence de 2 500 pour deepseek-v4-flash et de 500 pour deepseek-v4-pro. Ces valeurs peuvent évoluer et ne doivent pas être confondues avec un nombre garanti de requêtes par minute.

Suivre la consommation associée à chaque clé

Créer une clé différente pour chaque projet facilite l’identification d’une fuite ou d’une hausse anormale de consommation.

La FAQ officielle décrit la procédure suivante pour consulter les dépenses par clé :

Ouvrir la page Usage.
Choisir le mois concerné.
Utiliser la fonction Export.
Télécharger et décompresser les fichiers CSV.
Consulter le fichier nommé amount, qui ventile l’utilisation par clé.

Vous pouvez ainsi distinguer la consommation du site en production, des tests locaux et des outils d’automatisation.

Mettez également en place vos propres protections :

plafond budgétaire interne ;
surveillance des erreurs et des volumes ;
limitation du nombre de requêtes par utilisateur ;
rotation périodique des secrets ;
suppression immédiate d’une clé compromise ;
absence de clés ou de prompts sensibles dans les journaux.

Peut-on utiliser la clé dans n8n, un IDE ou un autre outil ?

L’API DeepSeek est compatible avec les formats OpenAI et Anthropic. Une intégration est donc généralement possible lorsque l’outil permet de personnaliser :

la clé API ;
l’URL de base ;
le nom du modèle ;
le format de l’API.

Pour le format OpenAI, utilisez :

Base URL : https://api.deepseek.com
Modèle : deepseek-v4-flash ou deepseek-v4-pro

Pour le format Anthropic, l’URL de base documentée est :

https://api.deepseek.com/anthropic

La documentation officielle répertorie notamment des guides pour plusieurs assistants et outils d’agents. Elle précise toutefois que certaines intégrations sont fournies par des tiers et que leur sécurité ou leur fonctionnement ne sont pas garantis par DeepSeek.

Avant de coller votre clé dans un logiciel, vérifiez toujours :

où elle sera stockée ;
si elle est envoyée à un serveur tiers ;
si l’outil peut lire vos prompts ou votre code ;
s’il prend en charge les nouveaux noms de modèles ;
s’il permet réellement de définir une URL de base personnalisée.

Précautions concernant les données personnelles

Une clé correctement protégée ne résout pas à elle seule les questions de confidentialité liées aux données envoyées au modèle.

La politique de confidentialité de DeepSeek indique notamment que :

les entrées, fichiers, prompts et autres contenus transmis peuvent être collectés ;
les données peuvent être utilisées pour fournir, développer et améliorer les services et les modèles ;
les services ne sont pas conçus pour recevoir certaines catégories de données personnelles sensibles ;
les données personnelles peuvent être directement collectées, traitées et stockées en République populaire de Chine.

DeepSeek précise également que le développeur d’une application utilisant l’Open Platform reste responsable de l’information fournie à ses propres utilisateurs concernant le traitement de leurs données.

Avant une utilisation professionnelle :

ne transmettez pas de mots de passe, de clés privées ou de secrets commerciaux ;
anonymisez les données lorsque cela est possible ;
définissez une politique de conservation ;
informez clairement les utilisateurs ;
réalisez votre propre évaluation juridique et de conformité, notamment pour les données personnelles ou réglementées.

Consultez la politique de confidentialité officielle et les conditions de l’Open Platform avant un déploiement en production.