Mis à jour le
Clé API DeepSeek ne fonctionne pas : causes et solutions
Lorsqu'une erreur « clé API deepseek ne fonctionne pas » apparaît, la clé elle-même est moins souvent en cause que vous ne le pensez. La plupart des échecs proviennent de l'URL de base, d'un solde vide, d'un nom de modèle erroné ou d'un client qui envoie la clé au mauvais endroit.
Commencez par un test en une ligne
Avant de modifier quoi que ce soit dans votre application, mettez le client hors de cause. Un seul appel curl vous indique si la clé, l'URL et le nom du modèle fonctionnent ensemble. Remplacez les espaces réservés par les valeurs issues du tableau de bord et de la documentation de votre fournisseur.
curl -i https://YOUR-PROVIDER/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"YOUR-MODEL","messages":[{"role":"user","content":"ping"}]}'Le drapeau -i affiche la ligne de statut et les en-têtes, ce qui est plus important que le corps. Si curl fonctionne et votre application non, le problème vient des paramètres de l'application. Si curl échoue aussi, le problème vient de la clé, du compte ou de l'endpoint.
Lisez d'abord le code de statut
| Code | Signification habituelle | Points à vérifier |
|---|---|---|
| 401 | La clé a été rejetée | Erreurs copiées, espaces supplémentaires, clé révoquée ou supprimée, clé d'un autre fournisseur |
| 402 ou un message de solde | Plus de crédit disponible | Solde du compte et page de facturation |
| 404 | Mauvais chemin ou modèle | URL de base, /v1 en fin de chaîne, orthographe du nom du modèle |
| 429 | Trop de requêtes | Requêtes par minute, requêtes simultanées, en-têtes de nouvelle tentative |
| 5xx ou délai d'attente | Côté fournisseur ou réseau | Page de statut du fournisseur, réessayez plus tard, routage régional |
Ce sont les significations courantes pour les fournisseurs de style OpenAI. Chaque fournisseur documente ses propres codes exacts, alors consultez leur documentation actuelle pour les détails.
La clé elle-même
Les clés sont de longues chaînes et elles se cassent de manière ennuyeuse. Collez la clé dans un éditeur de texte brut et recherchez un espace en fin de chaîne ou un saut de ligne, une guillemet ouvrant en début de chaîne, ou un saut de ligne ajouté par une application de chat. Assurez-vous que l'en-tête indique Authorization: Bearer KEY avec un seul espace après Bearer. Si vous définissez la clé dans une variable d'environnement, affichez sa longueur dans votre application (et non sa valeur) pour confirmer qu'elle a été chargée.
Deux autres cas sont courants. Premièrement, vous avez créé une clé, fermé la page et copié une version masquée. La plupart des tableaux de bord n'affichent une clé qu'une seule fois, alors créez-en une nouvelle. Deuxièmement, vous utilisez une clé d'un service contre l'URL d'un autre service. Une clé n'est valide que pour le fournisseur qui l'a émise.
Solde, facturation et crédit gratuit
De nombreuses clés API ne fonctionnent que tant que le compte dispose de crédit. Un solde vide peut ressembler à une clé cassée. Ouvrez la page de facturation de votre fournisseur et confirmez que vous disposez de fonds, qu'un rechargement a bien été validé et qu'un crédit promotionnel n'a pas expiré. Les rechargements par crypto et par carte peuvent prendre quelques minutes pour apparaître.
Si vous voulez comparer comment un autre service prépayé gère cela, notre modèle est simple : vous achetez du crédit, les appels le réduisent à $0,15 par 1M de tokens d'entrée et $0,50 par 1M de tokens de sortie, les requêtes échouées ou refusées ne sont pas facturées, et le crédit n'expire jamais. Vous pouvez lire le solde avec GET /v1/balance ou depuis l'en-tête X-Balance-USD à chaque réponse.
URL de base et nom du modèle
La cause la plus fréquente dans des outils tels que SillyTavern, Janitor AI et les plugins d'éditeur est une URL de base tapée légèrement mal. Erreurs courantes : absence de /v1, un /v1/v1 doublé, l'utilisation de http au lieu de https, ou le collage du chemin complet /chat/completions dans un champ qui l'ajoute déjà. Le champ modèle est l'autre piège. Il doit correspondre à un ID de modèle listé par le fournisseur. Listez-les avec GET /v1/models si le fournisseur le supporte, ou lisez la documentation actuelle.
Les guides de configuration pour des outils spécifiques sont sur ce site : utilisation d'une clé dans SillyTavern, dans Janitor AI et dans VS Code.
Limites de débit et concurrence
Une rafale de requêtes simultanées peut déclencher une erreur 429 même avec une clé valide. Recherchez un en-tête Retry-After et reculez. Une tentative de réessai minimale en Python ressemble à ceci :
import time
from openai import OpenAI, RateLimitError
client = OpenAI(base_url="https://api.deepseekapikey.com/v1", api_key="YOUR_KEY")
def ask(prompt):
for attempt in range(4):
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": prompt}],
)
return r.choices[0].message.content
except RateLimitError:
time.sleep(5 * (attempt + 1))
raise RuntimeError("still rate limited")Sur notre endpoint, une clé complète permet 8 requêtes simultanées et 300 requêtes par minute. Une requête diffusée conserve son créneau jusqu'à la fin du flux. Le code d'erreur est rate_limited ou concurrency, et une surcharge temporaire renvoie 429 avec Retry-After: 5.
Problèmes réseau et régionaux
Si curl se bloque ou se réinitialise, le problème peut être entre vous et le fournisseur : un proxy d'entreprise, un VPN, le DNS ou un blocage régional. Essayez un autre réseau, vérifiez que votre proxy transmet les en-têtes Authorization, et augmentez le délai d'attente de votre client pour les générations longues. Les réponses streaming peuvent aussi être coupées par des proxies qui mettent en mémoire tampon ; testez avec stream: false pour séparer les deux problèmes.
Une liste de contrôle exécutable en cinq minutes
- Exécutez le test curl et notez le code de statut.
- Créez une clé fraîche et testez-la. Si la nouvelle clé fonctionne, l'ancienne a été copiée incorrectement ou révoquée.
- Vérifiez le solde et toute date d'expiration du crédit.
- Comparez l'URL de base et l'ID du modèle avec la documentation du fournisseur, caractère par caractère.
- Envoyez une requête sans streaming, sans outils et avec un prompt court. Ajoutez les fonctionnalités une par une.
- Vérifiez les appels simultanés. Si votre application déclenche plusieurs requêtes à la fois, réduisez la concurrence.
- Essayez un autre réseau ou désactivez le VPN.
- Consultez les en-têtes de réponse, y compris tout ID de requête. Une équipe de support peut retrouver votre appel grâce à cet ID.
L'étape cinq révèle un nombre surprenant de bugs. Des définitions d'outils légèrement invalides, une valeur très grande de max_tokens, ou un corps dépassant la limite de taille peuvent tous renvoyer des erreurs qui ressemblent à des problèmes de clé. Sur notre endpoint, la limite du corps est de 8 MB, et chaque réponse porte un en-tête X-Request-Id que vous pouvez citer pour le support.
Configurez un endpoint de secours
Les pannes et les limites surviennent avec n'importe quel fournisseur, donc conservez un second endpoint compatible OpenAI dans votre configuration. Le nôtre est un modèle à poids ouverts hébergé, ajusté pour répondre sans refus de contenu pour une utilisation adulte légale. Ce n'est pas l'API officielle de DeepSeek et ce n'est pas un routeur, donc attendez-vous à des réponses et un comportement différents. Le basculement nécessite deux paramètres : URL de base https://api.deepseekapikey.com/v1 et modèle uncensored.
curl https://api.deepseekapikey.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'Les nouveaux utilisateurs peuvent réclamer $0,50 de crédit d'essai en un clic sur la page clé API, valable 7 jours. Les recharges vont de $20 à $500 par crypto ; voir la page de tarification et la documentation pour les détails.
Plus de guides
Questions et réponses
Pourquoi ma clé fonctionne avec curl mais pas dans mon application ?
L'application a probablement une URL de base incorrecte, un nom de modèle erroné ou une copie périmée de la clé. Comparez ses paramètres avec votre appel curl fonctionnel caractère par caractère.
Une clé valide garantit-elle que les requêtes réussiront ?
Non. Un solde vide, une limite de débit ou un nom de modèle inconnu peuvent tous échouer avec une clé parfaitement valide.
Puis-je utiliser le même code avec un fournisseur différent ?
Si les deux sont compatibles OpenAI, oui. Modifiez l'URL de base, la clé et l'ID de modèle.
Votre endpoint est-il le même modèle que DeepSeek ?
Non. Il s'agit d'un modèle à poids ouverts géré par un fournisseur indépendant, et ce n'est l'API officielle d'aucun fournisseur.
Votre clé n'est qu'à un formulaire d'ici
Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.
