cursorapikey.com/Guide
Clés API Cursor ne fonctionnent pas : correctifs pour les endpoints personnalisés
Lorsque les clés API Cursor ne fonctionnent pas, la cause est presque toujours l'une des quatre choses suivantes : l'URL de base, le nom du modèle, la clé elle-même, ou une limite sur le compte. Une seule commande curl vous indique laquelle.
Mis à jour le


Points clés
- Testez d'abord la clé avec curl en dehors de Cursor ; si curl fonctionne, le problème vient des paramètres de Cursor.
- L'URL de base doit être https://api.cursorapikey.com/v1 et le nom du modèle doit être exactement uncensored.
- 401 signifie une clé incorrecte, 404 une URL incorrecte, 429 une limite de débit ou de requêtes simultanées, et une erreur de modèle un nom incorrect.
- Les libellés du menu changent entre les versions de Cursor, alors associez à l'objectif du champ plutôt qu'au libellé exact.
Étape 1 : tester la clé en dehors de Cursor
Excluez Cursor de l'équation. Si une requête simple fonctionne, votre clé et votre compte sont corrects et le problème vient des paramètres de l'éditeur. Si elle échoue, le corps de l'erreur nomme le problème.
curl -i https://api.cursorapikey.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}]}'
Le drapeau -i affiche la ligne de statut et les en-têtes. Un statut 200 avec un tableau choices indique un succès. L'en-tête X-Balance-USD indique votre crédit restant, ce qu'il faut vérifier en premier en cas d'erreur d'autorisation ou de paiement.
Vous pouvez aussi lister les modèles, ce qui confirme la clé sans rien dépenser :
curl https://api.cursorapikey.com/v1/models -H "Authorization: Bearer YOUR_KEY" | grep uncensored
La réponse doit contenir l'ID du modèle uncensored.
Étape 2 : définir les champs dans Cursor
Ouvrez les paramètres de Cursor et trouvez la section Modèles. Vous avez besoin de trois valeurs, et une erreur dans l'une d'elles produit un échec qui ressemble à une clé cassée.
- Clé API OpenAI : collez votre clé sans espaces ni sauts de ligne aux extrémités.
- Remplacer l'URL de base OpenAI : activez le remplacement et saisissez
https://api.cursorapikey.com/v1. Conservez le/v1et supprimez le/chat/completions. - Modèle personnalisé : ajoutez un modèle nommé
uncensoredet activez-le. Désactivez les modèles que vous n'utilisez pas pour que Cursor ne sélectionne pas un modèle que l'endpoint ne connaît pas.
Après avoir enregistré, utilisez l'option de vérification si votre version en dispose, puis sélectionnez uncensored dans la liste déroulante du modèle de chat. Un onglet de chat neuf est un bon test, car un ancien onglet peut conserver le modèle avec lequel il a démarré. Le guide étape par étape dans comment utiliser l'API Cursor montre la même configuration avec plus de contexte.
Associez l'erreur à la solution
| Ce que vous voyez | Cause probable | Correction |
|---|---|---|
| 401, "clé invalide", "non autorisé" | Clé mal tapée, tronquée ou révoquée | Copiez-la à nouveau depuis la page de clé ; vérifiez les espaces en fin de chaîne |
| 404, "introuvable" | URL incorrecte, absence de /v1, ou chemin doublé | Utilisez exactement https://api.cursorapikey.com/v1 |
| "modèle introuvable" ou similaire | Le nom du modèle diffère de uncensored | Ajoutez le modèle personnalisé avec ce nom exact, en minuscules |
429 avec rate_limited | Limite de requêtes par minute dépassée | Ralentissez ; les clés d'essai permettent 60 requêtes par minute, les clés complètes 300 |
429 avec concurrency | Trop de requêtes à la fois | Réduisez les exécutions d'agents en parallèle ; essai 2, clé complète 8 |
429 avec Retry-After: 5 | Surcharge temporaire | Attendez cinq secondes puis réessayez |
| Fonctionne dans curl, échoue dans Cursor | Paramètre non enregistré, modèle d'onglet incorrect, ou fonctionnalité n'utilisant pas les clés personnalisées | Voir la section suivante |
Les requêtes échouées ou refusées ne sont pas facturées, donc retenter pendant le débogage ne coûte rien.
Lorsque curl fonctionne mais que Cursor échoue toujours
C'est le cas le plus déroutant, et il a quelques explications habituelles.
Le mauvais modèle est sélectionné. Cursor conserve ses propres modèles intégrés dans la liste. Si l'un d'eux est sélectionné, la requête ne va pas du tout à votre endpoint. Sélectionnez explicitement uncensored dans la liste déroulante du chat ou de l'interface de composition que vous utilisez.
Toutes les fonctionnalités n'utilisent pas votre clé, mais certaines oui. Les fonctionnalités qui dépendent des modèles propres à Cursor, comme l'autocomplétion en ligne, peuvent continuer à les utiliser indépendamment de la clé que vous ajoutez. Les clés personnalisées s'appliquent là où vous pouvez choisir le modèle, c'est-à-dire les modes chat et édition. Consultez la documentation actuelle de Cursor, car cela change entre les versions.
Limites de requêtes simultanées depuis le mode agent. L'agent et les exécutions multi-étapes peuvent déclencher plusieurs requêtes simultanément. Une clé d'essai permet deux requêtes à la fois. Si des erreurs n'apparaissent qu'en mode agent, vous atteignez probablement la limite de concurrency, et une clé payante l'élève à huit. Une requête en streaming occupe sa place jusqu'à la fin du flux, donc les longs textes occupent les places plus longtemps.
Appels d'outils. L'API prend en charge les appels d'outils, avec tool_calls en streaming et les résultats renvoyés en tant que role: "tool". La qualité de l'utilisation des outils dépend du modèle, donc si une exécution d'agent bloque à une étape d'outil, essayez d'abord la même tâche en chat simple.
Vérifiez votre compte
Si curl renvoie une erreur de solde, la clé est valide mais le crédit est vide ou l'essai est terminé. L'essai est de $0,50, valable 7 jours, obtenu en un clic sur la page clé API après la connexion. Ensuite, vous devez recharger.
Les recharges sont des montants entiers de $20 à $500, avec +5 % à partir de $50, +10 % à partir de $100 et +15 % à partir de $200. Vous pouvez payer par crypto (USDT sur TRC20, USDC sur Base). La page de tarification affiche le tableau. Si vous n'avez pas encore de clé, obtenez-en une ici.
Gardez une clé par outil. Si vous avez collé une clé dans plusieurs éditeurs et scripts, les limites de débit sont partagées entre eux, ce qui peut ressembler à des échecs aléatoires.
Vérification par script pour un cas tenace
Si vous ne trouvez toujours pas la cause, exécutez un court script qui imite ce que fait l'éditeur. Il utilise le SDK OpenAI, sur lequel les clients de style Cursor sont modélisés, et il affiche l'objet d'erreur exact.
from openai import OpenAI, APIStatusError
client = OpenAI(base_url="https://api.cursorapikey.com/v1", api_key="YOUR_KEY")
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write a one-line Python hello world."}],
stream=True,
)
for chunk in r:
print(chunk.choices[0].delta.content or "", end="")
except APIStatusError as e:
print(e.status_code, e.response.headers.get("X-Request-Id"))
print(e.response.text)
Si le script effectue du streaming de texte, l'endpoint, la clé et le modèle sont corrects, et le problème restant est un paramètre de Cursor. Si un code de statut est affiché, consultez le tableau ci-dessus. Conservez la valeur X-Request-Id lorsque vous contactez le support, car elle identifie la requête exacte. Les détails complets des paramètres sont sur la documentation.
Empêchez que cela ne se reproduise
Quelques habitudes préviennent la plupart des problèmes récurrents. Stockez la clé dans une seule entrée de gestionnaire de mots de passe et copiez-la à partir de là, plutôt que depuis des journaux de chat ou des notes où des sauts de ligne se glissent. Notez les trois valeurs (URL de base, clé, nom du modèle) pour pouvoir les saisir à nouveau après une mise à jour de l'éditeur, car les mises à jour réinitialisent parfois les remplacements. Après chaque mise à jour, envoyez un court message de chat avant de commencer le travail réel.
Surveillez le solde. L'en-tête X-Balance-USD est renvoyé à chaque réponse, et vous pouvez aussi le lire depuis GET /v1/balance. Le crédit n'expire jamais, donc une recharge modeste placée sur le compte n'est pas gaspillée. Si vous utilisez la clé à la fois depuis des scripts et depuis l'éditeur, donnez aux tâches par lots longues une boucle de réessai qui attend cinq secondes en cas de 429 et s'arrête après quelques tentatives, afin qu'un script ne prive pas votre éditeur de ses places de concurrence.
Vérification des coûts et lecture suivante
Une requête de chat de codage avec 10 000 tokens de contexte de fichier et une réponse de 700 tokens coûte 10 000 / 1 000 000 x $0,15 = $0,0015 pour l'entrée et 700 / 1 000 000 x $0,50 = $0,00035 pour la sortie, soit environ $0,00185 au total. Les tarifs sont de $0,15 par 1M tokens d'entrée et $0,50 par 1M tokens de sortie. L'article sur la tarification de l'API Cursor couvre les estimations mensuelles.
Si la requête qui a échoué était volumineuse, rappelez-vous la fenêtre : le prompt et la complétion doivent tenir dans 100 000 tokens, et le corps de la requête est limité à 8 Mo. Joindre un dépôt entier à un chat peut dépasser ces limites. Réduisez le contexte aux fichiers pertinents et réessayez.
Plus de guides
Questions et réponses
Pourquoi Cursor indique-t-il que ma clé API est invalide ?
Habituellement, la clé contient un espace parasite ou a été copiée partiellement, ou l'URL de base pointe encore vers un autre service. Recopiez la clé, puis confirmez que l'URL de remplacement est https://api.cursorapikey.com/v1.
Quel nom de modèle dois-je saisir ?
Saisissez uncensored, en minuscules. C'est le seul ID de modèle que l'API propose.
L'autocomplétion utilise-t-elle ma clé ?
Pas nécessairement. Certaines fonctionnalités de Cursor utilisent les modèles propres à Cursor, et les clés personnalisées s'appliquent principalement aux modes de chat et d'édition où vous choisissez le modèle.
Les requêtes échouées sont-elles facturées ?
Non. Les requêtes échouées ou refusées ne sont pas facturées, donc réessayer pendant que vous déboguez ne coûte rien.
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.