L'API DeepSeek est largement utilisée pour le service client, la rédaction, le code et l'analyse de données, en raison de son prix bas et de ses bonnes capacités en chinois. Cet article adopte le point de vue de ZSQH AI Gateway pour expliquer comment obtenir une clé, recharger, appeler avec le SDK OpenAI et gérer les limitations de débit.
Cet article prend l'interface compatible OpenAI comme exemple. L'interface officielle DeepSeek est également compatible avec le SDK OpenAI, mais la Base URL et les noms de modèles diffèrent : ne les mélangez pas.
1. À quoi sert l'API DeepSeek
Usages courants :
- questions-réponses en chinois, robots de service client ;
- résumé, traduction et réécriture de longs textes ;
- génération et explication de code ;
- analyse de données, extraction structurée ;
- nœuds de raisonnement dans les agents et workflows.
Les modèles DeepSeek courants incluent deepseek-chat et deepseek-reasoner. Les noms réellement disponibles, la longueur de contexte et les prix sont ceux de la page Tarifs des modèles.
2. S'inscrire et créer une clé
- Ouvrez ZSQH AI Gateway, inscrivez-vous et connectez-vous.
- Accédez à la page « Clés API » et cliquez sur nouveau.
- Nommez la clé
deepseek-testoudeepseek-prod. - Fixez un plafond de quota et une date d'expiration.
- Copiez la clé et conservez-la en lieu sûr.
Il est conseillé de séparer les clés de test et de production. La clé de production ne doit pas figurer dans le code frontend.
3. Recharger
Rechargez sur la page « Portefeuille ». Une fois le paiement crédité, la console affiche le solde.
Pour un premier usage, rechargez un petit montant et ajustez ensuite selon la consommation réelle. Les prix DeepSeek sont relativement bas, mais le contexte long et les traitements par lots peuvent épuiser rapidement le solde.
4. Base URL et noms de modèles
Adresse compatible OpenAI de ZSQH :
https://ai.zhongshangqihang.com/v1
Exemples de noms de modèles :
deepseek-chat
deepseek-reasoner
Remarques :
- Les noms de modèles sont ceux de la page de tarifs ; ne recopiez pas directement d'anciens noms trouvés dans la documentation officielle.
- Avec l'interface officielle DeepSeek, la Base URL est
https://api.deepseek.com; avec la passerelle, utilisez l'adresse ci-dessus. - Ne mélangez pas les deux Base URL, sous peine de 401/404.
5. Appel avec Python
pip install openai
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["DEEPSEEK_API_KEY"],
base_url="https://ai.zhongshangqihang.com/v1",
)
response = client.chat.completions.create(
model="deepseek-chat",
messages=[
{"role": "system", "content": "Tu es un assistant technique francophone."},
{"role": "user", "content": "Explique en trois phrases ce qu'est une base de données vectorielle"},
],
)
print(response.choices[0].message.content)
Si vous avez besoin du raisonnement, basculez sur deepseek-reasoner. Les modèles de raisonnement sont généralement plus lents et plus chers ; réservez-les aux problèmes difficiles, pas à toutes les requêtes.
6. Appel avec curl
export DEEPSEEK_API_KEY="sk-votre-clé"
curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
-H "Authorization: Bearer $DEEPSEEK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-chat",
"messages": [
{"role": "user", "content": "Écris un exemple Python de lecture d'un fichier CSV"}
]
}'
7. Limitation de débit et stabilité
DeepSeek peut limiter le débit ou ralentir aux heures de pointe. Recommandations :
- Timeouts et retries : n'attendez pas indéfiniment ; appliquez un backoff exponentiel aux 429/5xx.
- Maîtrise de la concurrence : ne saturez pas le service avec un lot massif.
- Modèle de secours : pour une activité critique, prévoyez un modèle ou un canal de secours.
- Surveillance du taux d'erreur : comptez 401/429/5xx par heure et changez de canal en cas d'anomalie.
- Découpage des longs textes : un contexte très long est lent et coûteux ; résumez ou segmentez d'abord.
8. Erreurs courantes
| Erreur | Cause | Traitement |
|---|---|---|
401 |
Clé erronée ou Bearer absent | Vérifier la clé et l'en-tête |
404 |
Base URL incorrecte | Utiliser l'adresse de passerelle terminée par /v1 |
model not found |
Nom de modèle incorrect | Copier depuis la page de tarifs |
429 |
Limitation de débit | Réduire la concurrence, réessayer, changer de canal |
insufficient quota |
Solde insuffisant | Recharger |
| Réponse très lente | Heure de pointe ou contexte long | Raccourcir le contexte, changer de modèle, réessayer |
9. DeepSeek officiel ou passerelle : comment choisir
| Critère | Connexion officielle | Passerelle ZSQH |
|---|---|---|
| Accès | Dépend de l'environnement réseau | Point d'entrée unifié, généralement plus stable |
| Paiement | Moyens acceptés par l'interface officielle | Recharge sur le site |
| Modèles | DeepSeek uniquement | Claude, GPT, Gemini, etc. en parallèle |
| Facturation | Console officielle | Console unifiée |
| Changement | Changer de fournisseur impose de modifier le code | Changer le nom du modèle suffit |
Si vous n'utilisez que DeepSeek, avec un volume stable et un accès officiel sans problème, la connexion directe convient. Si vous avez besoin de plusieurs modèles, d'une facturation unifiée ou d'un accès stable depuis la Chine, la passerelle est plus adaptée.
10. Recommandations de sécurité
- N'écrivez pas la clé dans le frontend ni dans un dépôt public.
- Créez des clés distinctes pour le test et la production.
- Fixez un plafond de quota pour éviter les appels anormaux.
- Consultez régulièrement les journaux d'usage et désactivez en cas d'anomalie.
- Supprimez l'ancienne clé en cas de départ ou de changement de machine.
Questions fréquentes
L'API DeepSeek est-elle gratuite ?
Il existe généralement un quota de bienvenue ou des promotions, mais l'usage durable nécessite une recharge. Les politiques officielles et celles du site font foi.
Une clé peut-elle appeler Claude ?
Dans ZSQH AI Gateway, une clé peut appeler plusieurs modèles ouverts, le modèle étant précisé dans les paramètres de la requête. Consultez la page de tarifs.
Pourquoi un même modèle est-il parfois rapide, parfois lent ?
Cela peut dépendre de la charge amont, de la longueur de contexte, de la concurrence et du réseau. En production, prévoyez timeouts, retries et modèle de secours.
Pour aller plus loin
Commencez par vous inscrire sur ZSQH AI Gateway, créez une clé de test deepseek, validez avec curl, puis intégrez votre application. Prix et noms de modèles sont ceux de la page Tarifs des modèles.
Articles liés :
