Clé API DeepSeek : quoi coller où, et un premier appel

Une clé API DeepSeek est une chaîne secrète qui indique à l'API qui envoie la requête. Un outil n'a jamais besoin de la clé seule, cependant : il lui faut trois valeurs ensemble — la clé, l'URL de base et l'identifiant du modèle. Configurez ces trois valeurs et le premier appel fonctionne.

Vous avez probablement cherché ceci parce qu'un formulaire vous demande « votre clé API DeepSeek » : un script, un plugin d'éditeur, un nœud n8n. Très bien. Voyons ce que chaque champ attend, puis envoyons une vraie requête.

Qu'est-ce qu'une clé API, au fond ?#

Pensez à une carte-clé d'hôtel. Elle ne dit pas qui vous êtes en mots ; elle ouvre simplement votre porte et la réception facture votre chambre. Une clé API fait le même travail : le serveur la voit dans la requête, sait quel compte débiter et laisse passer l'appel. Perdez la carte et n'importe qui peut entrer et facturer votre chambre — c'est pourquoi la clé reste hors du code et hors des discussions. (L'histoire complète est dans What is an API key and how to store it safely.)

La documentation API de DeepSeek elle-même (vérifiée le 4 novembre 2026) montre la même habitude : la clé va dans une variable d'environnement, DEEPSEEK_API_KEY, avant d'exécuter un exemple, et l'API suit le format OpenAI — le SDK OpenAI fonctionne une fois que vous changez api_key et base_url. C'est toute l'astuce, et c'est pourquoi une clé ne voyage jamais seule.

Un détail qui piège les gens : une clé appartient au service qui l'a émise. Une clé CheapTokens va avec l'adresse CheapTokens, et l'identifiant du modèle est celui que CheapTokens liste. Mélangez une clé d'un endroit avec l'adresse d'un autre et vous obtenez une erreur d'autorisation, pas une réponse.

Placez la clé dans une variable d'environnement#

Créez une clé dans votre compte CheapTokens (les étapes sont dans la docs) et gardez le solde approvisionné pour que la requête ait de quoi puiser. Ensuite, stockez la clé dans une variable au lieu de la coller dans un fichier.

macOS ou Linux :

export CHEAPTOKENS_API_KEY='paste-your-key-here'

Windows PowerShell (fenêtre courante uniquement) :

$env:CHEAPTOKENS_API_KEY = 'paste-your-key-here'

La partie paste-your-key-here est un espace réservé ; mettez votre vraie clé là dans votre propre terminal et nulle part ailleurs. Pourquoi cela vaut mieux qu'une clé codée en dur, et que faire si une clé fuit, c'est dans Store an API key safely: env variable, .gitignore, leak fix.

La première requête#

Disons que vous voulez juste voir ça fonctionner : demandez au modèle d'expliquer une clé API en une phrase. Même requête, deux façons — choisissez l'onglet que vous utilisez.

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [{"role": "user", "content": "Explain an API key in one sentence."}],
    "max_tokens": 200
  }'

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ['CHEAPTOKENS_API_KEY'],
    base_url='https://api.cheaptokens.dev/v1',
)

resp = client.chat.completions.create(
    model='deepseek-ai/DeepSeek-V4-Flash-0731',
    messages=[{'role': 'user', 'content': 'Explain an API key in one sentence.'}],
    max_tokens=200,
)

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

La version Python nécessite pip install openai une fois. Regardez ce qui a changé par rapport à un script écrit pour le SDK OpenAI : api_key, base_url et model — les mêmes trois valeurs. Tout le reste reste tel quel.

Ce que vous devriez voir#

La réponse est du JSON. Le texte de la réponse se trouve dans choices[0].message.content ; c'est ce que le script Python affiche en premier. Juste à côté se trouve un bloc usage avec prompt_tokens, completion_tokens et total_tokens — combien de tokens sont entrés, combien sont sortis, et la somme. Un coût est calculé à partir de ces deux nombres, c'est pourquoi ils valent un coup d'œil même lors d'un premier appel (Input vs output tokens explique la répartition).

Pour avoir une idée de l'échelle : un appel comme celui-ci est minuscule. Prenez 30 tokens en entrée et 200 en sortie — le plafond max_tokens de l'exemple, donc l'appel le plus coûteux que cette requête peut faire. Il coûte $0.00002. Mille d'entre eux ressemblent à ceci, avec OpenRouter à côté pour référence :

Le modèle derrière cet identifiant est DeepSeek-V4-Flash : une fenêtre de contexte de 380K tokens et jusqu'à 32 768 tokens dans une seule réponse. Le prix est le même à toute heure, sans surcoût aux heures de pointe, et un seul solde couvre tous les modèles. Au total — entrée et sortie ensemble — il revient moins cher qu'OpenRouter, ce que le tableau ci-dessus montre exactement. Plus sur le modèle : DeepSeek on CheapTokens, prix actuels sur la pricing page.

Quand ça ne fonctionne pas#

Presque tous les échecs de premier appel sont dus à l'une des trois valeurs incorrecte. Associez le symptôme au coupable :

Le parcours complet de ces erreurs est dans API 401 or 404 error: wrong key, base URL or model id. Et si vous n'êtes pas sûr de l'identifiant à utiliser, demandez à l'API elle-même : List models with GET /v1/models.

Où vont ensuite ces mêmes trois valeurs#

L'intérêt de les apprendre une fois, c'est qu'elles sont portables. Presque tout outil qui parle à une API compatible OpenAI demande ces mêmes valeurs sous une forme ou une autre : la clé, l'adresse et le modèle. Dans un script (LangChain, LiteLLM), ce sont des arguments ; dans une application ou un nœud no-code, ce sont des champs ou des réglages. Vous pouvez aussi les essayer sans écrire de code dans Postman. Pour le streaming et les réponses longues avec ce modèle, poursuivez avec le DeepSeek-V4-Flash quickstart.